Skip to main content
This content is now archived and is no longer updated. Progress is not calculated. Pega Cloud instances are disabled, and badges are no longer awarded. Click here to continue your progress in the latest version.

Tracer settings management

Tracer settings

The Tracer logs and displays events that occur as you use Pega Platform™. Using the Tracer is resource-intensive and dramatically slows application performance. To reduce the impact of running the Tracer, open and configure the settings of the Tracer to capture only the required information. Pause logging until you are ready to run the application section you want to troubleshoot.

The Tracer toolbar is above the log display on the upper right. The toolbar consists of buttons that enable you to manage the events it captures. 

Tip: You can only have one Tracer per operator, per node.

In the following image, click the + icons to learn more about the Pause, Clear, and Save buttons on the Tracer toolbar.

Refine event logging

Before you begin capturing, refine what you need to capture by indicating the types of events and break conditions to log by using the SettingsBreakpointsWatch, and Remote Tracer buttons on the Tracer toolbar.

In the following image, click the + icons to learn more about SettingsBreakpointsWatch, and Remote Tracer buttons on the Tracer toolbar.

Settings configuration

Use Settings to display the configuration options for your trace, to include event types and rules, and to enter the number of lines of data to display.

settings button

You can use the settings options to reduce the information captured. You can filter tracer display results by event, event type, ruleset, and break conditions. For example, when you want to exclude local variables from your trace, or you want to view which activities run but not their steps. Selecting break conditions stops the tracer when the system generates an error.

The following two images provide a comparison of the number of events traced before and after activity steps are removed from the list of events to trace. In the image on the left, the trace includes steps for all of the activities performed during the trace. The steps for the Finish Assignment activity are located on rows 25 through 32.

The image on the right shows the trace results for the same activity when activity steps are removed from the events to trace. The Finish Assignment activity receives one line for the activity itself. It is located on row 7.

In the center of the following image, slide the vertical line to compare the Tracer logs.

Selection options

The following two images show selection options for Events to Trace, Break Conditions, General Options, Event Types to Trace, and Rulesets to Trace.

tracer settings options
Tip: Scroll through the Event Types to Trace section to view and select the remaining options.

You can configure the maximum number of events to display on the screen with the Max Trace Events to Display field. The maximum events displayed are important when a tracer file is more than 5000 lines. If a traced event returns 5001 lines of data for the current settings, the display truncates row 1. Use zero in the Max Trace Events to Display field to download the events without displaying the events on the screen.

Note: Any increases to the number of events to display also increases your memory footprint and can impact system performance.


Breakpoints and Watch functions

You can configure a Breakpoint or a series of breakpoints to focus on an activity or series of activities that you want to trace. When the activity starts, the Tracer window highlights the event and tracing is paused. Tracing resumes when you click Play or an hour elapses, whichever occurs first, providing you the ability to monitor the progress of the configured activity.

breakpoints button
Note: When a break condition stops the Tracer, the processing on your thread also stops. Use Play to continue processing.

In the following example, a breakpoint is configured for the SendSimpleEmail activity in the Work class. The beginning of the step event is highlighted in the display.

Breakpoint example send simple email

The Watch function is similar to breakpoints, but the watch monitors a specific property value or values to determine if and when the property value changes. This option is useful to check for property value, calculation consistency, and patterns in the trace.

watch button

The Tracer highlights the property change in yellow and shows a Property Inspector tool that indicates how the values changed.

In the following image, a watch is configured for the property .BiweeklySalary on the pyWorkPage. You can add other variables to watch or remove selected variables. Close saves the configured variables.

tracer watch ready to add another property

The following image shows the Property Inspector. It indicates that the property value changed from zero to 2083.33.

tracer property inspector

The OldValue and CurrentValue fields in the Property Inspector updates whenever the property changes value.

Check your knowledge with the following interaction.

This Topic is available in the following Modules:

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice