Collector for Dumps
The technical name of the Collector for Dumps is /DVD/MON_CL_COL_GET_DUMP.
This collector collects KPIs about occurred dumps on a system. The KPIs are specified via the KPI definition and the input table /DVD/MON_DUMP_I1.
The input table /DVD/MON_DUMP_I1 sets the extended KPI definition.
Default KPIs Delivered with This Collector
The following default KPIs are delivered with this collector:
| KPI name | Description | Unit | Detail table |
|---|---|---|---|
| DUMP_ALL_WITH_DETAILS | Number of new ABAP runtime errors (DUMPs) | Count | Yes |
| DUMP_AUTH_ERR | Number of runtime errors (DUMPs) on authorization failure | Count | Yes |
| DUMP_DBIF | Number of ABAP runtime errors (DUMPs) on SQL operations | Count | Yes |
| DUMP_NBR | Number of ABAP runtime errors (DUMPs) (server) | Count | Yes |
| DUMP_NBR_SUM | Number of ABAP runtime errors (DUMPs) (all servers) | Count | Yes |
| DUMP_RFC_ERR | Number of ABAP runtime errors (DUMPs) with RFC error | Count | Yes |
| DUMP_SYNTAX_ERR | Number of ABAP runtime errors (DUMPs) on syntax error | Count | Yes |
All standard dump KPIs have the prefix DUMP_*.
Input Table
You can specify which dumps are collected and under which KPI in the input table /DVD/MON_DUMP_I1. The input table contains the following fields:
| Column name | Technical name | Description |
|---|---|---|
| KPI name | KPI |
Same technical name as in the KPI definition |
| Rule number | RULE_ID | KPI rule number |
| Username | UNAME | Username |
| Termination ID | ERRID |
Termination ID of an ABAP short dump |
| ABAP Program | REPID |
ABAP program: Current main program of an expected dump |
| Exclude | EXCLUDE |
Excluding KPI rule |
| Distinct dump | DISTINCT_CNT |
Count only distinct dump findings |
| Active | ACTIVE |
Whether the KPI rule is active |
| Add to detail | ADD_TO_DETAIL |
Add relevant records to the detail table |
| Description | DESCRIPTION |
Description |
| Changed by user | CHANGED_BY |
Last changed by user [automatically filled] |
| Change date | CHANGED_AT |
Last change date [automatically filled] |
| Created by | CREATED_BY |
Created by user [automatically filled] |
| Created at | CREATED_AT |
Creation time [automatically filled] |
By default, the CrystalBridge Monitoring transport has predefined standard inputs.
Parameters
The following parameters are used for this collector:
| Parameter name | Description |
|---|---|
| COLLECT_FROM_ALL_CLIENTS | Specifies if dumps are collected from all clients. If this parameter has value 'X', dumps from all clients are collected. When disabled, dumps are only collected from default client (where CrystalBridge® Monitoring is running). |
| PREFERRED_LANGUAGE | Preferred language of texts extracted from dump into detail table. By default disabled, in which case collector tries to select language of the system (sy-langu) with fallback language English. (‘E' - English, 'D’ - German etc..) |
| PROPAGATE_VARIABLES |
Option to turn on variable propagation in long and short texts of dump. By default enabled. When disabled, it may improve performance due to not processing variables from table SNAP however long and short text would contain placeholders in texts. Example text:
|
Detail Table
The collector also provides detailed information about the occurred ABAP runtime errors in the detail table ABAP runtime errors. The technical name of this detail table is /DVD/MON_S_DUMP_DETAILS. It contains the following fields:
| Technical name | Description |
|---|---|
| SERVER |
Application server name |
| CLIENT_CODE |
Client |
| DUMPID |
Name of the runtime error |
| EVENT_TIMESTAMP |
Occurred at |
| DEVCLASS |
Package name of the program where the dump occurred |
| PROGRAM_NAME |
ABAP program name |
| INCLUDE_NAME |
Include name |
| SHORT_TEXT |
Dump short text |
| USER_NAME |
Username |
| KPI |
KPI name (tied to input table) |
| ERROR_ANL | Short dump error analysis |
| WHERE_TERM | Information in which program/class/method dump occurred |
| HOW_CORRECT | Description on how to correct dump |
