About the Performance Profiler landing page tab

Use the Performance Profiler landing page tab to obtain a detailed trace of performance information about the execution of activities, when condition rules, and data transforms executed by your requestor session. The Profiler traces every execution (in all Threads) of rules of these three types in all RuleSets.

Don't confuse this tool with the Application Profiler — an unrelated tool — or with an operator profile.

This tool provides more performance details than the Tracer tool or the Performance tool. However, when enabled this tool produces extensive output and requires substantial processing overhead. Disable this tool as soon as your data collection is complete.

On UNIX-based servers, only elapsed time statistics are available; CPU statistics are not available.

To profile your requestor session

To profile execution of activities, data transforms, and when condition rules in your requestor session:

1. Select > Performance or > System > Performance > Performance Profiler.
2. Click the Start Profiler link (or icon) the to begin profiler data collection in the background. The link name changes to Stop Profiler.
3. Execute the activities or other rules to be profiled.
4. If necessary, select > Performance again. Click the Stop Profiler link (or the red square).
5. The resulting window lists a Profiler file for each Thread that you used, identified by your Requestor ID and Thread Name. Select a file for the Thread of interest to you. Click  Download or Display Data to send the file to your workstation.
6. Choose  Open   or  Save   in the Windows dialog box. The file type is CSV, for comma-separated values.
7. Open the CSV file with Microsoft Excel to review and analyze the data.

Interpreting Profiler results

The Profiler CSV file includes the following data columns in each row:

Name	Description
Sequence	Marks the beginning of each activity step or other row.
Interaction	Sequence number of the interaction, as recorded in the Performance tool. Starts with 1 upon initial display of the login form.
Activity	Handle of the activity, when condition, or data transform.
Calling activity	Handle of the activity that called the current rule.
Step	Step number. (For when condition rules, this value is always W. For data transforms, this value is always M.)
Method Name or When Result	For activities, identifies the method in the step. For when condition rules, displays true or false. For data transforms, this value is blank.
Total CPU Time	Total CPU time in seconds for this step. If this step contains a Call or Java instruction, the CPU time of called activities is included.
CPU Time Without Children	Total CPU time in seconds for this step, excluding time for called processing. If this step contains a Call or Java instruction, the CPU time of called activities is not included.
Total Wall Time	Elapsed time in seconds to complete this step. Values reflect the impact of other users on this server, waits for database operations and external events, and so on.
Wall Time Without Children	Elapsed time (wall time) in seconds, for this step, exclusive of any called processing. (This value is useful for isolating the performance of Java steps that may perform extensive processing in addition to calling activities.)

Profiling all processing on a node

To profile all processing on an entire Windows server node:

1. Update the prconfig.xml file to add the setting:

<env name="Initialization/ProfileApplication" value="true'/ >

2. Stop and restart the server to implement the new setting.

3. The system produces extensive output, saved in files in the temporary files directory.

As an alternative to the prconfig.xml file, you can use Dynamic System Settings to configure your application.
See How to create or update a prconfig setting.

Do not enable system-wide profiling on a production system, as doing so may significantly impact performance. On a development system, remove or disable this setting as soon as the you capture the needed processing details.

Profiling another requestor

Using the System Management application, you can enable the Profiler for any requestor on any node:

1. Select > System > Tools > System Management Application to start the System Management tool. You may be prompted for authentication credentials.
2. On the System Management form, select a node.
3. Select the Requestor Management menu.
4. Select a radio button identifying a requestor you want to profile.
5. Click  Start Profiling  .
6. When you complete the operations you want to profile, click  Stop Profiling  .
7. Access the server file system. Copy the output file from the ApplicationProfiler directory on the server. This directory is typically a subdirectory of the temporary files directory.

Application Profile, profile, prconfig.xml file, temporary files

Tools — System