Rulesets FAQ

❗️

End-of-Life

Rulesets and Event Rules webpages reached end-of-life on January 31, 2025 and are no longer visible in the PagerDuty web app. We highly recommend that you migrate to Event Orchestration as soon as possible so you can take advantage of the new functionality, such as improved UI, rule creation, APIs and Terraform support, advanced conditions, and rule nesting.

Access and modifications to event rules are still possible via the API.

FAQ

Are email integration filters/rules, or custom event transformers supported?

This depends on where you are creating event rules:

  • Global rulesets: Email filters/rules are supported. Custom event transformers are not supported, however, global event rules will autodetect and transform events sent to a global endpoint.
  • Service Event Rules: Only basic email filters are supported, while email rules are not supported. Custom event transformers are supported.

Are events transformed into our Common Event Format (CEF)?

  • Events that are routed are transformed into CEF.
  • Global Rulesets: Custom Event Transforms (CETs) are not supported.
  • Service Event Rules: Custom Event Transforms (CETs) are supported.

What happens to events that don’t match any rules?

  • Global Rulesets: Any events that are sent through event rules and do not match any rules are suppressed, and you can find them in the alerts table. You can change this default behavior by editing the catch-all rule at the bottom of your rules list.
  • Service Event Rules: Any events that are sent through service event rules and do not match any will turn into incidents and will not be suppressed.

Is there a way to bulk add/delete/edit global event rules?

Yes. You can leverage the Rulesets API to allow this functionality.

Once an event is routed to a service from my global event rules, will the event rules I set up on my service be respected as well?

Yes. Service event rules can be used in conjunction with your global event rules this way.

Can I send a second event with the same dedup_key and have it follow different actions?

If a second event with the same incident key is passed and de-duplicated into the open incident via global, team, or service event rules, the actions are not followed (ie. raising priority, adding a note) except for when severity is raised.

What happens if I do not create a deduplication key for an email sent to a ruleset?

As emails are processed, the email subject will be used as a default deduplication key. In other words, emails with the same subject line will automatically be deduplicated. To change this behavior, add a custom deduplication key with an event rule action.

Is there a difference between the types of events processed by global event rules vs. service event rules?

Yes, global event rules are written against raw/untransformed events, whereas service event rules are written against transformed/PD-CEF events.

Why wasn't my event suppressed by a rule?

If there is an existing unresolved alert with the same dedup key as the incoming event, this event will be deduped into that alert and the "suppress" action in the event rules will be ignored.


Learn more