Viewing detailed performance statistics for requestor sessions
-
- Last UpdatedJun 29, 2022
- 10 minute read
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.
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. |