Configuring Pega Robot Runtime to send robot activity logs to Pega Robot Manager
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
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.
Log in to Pega Robot Manager.
From the Pega Robot Manager menu bar, select Settings.
In the Runtime configs tab, click the name of the Runtime configuration file that you want to modify.
In the top-right corner or the Settings tab, click Edit.
Enable sending robot activity logs:
Change the value of the
PublishToRobotManager enabledparameter to true.
Change the value of the
RobotActivityLog enabledparameter to true.
To modify the logging level, change the default value of the
eventsToLogparameter.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
To track the health and usage of Pega Robot Runtime through Operational Reporting, configure the following parameters:
Accumulate data for the Automation and Activity Usage report by setting the
UsageStatistics.Enabledparameter to true.
Enter the number of minutes between usage events by modifying the
UsageStatistics.publishIntervalparameter.The default value is 60.
Gather information about how users use Pega Robot Runtime and the various automations by setting the
HealthStatistics.Enabledparameter to true.
This information appears on the Health Report that is available in Pega Robot Manager if you enabled here and in the
The Health report includes the following information:
- Last time Runtime/Agile Desktop users logged in.
- Last version of Runtime that was used.
- 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"/> </PublishToRobotManager>
Confirm your settings by clicking Save.
In the Save changes window, in the Comment box, describe the update and click Submit.
- Downloading robot activity logs
Identify the causes of automation failures by checking robot activity logs. At the time of a failure, Pega Robot Runtime creates a robot activity log that you can download from Pega Robot Manager in a .zip file.