Skip to main content

Table of Contents

Tracing an agent


Only available versions of this content are shown in the dropdown

On the Agent Management landing page, you can trace agents to check for errors in agent activity. After the trace is complete, you can view the exceptions and debug the issues accordingly.

To access the Agent Management landing page and view the list of agents and the configuration of email notifications on agent failure, you must have the PegaRULES:SysOpsObserver role. To perform all available actions on agents (for example, to trace an agent and configure email notifications on agent failure), you must also have the PegaRULES:SysOpsAdministrator role.

  1. In the navigation pane of Admin Studio, click Resources Agents .

  2. Select an agent name or click the down arrow next to the agent name to view and select a node from the list of nodes that the agent is running.

  3. Click Trace and select one of the following options:

    • Trace next run — Select this option if the next run is within 30 minutes only. If Trace next run or Trace now is scheduled on the same node, this option is not allowed. Otherwise, Trace next run is scheduled.
    • Trace now — Select this option to start the trace immediately. If Trace next run or Trace now is already scheduled on the same node, this option is not allowed. Otherwise, Trace now is scheduled. You can run the agent immediately and wait for 60 seconds for the agent processing to start. If the requestor ID is available within 60 seconds, the requestor is traced. If the requestor is not available within 60 seconds, all threads are busy and an error is displayed.

      For Legacy and Advanced agent modes, if you select Trace now, the trace is completed and the agent activity starts. However, for Standard mode, select to run the trace either on a single item or on all available items at that time. Standard mode operates on queued items. If there are no queued items to process, a message is displayed in the tracer window.
    • Trace next earliest run — Select this option if the next earliest run across the cluster is within 30 minutes. When you schedule this trace, the node that has the next earliest run across the cluster is identified and the trace is scheduled on that node (if no other trace is scheduled on the same node for the same agent).
    • Change settings
  4. Click Exception to access detailed information about exception errors for agents that are traced.

Related Content

Did you find this content helpful?

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

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

Pega Community 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
Contact us