Edit online

Viewing detailed performance statistics for requestor sessions

The Full, Init, and Delta links in the Performance Analyzer (PAL) provide detailed data about a single row of the display. The scope of information on this window depends on which link you clicked on the Performance report.

  • Full link – Statistics reflect all activity since you signed on or clicked Reset.
  • Init link – Statistics reflect activity at the time you most recently started the Performance tool, but not activity since that time.
  • Delta link – Statistics reflect only incremental values between adjacent rows of the Performance report.
Tip: Hold the mouse pointer over a statistic to view tooltip text.

The number of decimal places in timing results depends on the hardware and software supporting Pega Platform. In general, the decimal places reported are significant. Per-requestor CPU statistics are not available for UNIX platforms. The value NaN (Not a Number) indicates a numeric exception, such as dividing a number by zero, or by a small value close to zero, and attempting to compute the square root of a negative number.

All performance statistics are property values on a clipboard page of the Code-Pega-PAL class.

Header

The header area at the top of the display contains these statistics.

Label and Property Notes
Process Started

pxProcessStartWall

Date and time the process started.
ID

pxProcessID

Process ID
Node

pxSystemNode

Node name
Port

pxSystemPort

TCP/IP port
CPU

pxProcessCPU

CPU time in seconds for the entire Java process in this JVM since startup, all requestors combined. Available on the Full display only, for both Windows and UNIX platforms.
Requestor Started

pxRequestorStart

Date and time the requestor started.
Requestor ID

pxRequestorID

Requestor ID, also called connection ID.
Name

pyUserName

User name from operator ID instance, if authenticated.
Thread Started

pxRequestorStart

Date and time this thread started.
PAL Version

pxPALVersion

Performance tool software revision.

Elapsed Time Detail for This Requestor (seconds)

These statistics apply to all threads in the current requestor session; most requestor sessions involve only one thread. Times are in seconds.

Rule Execution Counts

Statistics in this area report how many times rules of various categories were executed for this requestor.

Only rules of rule types subject to rules assembly are counted. Counts increment when an operation starts, not when it ends.

These statistics are summarized across all requestor sessions in the shutdown report. See Working with the shutdown Rule Usage facility.

Requestor Summary

Statistics in this section summarize information about the current requestor session.

Label and Property Notes
Time the Requestor Started

pxRequestorStart

Date and time this requestor started.
Time of this PAL reading

pxPALWall

Time of the statistics in this Performance tool display
Number of Server Interactions

pxInteractions

Database time threshold (milliseconds) pxDBThreshold A constant, set by the operationTimeThreshold value in the prconfig.xml file or dynamic system settings. See How to detect lengthy PegaRULES database operations.
Number of database requests

that exceeded the time threshold

pxDBOpExceedingThresholdCount

Number of database requests that took longer than the threshold on the previous row. Each event appears in the Alert log.
Number of Input Bytes Received by the Server

pxInputBytes

Total bytes (uncompressed) sent in HTTP messages from the browser to Pega Platform.
Number of Output Bytes Sent from the Server

pxOutputBytes

Total bytes (uncompressed) sent to the browser. This statistic includes XML as well as HTML.
Requestor Clipboard Size (bytes) pxEstimatedRequestorDataSize Total size of the clipboard. This value is available only if you selected Add Reading with Clipboard Size from the summary Performance tool display. Available only for Delta readings.
Number of Named Pages created

pxPagesNamed

Results of the getPageNames() PublicAPI Java method.
HTML transaction frame count

pxFrameTransactionMapCount

Number of HTML frames retained in memory to support transactions.
HTML transaction frame map size (bytes)

pxFrameTransactionMapSize

Count of bytes in HTML frames retained in memory to support transactions.

Parsing Statistics

These report on executions of Parse XML, Parse Delimited and Parse Structured rules.

Label and Property Notes
Total number of parse rules

pxParseRuleCount

Count of parse rules executed
Elapsed time to process parse rules

pxParseRuleTime

Wall time during which parse rules were executed.
CPU time to process all parse rules

pxParseRuleTimeCPU

Available for Windows servers only.

Connect Statistics

These report on executions of Connect EJB, Connect Java, Connect SOAP, Connect MQ, Connect JMS, and Connect MQ rules.

Label and Property Notes
Connect Count

pxConnectCount

Number of connector calls.
Connect time elapsed

pxConnectElapsed

Total time elapsed for connect calls.
Elapsed outbound mapping time

pxConnectOutMapReqTime

Time elapsed to map output.
CPU outbound mapping time

pxConnectOutMapReqCPU

CPU time elapsed to map output.
Elapsed inbound mapping time

pxConnectInMapReqTime

Time elapsed to map input.
CPU inbound mapping time

pxConnectInMapReqCPU

CPU time elapsed to map input.
Connect Client Response time

pxConnectClientResponseElapsedCPU

Time elapsed waiting for client response.
Connect Client Response time

pxConnectClientResponseElapsed

Time elapsed waiting for client response.

Number of bytes received from client

pxConnectResponseDataVolume

Amount of data received from client, in kilobytes.

CPU Time Detail For This Requestor (seconds)

Per-requestor CPU statistics are not available for Pega Platform systems hosted on UNIX platforms.

Database access counts

These statistics are for the current requestor only. Counts do not include rules read from the rule cache except as noted.

Node Summary

Storage Stream values — values of columns named pzPVStream — have one of three formats ( V4 , V5 , and V6 ). A setting in the prconfig.xml file or Dynamic system Settings determines which format the system uses when it saves a Storage Stream. Your system may contain a mixture of formats, even in a single table, because the setting takes effect on a row-by-row basis.

For example, if you open an instance (a row) containing a Storage Stream in Version 4 format, update the instance, and save the instance, the system saves Storage Stream in the current format, typically Version 6.

The Instances Read counts do not include Storage Stream instances read from the rule cache.

Label and Property Notes
System Cache Status

pxCacheEnabled

Indicates whether the rule cache is enabled on this node.
Last Date and Time the Cache was Cleared

pxDateTimeCleared

Date and time that the rule cache on this node was set to empty.
V6 Instances Read

pxInstancesRead

WithV6Stream

Count of pzPVStream instances read from the database by this node for all processing since startup. (Version 6 is the default format for PRPC Version 4.2 and later.)
V5 Instances Read

pxInstancesRead

WithV5Stream

Count of format 5 pzPVStream instances read from the database by this node for all processing since startup. (Version 5 was the default format for Version 04-01.)
V4 Instances Read

pxInstancesRead

WithV4Stream

Count of format 4 pzPVStream instances read from the database by this node for all processing since startup. (Version 4 was the default format for Version 03-01.)
Shared Declarative Pages Count of node-level data pages in use by all requestors on your current node.
Shared Clipboard Size (bytes) Total size in bytes of the node-level data pages in use by all requestors on this node.

Service Statistics (Seconds)

These measures report on the use of services by this requestor. Typically, they are zero for a browser-based requestor. However, they will show service statistics after you unit test a service rule using the Run toolbar button.

For information about interpreting these statistics, see the Pega Community article Testing Services and Connectors.

Label and Property Notes
Elapsed Inbound Mapping Time

pxServiceInMapReqTime

Time elapsed to map request data.
CPU Inbound Mapping Time

pxServiceInMapReqCPU

CPU time elapsed to map request data.
Elapsed Outbound Mapping Time Time elapsed to map response data.
CPU Outbound Mapping time

pxServiceOutMapReqCPU

CPU time elapse to map response data.
Elapsed Activity Time

pxServiceActivityTime

Time required from the beginning of the service activity execution until it completes.
CPU Activity time CPU time for execution of the service activity (Windows only).
Number of records in file

pxServiceNumFileRecords

For Rule-Service-File executions only
Number of bytes received by the Server through services

pxServiceDataVolume

Amount of data received by server in bytes.