Skip to main content

Managing runtime configuration


3 Tasks

20 mins

Visible to: All users
Beginner Pega Robot Manager 8.5.1 Robotic Process Automation English
This content is now archived and is no longer updated. Progress is not calculated. Pega Cloud instances are disabled, and badges are no longer awarded. Click here to continue your progress in the latest version.


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

  1. Log in to the Pega Platform instance by using Operator ID RMSysAdmin and password myt0wn@pp1.
  2. From the Dev Studio header, click Launch portal > Robot Manager to open the Robot Manager portal.
  3. On the Pega Robot Manager dashboard, click Settings to display the Settings landing page.
    rm settings menu item
    master runtime file
  4. On the Settings landing page, click the Master Runtime Config Settings link to display the configuration file. 
  5. In the upper-right corner of Pega Robot Manager, click Actions > Save as to display the Save as dialog box.
    Robot Manager Actions Save as menu.
  6. In the Settings name field, enter Runtime Diagnostics Enabled.
  7. In the Description of settings contents text box, enter Logging enabled to verbose for automation, matching and adapter categories.
    rm save as dialog
  8. Click Create to dismiss the Save as dialog box and create the new configuration file.

2 Edit the Runtime configuration file

  1. In the upper-right corner of the Settings landing page, click Edit to display the Configuration File in edit mode.
    Robot Manager runtime configuration file edit button.
  2. Scroll down to line 16 and change the publisher mode value to on.
    rm configuration publisher mode
  3. Scroll down to line 493 and change the logLevel to 4 for the Adapter Category.

  4. Scroll down to line 495 and change the logLevel to 4 for the Matching Category.

    rm configuration adapter category
  5. Scroll down to line 511 and change the logLevel to 4 for the Automation Category. 
    rm configuration automation category
  6. Click Validate to check for errors in the configuration file. Wait for the No errors found message.
    Validate button in configuration file.
  7. Click Save to display the Save changes dialog box.
  8. In the Comment text box, enter verbose logging enabled for adapters, automations.
    rm config save as panel
  9. 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

  1. On the Pega Robot Manager dashboard, click Users to display the Users landing page.
    rm users dashboard link
  2. On the Users landing pace, click the Water Service department link to display the department landing page.
    rm config water service department
  3. Click the Override link to display the Override dialog window.
    rm override link
  4. From the Select from the list of settings drop-down, select Runtime Diagnostics Enabled.
    rm override dialog
  5. Click Submit to save the configuration setting.
  6. On the Pega Robot Manager dashboard, click Settings to display the Settings landing page.
    rm settings menu item
  7. Verify that users are now assigned to the Runtime Diagnostics Enabled configuration file. 
    rm configuration user count

Available in the following mission:

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

Pega Academy 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