— Guide for Enterprise Transaction Systems —
KPI Definitions for Application Monitoring
This document describes the dimensions, KPIs and
built-in rules monitored by the Application Monitoring Data Collector. It
covers the following topics:
CICS ECI Application
The event map AppMonCICS monitors the successful CICS ECI requests.
Failed CICS ECI requests are monitored in the event map AppMonCICSErr.
Dimensions
| Administration Name |
Displayed Value |
| ApplicationMonitoring |
The identifier "Application
Monitoring".
|
| AppMonScenario |
The scenario identifier "CICS
ECI".
|
| ApplicationName |
"host-name:port-number"
of the CICS ECI installation.
|
KPIs of Event Map AppMonCICS
| Administration Name |
KPI Name |
Unit |
Type |
Description |
| AppMonCICSClientHost |
|
|
generic |
The client host name. |
| AppMonCICSClientUser |
|
|
generic |
The client user ID. |
| AppMonCICSLengthReply |
Length - Reply |
bytes |
average |
The length of the CICS reply. |
| AppMonCICSLengthRequest |
Length - Request |
bytes |
average |
The length of the CICS request. |
| AppMonCICSLengthTotal |
Length - Total |
bytes |
average |
The total length of the CICS call (request plus
reply).
|
| AppMonCICSRequestsSuccessful |
Requests Successful |
count |
sum |
The number of successful CICS ECI
requests.
|
| AppMonCICSService |
|
|
generic |
The name of the Integration Server adapter
service which calls CICS ECI.
|
| AppMonCICSTimeAdapter |
Time - Adapter |
ms |
average |
The time spent in the EntireX adapter. |
| AppMonCICSTimeCICS |
Time - CICS |
ms |
average |
The sum of the transport time to CICS ECI and
the time spent in the CICS user program.
|
| AppMonCICSTimeResponse |
Time - Response |
ms |
average |
The complete response time of the CICS ECI
request.
|
| AppMonCICSTransaction |
|
|
generic |
The CICS transaction name. |
Average values are calculated in relation to the number of successful
CICS ECI requests in the measuring interval.
Built-In Rules
| Administration Name |
Expression |
Severity |
Description |
| Application Monitoring CICS ECI High Response
Time
|
ApplicationMonitoring.AppMonCICSTimeResponse
> 10000
|
3 - Medium |
A successful CICS ECI request had a response
time greater than 10 seconds.
|
CICS ECI Error
The event map AppMonCICSErr monitors the failed CICS Connect requests.
Successful CICS Connect requests are monitored in the event map AppMonCICS.
Dimensions
| Administration Name |
Displayed Value |
| ApplicationMonitoring |
The identifier "Application
Monitoring".
|
| AppMonScenario |
The scenario identifier "CICS
ECI".
|
| ApplicationName |
"host-name:port-number"
of the CICS ECI installation, followed by the string
"Error".
|
KPIs of Event Map AppMonCICSErr
| Administration Name |
KPI Name |
Unit |
Type |
Description |
| AppMonCICSErrClientHost |
|
|
generic |
The client host name. |
| AppMonCICSErrClientUser |
|
|
generic |
The client user ID. |
| AppMonCICSErrErrorCode |
|
|
generic |
The 8 digit error code (error class and
number).
|
| AppMonCICSErrErrorMessage |
|
|
generic |
The error message. |
| AppMonCICSErrRequestsFailed |
Requests Failed |
count |
sum |
The number of failed CICS ECI requests. |
| AppMonCICSErrService |
|
|
generic |
The name of the Integration Server adapter
service which calls CICS ECI.
|
| AppMonCICSErrTimeResponse |
Time - Response |
ms |
average |
The response time of the failed CICS ECI
request.
|
| AppMonCICSErrTransaction |
|
|
generic |
The CICS transaction name. |
Average values are calculated in relation to the number of failed
CICS Connect requests in the measuring interval.
Built-In Rules
| Administration Name |
Expression |
Severity |
Description |
| Application Monitoring CICS ECI Error High
Response Time
|
ApplicationMonitoring.AppMonCICSErrTimeResponse
> 10000
|
3 - Medium |
A failed CICS ECI request had a response time
greater than 10 seconds.
|
| Application Monitoring Reported CICS ECI
Error
|
ApplicationMonitoring.AppMonCICSErrRequestsFailed > 0 |
3 - Medium |
A CICS ECI request failed. |
IMS Connect Application
The event map AppMonIMS monitors the successful IMS Connect requests.
Failed IMS Connect requests are monitored in the event map AppMonIMSErr.
Dimensions
| Administration Name |
Displayed Value |
| ApplicationMonitoring |
The identifier "Application
Monitoring".
|
| AppMonScenario |
The scenario identifier "IMS
Connect".
|
| ApplicationName |
"host-name:port-number/datastore"
of the IMS Connect installation.
|
KPIs of Event Map AppMonIMS
| Administration Name |
KPI Name |
Unit |
Type |
Description |
| AppMonIMSClientHost |
|
|
generic |
The client host name. |
| AppMonIMSClientUser |
|
|
generic |
The client user ID. |
| AppMonIMSLengthReply |
Length - Reply |
bytes |
average |
The length of the IMS reply. |
| AppMonIMSLengthRequest |
Length - Request |
bytes |
average |
The length of the IMS request. |
| AppMonIMSLengthTotal |
Length - Total |
bytes |
average |
The total length of the IMS call (request plus
reply).
|
| AppMonIMSRequestsSuccessful |
Requests Successful |
count |
sum |
The number of successful IMS requests. |
| AppMonIMSService |
|
|
generic |
The name of the Integration Server adapter
service which calls IMS Connect.
|
| AppMonIMSTimeAdapter |
Time - Adapter |
ms |
average |
The time spent in the EntireX adapter. |
| AppMonIMSTimeIMS |
Time - IMS |
ms |
average |
The sum of the transport time to IMS Connect
and the time spend in IMS Connect, IMS and the IMS user program.
|
| AppMonIMSTimeResponse |
Time - Response |
ms |
average |
The complete response time of the IMS
request.
|
| AppMonIMSTransaction |
|
|
generic |
The IMS transaction name. |
Average values are calculated in relation to the number of successful
IMS Connect requests in the measuring interval.
Built-In Rules
| Administration Name |
Expression |
Severity |
Description |
| Application Monitoring IMS Connect High
Response Time
|
ApplicationMonitoring.AppMonIMSTimeResponse
> 10000
|
3 - Medium |
A successful IMS Connect request had a response
time greater than 10 seconds.
|
IMS Connect Error
The event map AppMonIMSErr monitors the failed IMS Connect requests.
Successful IMS Connect requests are monitored in the event map AppMonIMS.
Dimensions
| Administration Name |
Displayed Value |
| ApplicationMonitoring |
The identifier "Application
Monitoring".
|
| AppMonScenario |
The scenario identifier "IMS
Connect".
|
| ApplicationName |
"host-name:port-number/datastore"
of the IMS Connect installation, followed by the string
"Error".
|
KPIs of Event Map AppMonIMSErr
| Administration Name |
KPI Name |
Unit |
Type |
Description |
| AppMonIMSErrClientHost |
|
|
generic |
The client host name. |
| AppMonIMSErrClientUser |
|
|
generic |
The client user ID. |
| AppMonIMSErrErrorCode |
|
|
generic |
The 8 digit error code (error class and
number).
|
| AppMonIMSErrErrorMessage |
|
|
generic |
The error message. |
| AppMonIMSErrRequestsFailed |
Requests Failed |
count |
sum |
The number of failed IMS requests. |
| AppMonIMSErrService |
|
|
generic |
The name of the Integration Server adapter
service which calls IMS Connect.
|
| AppMonIMSErrTimeResponse |
Time - Response |
ms |
average |
The response time of the failed IMS
requests.
|
| AppMonIMSErrTransaction |
|
|
generic |
The IMS transaction name. |
Average values are calculated in relation to the number of failed IMS
Connect requests in the measuring interval.
Built-In Rules
| Administration Name |
Expression |
Severity |
Description |
| Application Monitoring IMS Connect Error High
Response Time
|
ApplicationMonitoring.AppMonIMSErrTimeResponse
> 10000
|
3 - Medium |
A failed IMS Connect request had a response
time greater than 10 seconds.
|
| Application Monitoring Reported IMS Connect
Error
|
ApplicationMonitoring.AppMonIMSErrRequestsFailed > 0 |
3 - Medium |
An IMS Connect request failed. |
RPC Application
The event map AppMonRPC monitors the successful RPC requests. Failed
RPC requests are monitored in the event map AppMonRPCErr.
Dimensions
| Administration Name |
Displayed Value |
| ApplicationMonitoring |
The identifier "Application
Monitoring".
|
| AppMonScenario |
The scenario identifier
"RPC".
|
| ApplicationName |
"application-name"
as defined by the Broker attribute APPMON-NAME. If the Broker
attribute is not specified, the server address is used; for example
RPC/SRV/CALLNAT.
|
KPIs of Event Map AppMonRPC
| Administration Name |
KPI Name |
Unit |
Type |
Description |
| AppMonRPCAddress |
|
|
generic |
The Broker ID and the server address of the RPC
request.
|
| AppMonRPCClientApplication |
|
|
generic |
The client application name as defined in the
Broker control block.
|
| AppMonRPCClientHost |
|
|
generic |
The client host name. |
| AppMonRPCClientUser |
|
|
generic |
The client user ID. |
| AppMonRPCDBCalls |
DB Calls |
count |
average |
The number of database calls (including system
file calls, without Natural Security calls). 1 |
| AppMonRPCLengthReply |
Length - Reply |
bytes |
average |
The length of the RPC reply. |
| AppMonRPCLengthRequest |
Length - Request |
bytes |
average |
The length of the RPC request. |
| AppMonRPCLengthTotal |
Length - Total |
bytes |
average |
The total length of the RPC call (request plus
reply).
|
| AppMonRPCProgram |
|
|
generic |
The program name. |
| AppMonRPCRequestsSuccessful |
Requests Successful |
count |
sum |
The number of successful RPC requests. |
| AppMonRPCTimeBroker |
Time - Broker |
ms |
average |
The time spent in the Broker (active
processing).
|
| AppMonRPCTimeBrokerWaitForServer |
Time - Broker Wait For Server |
ms |
average |
The time spent in the Broker waiting for an
available server.
|
| AppMonRPCTimeClientLayer |
Time - Client Layer |
ms |
average |
The time spent in the client RPC layer. |
| AppMonRPCTimeClientTransport |
Time - Client Transport |
ms |
average |
The transport time from the client to the
Broker and back.
|
| AppMonRPCTimeDBCalls |
Time - DB Calls |
ms |
average |
The time spent for database calls. For an
Adabas database, this is the time the Adabas server needs to process the
database call ("client wait time"). For other
databases, the DB calls time includes also the DB transport time.
1 |
| AppMonRPCTimeDBTransport |
Time - DB Transport |
ms |
average |
The transport time from the Natural user
program to the Adabas router and back including the client receiving time.
1, 2 |
| AppMonRPCTimeResponse |
Time - Response |
ms |
average |
The complete response time (roundtrip from
client to server and back).
|
| AppMonRPCTimeServerLayer |
Time - Server Layer |
ms |
average |
The time spent in the server RPC layer (runtime
and stub).
|
| AppMonRPCTimeServerProgram |
Time - Server Program |
ms |
average |
The time spent in the user program (called by
the RPC server). For Natural programs on a mainframe, this time does not
include the database times. For other programs, the database times are
included.
|
| AppMonRPCTimeServerTransport |
Time - Server Transport |
ms |
average |
The transport time from the Broker to the
server and back.
|
Average values are calculated in relation to the number of successful
RPC requests in the measuring interval.
Notes:
1 This KPI is only available if the call is issued by
a Natural RPC server on a mainframe.
2 This KPI is only available for a database call
against an Adabas server.
Built-In Rules
| Administration Name |
Expression |
Severity |
Description |
| Application Monitoring RPC High Response
Time
|
ApplicationMonitoring.AppMonRPCTimeResponse
> 10000
|
3 - Medium |
A successful RPC request had a response time
greater than 10 seconds.
|
RPC Error
The event map AppMonRPCErr monitors the failed RPC requests. Successful
RPC requests are monitored in the event map AppMonRPC.
Dimensions
| Administration Name |
Displayed Value |
| ApplicationMonitoring |
The identifier "Application
Monitoring".
|
| AppMonScenario |
The scenario identifier
"RPC".
|
| ApplicationName |
"application-name"
as defined by the Broker attribute APPMON-NAME, followed by the
string "Error". If the Broker attribute is not
specified, the server address is used; for example RPC/SRV/CALLNAT
Error.
|
KPIs of Event Map AppMonRPCErr
| Administration Name |
KPI Name |
Unit |
Type |
Description |
| AppMonRPCErrAddress |
|
|
generic |
The Broker ID and the server address of the RPC
request.
|
| AppMonRPCErrClientApplication |
|
|
generic |
The client application name as defined in the
Broker control block.
|
| AppMonRPCErrClientHost |
|
|
generic |
The client host name. |
| AppMonRPCErrClientUser |
|
|
generic |
The client user ID. |
| AppMonRPCErrErrorCode |
|
|
generic |
The 8 digit error code (error class and
number).
|
| AppMonRPCErrErrorMessage |
|
|
generic |
The error message. |
| AppMonRPCErrProgram |
|
|
generic |
The program name. |
| AppMonRPCErrRequestsFailed |
Requests Failed |
count |
sum |
The number of failed RPC requests. |
| AppMonRPCErrTimeResponse |
Time - Response |
ms |
average |
The response time of the failed RPC
request.
|
Average values are calculated in relation to the number of failed RPC
requests in the measuring interval.
Built-In Rules
| Administration Name |
Expression |
Severity |
Description |
| Application Monitoring RPC Error High Response
Time
|
ApplicationMonitoring.AppMonRPCErrTimeResponse
> 10000
|
3 - Medium |
A failed RPC request had a response time
greater than 10 seconds.
|
| Application Monitoring Reported RPC
Error
|
ApplicationMonitoring.AppMonRPCErrRequestsFailed > 0 |
3 - Medium |
An RPC request failed. |
