(DI-1802) Collector for background job monitoring
- Veronika Hunorova (Unlicensed)
The collector for background job monitoring is named /DVD/MON_BTC_CL_COL_JOBS. The collector collects KPIs about background jobs.
The user defines the KPIs and sets KPI rules for jobs in the input table /DVD/MON_BTC_CFG.
If the user creates more jobname rules that apply only for one KPI in the input table, then all of these rules are executed. An exception are delayed and long running KPI rules, which apply to job runes that exceed the time limit specified by the user. If in this case two rules apply to the same job, then the rule with greater time limit has higher priority and is applied.
Example:
KPI_1 has the first rule for job names starting with Z* and time limit 60 minutes for a long run (The jobs must exceed the time limit 60 min.).
Same KPI_1 has also a second rule for job names starting with Z_LONG_PROC* and time limit 180 minutes for a long run. (The job name from the first rule is also applied here, but this rule has a greater time limit)
When a collector find jobs with the following jobnames:
- Z_JOB1 which was running 59 minutes - it will not be included (The first rule has a time limit 60 minutes, so this job is not included)
- Z_JOB2 which was running 60 minutes - it will be included
- Z_JOB3 which was running 179 minutes - it will be included
- Z_JOB4 which was running 180 minutes - it will be included
- Z_JOB5 which was running 181 minutes - it will be included
- Z_LONG_PROC_JOB6 which was running 59 minutes - it will not be included
- Z_LONG_PROC_JOB7 which was running 60 minutes - it will not be included
- Z_LONG_PROC_JOB8 which was running 179 minutes - it will not be included (The second rule has the greater time limit of 180 minutes, therefore it is applied instead of the first rule)
- Z_LONG_PROC_JOB9 which was running 180 minutes - it will be included
- Z_LONG_PROC_JOB10 which was running 181 minutes - it will be included
it collects these data into the KPI.
The user enters an extended KPI definition with following fields in the Input table /DVD/MON_BTC_CFG:
KPI name | Same technical name like in KPI definition |
System ID | System ID |
Background job name | Background job name |
Check type | Background job check type |
Time | Timelimit for delayed and long running BG jobs |
Add to details | Add relevant records to details |
Active | Active record |
Change by user | Last change by user [automatically filled] |
Change date | Last changed date [automatically filled] |
The collector provides also detailed overview of jobs in the detail table for the particular KPIs. The detail table is called "BG jobs in error, delay or long-run" (/DVD/MON_BTC_DET)
and contains the following fields:
| Timestamp |
| System ID |
| Background job name |
| Job ID |
| Message text |
| BG job status |
| BG Job delay time [s] |
| BG job long runtime [s] |
Three set up KPIs are included in the standard delivery:
KPI name | Description | Unit |
BTC_NUM_DELAYED | Number of delayed background jobs ( >= 60 seconds) | count |
| BTC_NUM_FAILED | Number of failed background jobs | count |
| BTC_NUM_LONGRUN | Number of background jobs running too long ( >= 10 minutes) | count |
NOTE: All standard background job KPIs contain the prefix BTC_NUM_*