Managing runtime configuration
Archived
3 Tasks
20 mins
Scenario
MyTown has encountered an error using a robot to process the creation of New Water Service accounts. A support request has been sent to you to investigate this issue. Before you can suggest a recommendation to resolve this issue, you need to capture the error in a Runtime log file. Using Pega Robot Manager™, you must manage the Runtime configuration settings by enabling the creation of a detailed diagnostics log file, capturing the automation, adapter, and matching activity of the robot. After updating the Runtime configuration settings, you must assign the updated configuration file to your robot to verify the updates to the configuration file.
Challenge Walkthrough
Detailed Tasks
1 Save a copy of the master Runtime configuration file
- Log in to the Pega Platform instance by using Operator ID RMSysAdmin and password myt0wn@pp1.
- From the Dev Studio header, click to open the Robot Manager portal.
- On the Pega Robot Manager dashboard, click Settings to display the Settings landing page.
- On the Settings landing page, click the Master Runtime Config Settings link to display the configuration file.
- In the upper-right corner of Pega Robot Manager, click Actions > Save as to display the Save as dialog box.
- In the Settings name field, enter Runtime Diagnostics Enabled.
- In the Description of settings contents text box, enter Logging enabled to verbose for automation, matching and adapter categories.
- Click Create to dismiss the Save as dialog box and create the new configuration file.
2 Edit the Runtime configuration file
- In the upper-right corner of the Settings landing page, click Edit to display the Configuration File in edit mode.
- Scroll down to line 16 and change the
publisher mode
-
Scroll down to line 493 and change the
logLevel
to 4 for the Adapter Category. -
Scroll down to line 495 and change the
logLevel
to 4 for the Matching Category. - Scroll down to line 511 and change the
logLevel
to 4 for the Automation Category. - Click Validate to check for errors in the configuration file. Wait for the No errors found message.
- Click Save to display the Save changes dialog box.
- In the Comment text box, enter verbose logging enabled for adapters, automations.
- Click the Submit button to save the configuration.
Note: Publisher mode enables the Runtime diagnostics to create a log file. The log level setting records error, warning, informational messages and verbose debugging output. Log level 4 generates detailed messages and is commonly used to capture the robot's behavior.
3 Manage the new Runtime configuration file
- On the Pega Robot Manager dashboard, click Users to display the Users landing page.
- On the Users landing pace, click the Water Service department link to display the department landing page.
- Click the Override link to display the Override dialog window.
- From the Select from the list of settings drop-down, select Runtime Diagnostics Enabled.
- Click Submit to save the configuration setting.
- On the Pega Robot Manager dashboard, click Settings to display the Settings landing page.
- Verify that users are now assigned to the Runtime Diagnostics Enabled configuration file.