Learn about trigger criteria in notification rules

You can configure trigger criteria for an event to determine when a notification will be sent to the appropriate delivery channel, for example, an email address or web service. The trigger conditions are configurable in the Trigger Criteria pane, and further options can be configured in the Options pane.

To see the Trigger Criteria and Options panes on PI System Explorer, navigate to the Notification Rules tab for a selected element, and then click View/Edit Trigger in the Trigger pane.

Trigger Criteria pane

The Trigger Criteria pane allows you to configure either of these trigger criteria modes: Analysis or Event Frame Search.

Use analysis mode to trigger a notification rule on event frames generated by a particular analysis. In the Analysis mode, you can select an existing analysis or configure a new analysis of type Event Frame Generation or SQC, and optionally configure additional trigger conditions based on event frame attribute values. If you choose to create a new analysis with either the default or a custom name, you see the same analysis creation window as from the Analyses tab. For information on configuring an SQC analysis, see Create an SQC analysis. For information on creating an Event Frame Generation analysis, see Create an event frame generation analysis. For information on expression functions to be used as a trigger condition, see List of expression functions reference.

Note: For notifications to take effect, you must check in both the analysis and the notification rule. When creating an SQC analysis from the Trigger Criteria pane, you can only choose Event Frame as the analysis output.

Use event frame search mode to trigger a notification rule based on event frame name, template and category. In the Event Frame Search mode, you can select a configured event frame template, from the drop-down list, and then configure the name and category for the event frames that will trigger your notifications. The name may contain wildcard characters that are supported by event frame search. You can optionally configure additional trigger conditions based on event frame attribute values.

For both Analysis and Event Frame Search modes, you can add additional trigger criteria using event frame attribute values. Criteria can be specified for any event frame template attribute that is specified in the notification rule trigger criteria. The attribute values that you select in the conditions must be specifically those for which you want to be notified of event frames (that match the analysis event frame template). For example, if your event frame template defines an event like "downtime" but you only want an email about "unplanned" downtime, you can configure an attribute value condition where a "reason code" attribute on the "downtime" event frame template has a value indicating "unplanned" downtime.

Note: Multiple conditions are grouped using the AND operator.

Options pane

The Options pane allows you to configure these trigger options:

• Resend Interval

  The time interval after which PI Notifications Service will send additional alerts until the event frame matching the notification rule is acknowledged or closed.

• Non-repetition Interval

  The time interval during which PI Notifications Service will not send similar alerts associated with the same notification rule.

• Event Frame Can Be Acknowledged

  Option to enable event frame to be acknowledged; the event frame template is also modified accordingly. This option is automatically selected if the event frame template has been configured for acknowledgment.

• Severity option

  This option applies only to event frame generation analyses. If you have configured multiple start triggers for your analysis, you may choose to be notified in these ways:

  • When the current trigger severity is higher than any trigger severity encountered so far.

  • When the current trigger severity is higher than the previous trigger severity.

  • Every time a trigger condition is true, regardless of its relative severity to other previous triggers.