Skip to main content
Verify the version tags to ensure you are consuming the intended content or, complete the latest version.

Error investigation with the Tracer

Investigate application errors with the Tracer tool

You use the Tracer tool to investigate an issue, by configuring the Tracer to monitor application execution. As your application executes, Pega logs all the processing events that result from application execution. You view the events logged by the Tracer to analyze processing errors and identify their cause.

Tracer displays each event on a separate row. The records display according to the following color code.

  • Gray – Activity processing
  • Orange – Events from flow, decision, or declarative rules
  • Light blue – PegaRULES database and cache operations

For more information on the records the Tracer displays, see the Help topic Tracer results window.

You can access the Tracer from the Runtime toolbar in App Studio and from the Developer toolbar in Dev Studio.


The Tracer logs all the actions and events that occur in a requestor session in Dev Studio. Each event is logged in order of occurrence and is identified by thread, event type, and status.

tracer events

The Name and Ruleset columns identify the rule name and the related ruleset for each line item. Selecting a line item from the Name column opens the rule to review the rule for possible issues. Selecting a row in the Tracer tool allows you to view details about the event. The details are displayed in a new window. From this window, you can view the contents in memory at the time the event occurred. When you finish reviewing the event properties, close the window to return to the Tracer tool.

tracer event properties

Selecting a line item in the Step Page column displays a list of page properties and their values at the time an event executes. You can use this information to determine if the values are different than expected.

For example, the following image shows sample Tracer results. The user clicks the Step Page column for event 11391 to display the properties on the pyWorkPage.

tracer event 11391 highlighter for pywork


tracer event 11391 pywork page properties


If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?

100% found this content useful

Want to help us improve this content?

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