Configuring Service REST rule monitoring
To use monitoring, you must turn it on for the rules that you want to trace. You can configure monitoring to monitor all Service REST rules in the system, all rules in a service package, or individual Service REST rules. Monitoring is useful for debugging your application during development, for example, if a request is failing.
The configuration for specifying when to monitor a Service REST rule is hierarchical, based on the service/EnableGlobalMonitoring dynamic system setting, the service package settings, and the individual Service REST rule setting.
The service/EnableGlobalMonitoring dynamic system setting with owning ruleset Pega-IntegrationEngine, can be set to On, Off, or Deferred (the default). When set to On, all REST services in the system are monitored. When set to Off, no REST services in the system are monitored. When set to Deferred, you can configure monitoring on the service package or individual service level. If the setting does not exist, the default behavior is the same as if it is set to Deferred.
Monitoring at the service package and individual service level is configured on the rule forms. When monitoring is set to On at the service package level, all REST services in the package are monitored. When monitoring is set to Off at the service package level, no REST services in the package are monitored. When monitoring is set to As defined on the service rule, you can configure monitoring at the individual service level.
At the individual service level, monitoring can be set to either On or Off.
At the service package and service level, you can also configure whether to capture the state of the primary data page.
- Configure monitoring for all Service REST rules, an individual service, or a service
package:
Choices Actions Configure monitoring for all Service REST rules - In the navigation pane of Dev Studio, click Records.
- Expand the SysAdmin category, and then click Dynamic System Settings.
- Locate and click the service/EnableGlobalMonitoring setting.
- In the Value field, enter On to
enable monitoring for all Service REST rules, or Off to
disable monitoring for all Service REST rules.
Configure monitoring for a service package - In the navigation pane of Dev Studio, click Records.
- Expand the Integration-Resources category, and then click Service Package.
- Click the service package that you want to configure.
- On the Context tab, click the Gear in the Service monitoring field.
- Configure monitoring rules by performing one of the following actions:
- Select On to monitor all rules in the service package.
- Select Off to turn off monitoring for all rules in the service package.
- Select As defined on the service rule to configure monitoring at the service level.
- Optional: If you selected On, you can select whether to include the clipboard state of the primary data page by clicking Yes or No.
- Click Submit.
Configure monitoring for an individual service level - In the navigation pane of Dev Studio, click Records.
- Expand the Integration-Services category, and then click Service REST.
- Click the service level that you want to configure.
- On the Service tab, click the Gear in the Service monitoring field.
- Select On to turn monitoring on for this rule or Off to turn monitoring off for this rule.
- Optional: If you selected On, you can select whether to include the clipboard state of the primary data page by clicking Yes or No.
- Click Submit.
- Click Save.
Previous topic Service REST monitoring Next topic Automatically purging invocation history