How to detect lengthy service operations

Benefits

You can cause Process Commander to a line to the alert log when a service operation or parse rule operation takes an unusually long time. The line identifies the requestor, the service, and the value of the performance statistic.

Through prconfig.xml file settings, you can control whether alerts appear and the threshold value in milliseconds for each type of alert.

Statistics available

Five elapsed time statistics are available for most service types. When any of these five measured times exceeds a corresponding threshold, the system adds a PEGA0011 alert to the Alert log.

• pxTotalReqTime — Total request time, alerts appear by default for times exceeding 1 second.
• pxServiceImpMapReqTime — Request mapping.
• pxServiceOutMapReqTime — Response mapping.
• pxServiceActivityTime — Service activity execution.
• pxServiceParseRuleTime — Parse XML rule, Parse Delimited rule, and Parse Structured rule execution.

Three of the five statistics are available for listeners:

• pxServiceActivityTime
• pxServiceImpMapReqTime
• pxServiceParseRuleTime

One of these values appears as the KPI Value in the alert message, the actual value in milliseconds that exceeded the threshold value.

Each PEGA0011 alert includes actual values for all five statistics, in the PAL Statistics field. Consult Performance tool — Statistics for services for definitions of these values. Consult Understanding Alerts for a description of the fields in each alert line. See also Pega Developer Network article PRKB-25348 Understanding the PEGA0011 Alert.

Changing the threshold values

1. To change the pxTotalReqTime alerts, edit the prconfig.xml file to set a minimum value for the totalRequestTime element in milliseconds, and to control whether pxTotalReqTime alerts appear: For example, to set the value to 850 milliseconds, add this element:

   <env name="alerts/services/totalRequestTime/enabled" value="true">
   <env name="alerts/services/totalRequestTime/threshold" value="850">

2. Stop and redeploy or restart the Process Commander server.
3. Monitor the Alert log for messages.

As of v5.3, the statistics for pxServiceImpMapReqTime, pxServiceOutMapReqTime, pxServiceActivityTime, and pxServiceParseRuleTime are included in PEGA0011. If you want to monitor the time thresholds individually, change the enabled setting to "true". Edit the default threshold value if necessary. The default prconfig.xml settings for these alerts are as follows:

<env name="alerts/services/inboundMapping/enabled" value="false">
<env name="alerts/services/inboundMapping/threshold" value="500">

<env name="alerts/services/outboundMapping/enabled" value="false">
<env name="alerts/services/outboundMapping/threshold" value="500">

<env name="alerts/services/activityTime/enabled" value="false">
<env name="alerts/services/activityTime/threshold" value="500">

<env name="alerts/parse/totalTime/enabled" value="false">
<env name="alerts/parse/totalTime/threshold" value="500">

Notes

For more information about alerts and services, see Testing Services and Connectors, a document on the Integration pages of the Pega Developer Network. Consult the Configuration Settings Reference, also on the Pega Developer Network, for information on all prconfig.xml file settings.

BPEL services operate asynchronously and are not monitored by this facility.

	Alert log, key performance indicator
	Understanding alerts

Integration Services category