Help: Performance tool — Using the full details display |
C-1823The Full, Init, and Delta links of the Performance report (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:
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 Process Commander. In
general, the decimal places reported are significant. Per-requestor CPU
statistics are not available for UNIX platforms. R-14873 The
value NaN
indicates a divide-by-zero or other numeric
exception.
All performance statistics are property values on a clipboard page of the Code-Pega-PAL class.
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. DORID 11/08/06B-24166 OSLOK 5/8/07 clinic |
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)
C-1823These statistics apply to all Threads in the current requestor session; most requestor sessions involve only one Thread. Times are in seconds.
Label and Property |
Notes |
Total Elapsed time for the reading(s)
pxTotalReqTime |
Time since the previous reading. |
Elapsed time retrieving non-rule-resolved instances
from database pxOtherIOElapsed |
Includes elapsed time retrieving or saving work objects, data objects, history instances, and assignments. |
Elapsed time retrieving rule-resolved Rules from the
database pxRuleIOElapsed |
Includes elapsed time retrieving or saving most rules. |
Elapsed time executing Declarative
Rules
pxDeclarativeRulesInvokedElapsed |
|
Elapsed time retrieving Declarative
rules
pxDeclarativeRulesLookupElapsed |
Time spent constructing dependency networksB-14085 |
Elapsed time retrieving non-Rule database
lists pxOtherBrowseElapsed |
Elapsed time for Obj-List operations. excluding Obj-List operations on rules |
Elapsed time processing Storage Streams for non-Rule
database lists
pxOtherBrowseFilterElapsed |
|
Elapsed time retrieving lists of Rules from the
database pxRuleBrowseElapsed |
Elapsed time for Obj-List operations on rules |
Elapsed time processing Storage Streams for Rule
database lists
pxRuleBrowseFilterElapsed |
Storage Stream |
Elapsed time performing Rule assembly pxJavaAssembleElapsed |
rules assembly |
Elapsed time compiling Rules pxJavaCompileElapsed |
|
Elapsed time checking Java syntax pxJavaSyntaxElapsed |
The system performs a syntax check of generated Java, before full compilation. |
Elapsed time executing Connect Rules pxConnectElapsed |
Waiting for responses after a connector calls |
Elapsed time performing explicit database commit
operations pxCommitElapsed |
Commit operations |
Elapsed time spent redirecting Reference Properties | reference properties |
Elapsed time spent finding declarative pages names | declarative pages PROJ-359 |
Elapsed time spent loading declarative pages names | declarative pages PROJ-359 |
Elapsed time spent determining if a page name is declarative | declarative pages PROJ-359 |
Elapsed time spent performing BLOB
encryption
pxEncryptElapsed |
How to encrypt Storage Streams of selected classes. PROJ-474 |
Elapsed time spent performing BLOB
decryption
pxDecryptElapsed |
How to encrypt Storage Streams of selected classes. PROJ-474 |
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 — that is, rules converted to Java — 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.
Label and Property |
Notes |
Total number of Rules executed pxRulesUsed |
|
Rules requested from the database pxRulesExecuted |
Counts rules for rules assembly only, excludes some rules expanded into inline Java code |
Tracked property changes
pxTrackedPropertyChangesCount |
For declarative rule processing. See Pega Developer Network article PRKB-18112 How to identify which properties are tracked for declarative processing. |
Activities executed
pxActivityCount |
Counts activity executions started. |
Connects executed
pxConnectCount |
Counts connectors started. |
Declarative Rules executed |
Counts declarative rules executed, including those reached by chaining. |
Declarative Expressions executed Context sensitive pxDeclExprCtxSensUseCount |
Count of the number of Declare Expression rules executed in which the rule explicitly identifies a fully qualified reference to the target property. See Context free expression. PROJ-30 |
Declarative Expressions executed Context free pxDeclExprCtxFreeUseCount |
Count of the number of Declare Expression rules executed in which the target property is on an embedded page that is not explicitly named in the rule. See Context free expression. PROJ-30 |
Flows executed pxFlowCount |
Count of flow executions started. B-24159 |
Edit Rules executed pxRunOtherRuleCount |
Includes both Rule-Edit-Input and Rule-Edit-Validate rules |
Models executed pxRunModelCount |
|
Services executed pxServiceCount |
service B-24103 |
Streams executed pxRunStreamCount |
Includes all rule types derived from Rule-Stream, including harness, fragment, correspondence, and XML Stream rules |
Whens executed
pxRunWhenCount |
|
Rule assemblies pxJavaAssembleCount |
|
Java compilations pxJavaCompileCount |
|
Java syntax checks pxJavaSyntaxCount |
|
Number of Java steps executed pxJavaStepCount |
|
Legacy-based Rules executed pxLegacyRuleAPIUsedCount |
Rules executed that use Process Commander version 02 PublicAPI facilities |
Reference Property redirections | |
Declarative Page load activities executed |
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 |
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 the PRServlet servlet. |
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. SAY WHAT? |
HTML transaction frame map size
(bytes)
pxFrameTransactionMapSize |
Count of bytes in HTML frames retained in memory to support transactions. B-19763 |
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 BUG-1993 |
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. |
These report on executions of Connect EJB, Connect Java, Connect SOAP, Connect MQ, Connect JMS, and Connect MQ rules. For complete information about interpreting these statistics, see Testing Services and Connectors, a document the Integration Services page of the Pega Developer Network. Proj-314 5.3
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 |
Amount of data received from client, in kilobytes. |
CPU Time Detail For This Requestor (seconds)
Per-requestor CPU statistics are not available for Process Commander systems hosted on UNIX platforms.
Label and Property |
Notes |
Total CPU time for the reading(s) pxTotalReqCPU |
Total CPU time this JVM responding to HTTP requests and to service requests. This is larger than the sum of the detailed CPU values in this section, as it includes system CPU for other processes and other sources. VAGUE SR-6515 |
CPU time accessing non-rule-resolved instances from
the database
pxOtherIOCPU |
CPU time supporting input or output of instances other than rules: data objects, work objects, assignments, history, and similar instances. |
CPU time retrieving rule-resolved Rules from the
database pxRuleCPU |
CPU time supporting input or output of rules (excludes time spent assembling, syntax-checking, compiling, or executing rules). |
CPU time executing Declarative Rules
pxDeclarativeRulesInvokedCPU |
|
CPU time retrieving Declarative Rules pxDeclarativeRulesLookupCPU |
|
CPU time retrieving non-Rule database lists pxOtherBrowseCPU |
Time spent on Obj-List operations for objects other than rules |
CPU time processing Storage Streams for non-Rule
database lists pxOtherBrowseFilterCPU |
|
CPU time retrieving Rule database lists pxRuleBrowseCPU |
Time spent on Obj-List operations for rule instances. |
CPU time processing Storage Streams for Rule
database lists pxRuleBrowseFilterCPU |
|
CPU time performing Rule assembly pxJavaAssembleCPU |
|
CPU time compiling Rules pxJavaCompileCPU |
|
CPU time checking Java syntax pxJavaSyntaxCPU |
|
CPU time spent redirecting Reference Properties | |
CPU time spent finding declarative page names | |
CPU time spent loading declarative pages | |
CPU time spent determining if a page name is declarative | |
CPU time spent performing BLOB
encryption
pxEncryptCPU |
How to encrypt Storage Streams of selected classes. PROJ-474 |
CPU time spent performing BLOB
decryption
pxDecryptCPU |
How to encrypt Storage Streams of selected classes. PROJ-474 |
These statistics are for the current requestor only. Counts do not include rules read from the rule cache except as noted.
Label and Property |
Notes |
Rule-resolved rules requested from the database or
cache pxRuleCount |
Number of read operations for rules (not the number executed) from the PegaRULES database or the rule cache, for rule types with an Applies To key part. |
Rule-resolved rules retrieved from the cache pxRuleFromCacheCount |
Number of read operations for rules satisfied from the rule cache. BUG-1055 |
Procedural Rules retrieved from the
database
pxProceduralRuleReadCount |
Excludes declarative and property rules. Excludes reads from the rule cache. |
Declarative Rules retrieved from the databasepxDeclarativeRulesLookupCount | declarative rules |
Property rules retrieved from the database pxPropertyReadCount |
|
Non-Rule-resolved instances requested from the
database or cache
pxOtherCount |
Number of read operations for rules (not the number executed) from the PegaRULES database or the rule cache, for rule types with an Applies To key part. |
Non-Rule-resolved instances retrieved from the
cache
pxOtherFromCacheCount |
Number of read operations for rules (not the number executed) from the rule cache, for rule types with an Applies To key part. |
Non-Rule-resolved instances retrieved from the
database pxOtherIOCount |
Number of read operations for rules (not the number executed) from the PegaRULES database, for rule types with an Applies To key part. |
Number of bytes read from database Storage Streams
(uncompressed) pxDBInputBytes |
Storage Stream |
Number of bytes written to database Storage Streams
(uncompressed) pxDBOutputBytes |
Storage Stream |
Declarative Indexes written pxIndexCount |
Count of Index- instances created by Declare Index rules |
Obj-List requests to the database that * did not
require a storage stream pxListRowWithoutStreamCount |
|
Obj-List requests to the database that * required
all of the storage stream pxListRowWithUnfiltered StreamCount |
Storage Stream |
Obj-List requests to the database that * required
some of the Storage Stream pxListRowWithFiltered StreamCount |
Storage Stream |
Rows returned from a RDB-List method that did not
require a Storage Stream
pxRDBRowWithout StreamCount |
RDB-List methodB-18650 |
Rows returned from a RDB-List method that did
require a Storage Stream
pxRDBRowWith StreamCount |
|
Database Commit Count pxCommitCount |
Count of Commit operations by this requestor (including failed attempts). Does not include RDB methods that perform Connect SQL operations. C-2653 5.2 |
Database Rows Committed
pxCommitRowCount |
Number of rows successfully committed to the database by Commit operations by this requestor Does not include RDB methods that perform Connect SQL operations. C-2653 5.2 |
BLOB encryption
pxEncryptCount |
See How to encrypt Storage Streams of selected classes. PROJ-474 |
BLOB decryption
pxDecryptCount |
See How to encrypt Storage Streams of selected classes. PROJ-474 |
Storage Stream values — values of columns named
pzPVStream — have one of three formats (V4, V5, and
V6). A setting in the prconfig.xml
file 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 V4 format, update the instance, and save the instance, the system saves Storage Stream in the current format, typically V6.
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. STEWS 11/9/06 NOT WORKING? |
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. (V6 is the default format for V4.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. (V5 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. (V4 was the default format for Version 03-01.) |
Shared Declarative Pages |
Count of node-level declarative pages in use by all requestors on your current node. MIRAT 5/14/07 |
Shared Clipboard Size (bytes) |
Total size in bytes of the node-level declarative pages in use by all requestors on this node. MIRAT 5/14/07 |
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. TANDP 9/20/06
For complete information about interpreting these statistics, see Testing Services and Connectors, a document on the Integration Services page of the Pega Developer Network.
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 thebeginning of the service activity execution until it completes. WHAT UNITS? |
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. |
Reporting on Performance Details
The system captures performance details for interactive users at the interaction level, but this data is not retained.
The system also captures performance details for each requestor
once each hour and also at sign-off. The usage daemon saves these
details as instances of the Log-Usage class. You can report on these
details using SQL reporting tools and the pr_perf_stats
database table. See How
to analyze system-wide usage with the Log Usage class.
URL for the PAL Advisor System
C-1823 Reserved. Do not use the following fields except as advised by Pegasystems Global Services.
Field |
Description |
URL for the PAL Advisor System |
Reserved. |
User Name for the PAL Advisor system |
Reserved. |
Password |
Reserved. |
Number of CPUs in the measured system |
Reserved. |
CPU Speed (MHz) in the measured system |
Reserved. |
Alert log, declarative rule, NaN, rules assembly, rule cache, rule resolution, Storage Stream, Thread |