Table of Contents

Debugging applications by using Pega-TracerViewer

Provide bug-free applications by diagnosing and fixing issues, preventing bottlenecks, and analyzing events in your application by using the Pega-TracerViewer tool. You can generate Tracer output in an .xml format so that you can continue debugging offline or share the results with other developers.

The viewer runs as an executable file from a directory on your operating system.

    Obtaining and starting Pega-TracerViewer 3.3

  1. Download the viewer from

  2. Extract the files into a directory on your local operating system.

    Ensure that you maintain the viewer's directory structure.
  3. Start the viewer from the command line by navigating to the directory where you extracted the files and entering the pega-tracerviewer-3.1.cmd command.

  4. Viewing Tracer output data in the TracerViewer 3.3

  5. Start the Tracer tool and configure the tool to capture the information about the areas that you want to investigate, for example, the event types to trace.

    If you plan to analyze the results in the tree view, in the Trace Options window, for events such as activities that have Begin and End options, either select or clear both check boxes to ensure that the viewer nests the events correctly in the tree view.
  6. From Pega Platform, run the process that you want to investigate.

    If you want to investigate the performance of a specific business process, run that process. As you perform actions on the system, the Tracer tool captures data according to the criteria that you set in step 4.
  7. In the Tracer window, click Save to download the .xml file to your downloads directory.

  8. In the header of the TracerViewer, click File Load Pega Tracer File File.

  9. In the file directory window, navigate to the .xml file with the Tracer output, and then open the file.

You can view the Tracer results in offline mode, as displayed in the following figures:
TracerViewer 3.3 results
TracerViewer 3.3 for Cosmos React

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.