Metric rule triggering Proactive Engagement through alerts

concept brazil Updated Sep 10, 2026 2 min read metric-rule-triggering-pe-through-alerts.md
Raw file servicenow.com

Metric rules create alerts based on their trigger criteria, and the alert actions trigger Proactive Engagement.

Alert actions are triggered when an alert is created based on the specified criteria. You can create an alert based on the values shared in the system properties. The system properties can be set as conditions based on which the alert action is triggered. Applications and devices require different sets of system properties. The alert action is triggered when an alert is created based on the specified criteria and the conditions are met. Through system properties, you can customize the values of these conditions.

  • The alert action for this metric rule hasn't been triggered in the last 72 hours for the user.
  • Fewer than 100 users are impacted for this metric rule within an 8-hour window.

System property

Condition

Description

Type

sn_pren.resolution_freeze_period

Metric rule not triggered in the last 72 hours (default).

The duration (in hours) for imposing a freeze period for a specific user for any unique metric rule configured in Proactive Engagement. Set this value to zero to turn off the freeze period.

integer

sn_pren.device_resolution.user_limit_per_throttling_window

Fewer than 100 users (default) are impacted.

Maximum number of users for which a Proactive Engagement device-related resolution is triggered within a defined time period. The time period is configured in the property sn_pren.device_resolution.throttling_window_duration.

integer

sn_pren.device_resolution.throttling_window_duration

Within an 8-hour (default) window

The time period in minutes within which a Proactive Engagement device-related resolution is throttled. This resolution is throttled if the number of impacted users exceeds the value in the property sn_pren.device_resolution.user_limit_per_throttling_window.

integer

sn_pren.application_resolution.user_limit_per_throttling_window

Fewer than 100 users impacted

Maximum number of users for which a Proactive Engagement application-related resolution is triggered. This resolution is triggered within a defined time period (value of the time period configured in property sn_pren.application_resolution.throttling_window_duration).

string

sn_pren.application_resolution.throttling_window_duration

Within a 1-hour window

The time period in minutes within which a Proactive Engagement application-related resolution is throttled. This resolution is throttled when the number of impacted users exceeds the value in the property sn_pren.application_resolution.user_limit_per_throttling_window.

integer

sn_pren_channel_configuration

Turn on or turn off the notification channels used to notify users.

Administrators can turn on or turn off notification channels in the wizard.

These notification channels are listed only when the related plugin is installed.

string

\[Omitted image "pe\_dexint.png"\] Alt text: Metric rule triggering Proactive Engagement through alerts

Alert closure in Proactive Engagement

Alerts are closed differently in Proactive Engagement for devices and applications.

  • Devices: Alerts generated from metric rules triggered for devices are closed after Proactive Engagement helps the impacted users resolve their issues.
  • Applications: Alerts generated from metric rules triggered for applications aren't closed.

Parent Topic:Using Proactive Engagement

Search documentation
Search document titles and file paths on the brazil branch