Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Configuring Pega Robot Runtime to send robot activity logs to Pega Robot Manager

Updated on December 20, 2022

Modify the RuntimeConfig.xml file so that Pega Robot Runtime can forward robot activity logs to Pega Robot Manager in case of an issue while processing a robotic assignment.

By inspecting robot activity logs, you can understand why an activity did not complete, why it completed with errors, why the process is taking longer than expected even though it succeeded, and so on.
  1. In the navigation pane of Pega Robot Manager, click SettingsRuntime configs.
  2. Click the name of the Runtime configuration file that you want to modify.
  3. In the top-right corner of the Settings tab, click Edit.
  4. Enable sending robot activity logs:
    1. Change the value of the PublishToRobotManager enabled parameter to true.
    2. Change the value of the RobotActivityLog enabled parameter to true.
    3. Optional: To modify the logging level, change the default value of the eventsToLog parameter.
      You can specify the following logging levels:
      • 0 – Never send a log
      • 1 – Send a log when an activity did not complete
      • 2 – Send a log when an activity did not complete or completed with errors
      • 3 – Always send a log
  5. Optional: To track the health and usage of Pega Robot Runtime through Operational Reporting, configure the following parameters:
    1. Accumulate data for the Automation and Activity Usage report by setting the UsageStatistics.Enabled parameter to true.
    2. Enter the number of minutes between usage events by modifying the UsageStatistics.publishInterval parameter.
      The default value is 60.
    3. Gather information about how users use Pega Robot Runtime and the various automations by setting the HealthStatistics.Enabled parameter to true.

      To display health information in the Health Report in Pega Robot Manager, in addition to setting the HealthStatistics.Enabled parameter to true here (as described above), you must also set HealthStatistics.Enabled to true in the EventConsumers section in the Runtime configuration file.

    The Health Report includes the following information:

    • The last time that any Runtime/Agile Desktop users logged in.
    • The last version of Runtime that was used.
    • The last version of the package that was used.
    • Information about any fatal exceptions that were encountered.

    See the following code snippet for reference:

    <PublishToRobotManager enabled="true" ssoUserIdRule="FullUPN">
    		<HealthStatistics enabled="true" />
    		<UsageStatistics enabled="true" publishInterval="60" />
    		<RobotActivityLog enabled = "true" eventsToLog = "1"/>
  6. Confirm your settings by clicking Save.
  7. In the Save changes window, in the Comment box, describe the update and click Submit.

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us