Skip to main content

Managing runtime configuration

3 Tasks

20 mins

Visible to: All users
Beginner Pega Robot Manager 8.6.4 Robotic Process Automation English
Verify the version tags to ensure you are consuming the intended content or, complete 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.

You must initiate your own Pega instance to complete this Challenge.

Initialization may take up to 5 minutes so please be patient.

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 left navigation panel, click Settings > Runtime configs to display the Runtime configs landing page.
    The Settings menu showing the runtime configs option
    The link to access Master runtime config settings.
  4. On the Runtime configs landing page, click the Master Runtime Config Settings v8.6.1 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. From the breadcrumb at the top of the configuration page, click Runtime configs to return to the Runtime configs landing page.
    The Pega Robot Studio menu with the link rdirecting to display all defined runtime configurations.
  2. From the list of runtime configuration files on the Runtime configs landing page, click the Runtime Diagnostics Enabled link.
  3. On the Runtime Diagnostics Enabled landing page, click Edit to display the Configuration File in edit mode.
    Robot Manager runtime configuration file edit button.
  4. Scroll down to roughly line 24 and change the publisher mode value to on.
    The runtime configuration file with an option to update settings connected with the publisher mode.
  5. Scroll down to approximately line 590 in the <!-- Adapters - generic messages --> section and in the Adapters category, change the logLevel to 4.

  6. In the same Adapters section for the Matching category, change the logLevel to 4 for the Matching Category.

    The runtime configuration file with an option to update settings connected with the adapter log level.
  7. Scroll down to the <!-- Framework --> section and in the Automation category, change the logLevel to 4
    The runtime configuration file with an option to update settings connected with the framework log level.
  8. Click Validate to check for errors in the configuration file. Wait for the No errors found message.
    Validate button in configuration file.
  9. Click Save to display the Save changes dialog box.
  10. In the Comment text box, enter verbose logging enabled for adapters and automations.
    rm config save as panel
  11. 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 left navigation panel, click Organization > Departments to display the Departments landing page.
    The PRM menu showing the Department option
  2. On the Departments landing pace, click the Water Service department link to display the department landing page.
    The Departments screen of Pega Robot Manager with the Water Services department selected.
  3. Click the Override link to display the Override dialog window.
    The link used to override the runtime configuration in Pega Robot Manager.
  4. From the Select from the list of settings drop-down, select Runtime Diagnostics Enabled.
    Dialog box used to override runtime configuration with an option to submit changes.
  5. Click Submit to save the configuration setting.
  6. On the left navigation panel, click Settings > Runtime configs to display the Runtime configs landing page.
    The main menu of Pega Robot Manager with the Runtime Configs option displayed.
  7. Verify that users are now assigned to the Runtime Diagnostics Enabled configuration file. 
    The Runtime Configs screen of Pega Robot Manager showing the assignment of users.

Available in the following mission:

If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?

Want to help us improve this content?

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