Troubleshooting (Advanced): Thread Dump File Generation

Definition

This group includes all the system parameters concerning the generation of custom thread dumps in files.

Description

As of SP 1, this group includes all the system parameters related to the generation of thread dump files that are generated by the following triggers in a running instance of the SAP CC Core Server system:

  • A reached scheduling period
  • An exceeded threshold relating to CPU time
  • An exceeded threshold relating to the number of written output items
  • An exceeded threshold relating to the number of rating contexts that are used
  • An exceeded threshold relating to the execution time of SQL queries
  • A timeout of a given charging request
  • An unsupported exception which occurred

The thread dump files facilitate your technical operations by providing advanced supportablity tools. Your SAP Support Team may ask you to configure these settings. See the SAP CC Operations Guide.

Note

As of SP 1, the dump command of the SAP CC Admin+ user interface can trigger an on-demand thread dump file. See the primary help of Admin+.

Every trigger associated to a threshold can be configured using a dedicated system parameter, in order to fit specific needs. In addition to these configuration parameters, it is also possible to configure:

  • The directory that is used by each instance so store the dump files whose size are not limited which thus implies a systematic ZIP compression
  • The frequency of the dump files generation
  • The retention period for the generated dump files, that is used to determine which dump file must be removed from the storage location automatically

Every dump file contains information related to the execution context of a given thread, formatted using an XML representation. Depending on the trigger that is responsible for the creation of the dump file, this information may contain the following elements:

  • Number of logic calls, start time and duration of the current operation and associated result
  • Number of incoming requests and queue status
  • ID, source, read time, timeout status and internal status of each incoming request
  • SQL queries history (start time, duration and result set status)
  • SQL queries commit information (start time, duration)
  • List of memory-impacted subscriber accounts, including the following information:
    • ID of the subscriber account
    • Number of counters, contracts, mapping tables, range tables
    • Type of performed operation (creation, modification, or deletion)
    • List of charging sessions (ID and performed action)
  • List of memory-impacted charging contracts, including the following information:
    • ID of the charging contract
    • Type of the charging contract (root or linked)
    • Number of counters associated to this contract
    • Number of allowances associated to this contract
    • Type of performed operation (creation, modification, or deletion)
  • List of memory-impacted subscriber mapping and range tables, including the following information:
    • ID of the table
    • Type of performed operation (creation, modification, or deletion)
  • Additional information in case the memory impact is a modification:
    • Number of created, updated or deleted counters
    • Information about notifications (number of notifications with start time and duration)
    • Information about renew reservations notifications (number of received renew reservation notifications with receipt time and duration)
    • Information about spending statuses (number of sent spending statuses with sending start time and duration)
    • Information about the solicitation of the session database, if the Dual Database feature is enabled
    • Information about the used file writers (name, writing start time and duration, list of created items)

Setting Up or Viewing System Parameters

You can set up or view the following system parameters that are available for different instance types in the running SAP CC Core Server system.

Parameter Definition
THREAD_DUMP_ENABLED The enablement or disablement of the management of custom thread dump files
THREAD_DUMP_MINIMUM_INTERVAL The minimum time interval (in seconds) between two thread dumps
THREAD_DUMP_OUTPUT_PATH The storage location of the created files containing thread dump files
THREAD_DUMP_RETENTION_PERIOD The duration (in days) of the retention period for thread dumps
THREAD_DUMP_THRESHOLD_CPU_TIME The threshold (in ms) relating to CPU time above which a thread dump must be generated
THREAD_DUMP_THRESHOLD_OUTPUT_ITEMS The threshold relating to the number of output items generated by a thread above that a thread dump must be generated
THREAD_DUMP_THRESHOLD_RATING_CONTEXTS The threshold relating to the number of rating contexts used by a thread above that a thread dump must be generated
THREAD_DUMP_THRESHOLD_SQL_TIME The threshold (in ms) relating to the duration of an SQL query executed within a thread above which a thread dump must be generated
THREAD_DUMP_TRIGGER_PERIOD The period (in seconds) used by the scheduled trigger after which a thread dump must be generated

Notes

  • Use the set command of the SAP CC Admin+ user interface to change the parameter values. The immediate change may be not possible and a restart is necessary. Consult the details for each parameter.
  • Use the get command to retrieve the parameter values manually.
  • Use the SAP CC Config Tool user interface to set up a complete or partial list of system parameters (restart needed).