Use the Tracer to test and debug a variety of items, including activities, data transforms, decision rules, service rules, parse rules, and processes. You can:
To start the Tracer tool:
To use the Tracer:
To interactively examine details about an event, select values in the event's row in the Tracer display. See Understanding results. To analyze event details outside of the system, use the saved Tracer output file. See PDN article Using the Tracer tool to summarize Tracer XML output in Pega 7 to learn about and download a Windows viewer for Tracer output XML files.
Depending on your access role, some Tracer capabilities may not be available to you.
Use the following controls at the top of the Tracer to set up trace conditions.
Select which rulesets, rules, and events are to be traced.
|Setting Tracer options|
Set or change breakpoints.
Set or change watch variables.
|Setting watch variables|
Choose a requestor session other than your own. Wait a few seconds until the Tracer connects.
|Selecting a connection|
After setting the trace conditions (such as the connection, events to trace, and breakpoints), the usual steps to trace and capture events are:
As the work is performed, the Tracer displays the traced events, according to the selected conditions. Each event is a row in the Tracer display.
Note: If you are tracing data pages and see multiple "ADP Load" events with the same name, make sure you have only one Tracer window open. If you have multiple Tracer windows open, the event results may distribute across several windows, making it hard to evaluate the processes.
If you only need to work offline with the Tracer results, and do not want to interactively view details of the displayed events, you can choose to suppress the event display by setting the Max Trace Events to Display to zero (0) at the bottom of the Tracer Settings window. Using this setting reduces the network traffic and workstation load if you only require the output in a file to work with it offline. When the events display is suppressed, save the file with the output results.
To reduce the quantity of detail sent to the Tracer, select the Abbreviate Events check box in the Tracer Settings window. This can improve performance of the requestor session being traced so that elapsed time statistics during tracing are closer to the normal value (when not being traced). However, when this box is selected, some watch variables may not operate correctly. Clear this box when watch variables are important to your debugging. See Setting Tracer options.
To change trace conditions after tracing has started, first pause tracing, and then use the appropriate option listed in the table in step 1.
Use the following controls to perform the corresponding action.
Pause the session being traced at the next possible moment.
Displays by default.
Resume processing after clicking Pause, or after a breakpoint event.
Displays when tracing is paused.
Erase the displayed events.
Save the Tracer results to your local system for offline analysis.
By default, the system saves the output as an XML file. When tracing in a cluster, and more than one node reported events for a given RuleWatch, the system saves the output as a ZIP file that contains an XML file for each node that reported events. If only one node reported events, then the system saves the output as an XML file.
For information about a Windows viewer for Tracer output XML files, see PDN article Use the Tracer viewer tool to summarize Tracer XML output.
The Tracer display is interactive. The value in the Event Type column indicates that row's event. Click the row to view the details about that event.
For example, when the DB Query option is specified as a traced event, clicking on a row with
SQL Queries in the Event Type column opens a window that displays details such as how long the query took, the SQL statement that was used, and other information.
When the results are saved as a local file, the file contains this detailed event information.
If the node hosting your trace session fails and you encounter a duplicate trace error when you attempt to trace the same service again, you may need to clear stale trace sessions using the System Management Application (SMA).
Open topic with navigation