• Products
  • Get started
  • Documentation
  • Resources

How do escalations work in Opsgenie?

If you’re using Opsgenie’s Free and Essentials plans, or Jira Service Management’s Standard plan, escalation policies don't include the functionalities below:

Notify Group, Notify next user in schedule, Notify previous user in schedule, Notify random member of team, and Repeat options.

Please upgrade to Opsgenie’s Standard or Enterprise plan, or Jira Service Management’s Premium or Enterprise plan to use enhanced escalation policy options.

Escalation policies

When multiple users or a group (with multiple users as members) are specified as the Responders of an alert, Opsgenie notifies each user at the same time according to their notification preferences. However, notifying users in a desired order is required in most cases, instead of notifying all of them at once. Escalations are used to notify responders according to a given order. After an escalation is added as a responder to an alert, the escalation rules notify responders when the specified time is over and the state of the alert meets the specified condition.

Watch Using escalation policies video on Youtube.

Each escalation rule can have one of the following as its responders:

  • Responder users

  • Groups (this option has been deprecated)

  • Teams (Note that if the escalation rule is configured to have a team as its responder, routing rules of the specified team will be applied while determining notification targets).

  • All members of a team

  • Admin(s) of a team or user(s) of a team (Note that only the default rules can be a target of an escalation)

  • A random member of a team (Note that because of randomness, if this step is repeated, the same member can be chosen consecutively)

  • On-call members of a schedule

  • Next on-call member of a schedule

  • Previous on-call member of a schedule

While adding rules to an escalation, specify a condition for the rule to notify its responder. Each rule has one of the following as its notify condition:

  • Alert is not acknowledged

  • Alert is not closed

If these conditions are specified for an alert, then the escalation rule is evaluated and the responder is not notified according to these conditions.

The following is an example escalation setup:

Update escalation

Click each rule to expand and edit the configuration of the escalation, such as the action being taken on the alert, time after which an action needs to be taken, and who needs to be notified. Each rule is added and configured via the drop-down menus and entry fields as shown above.

Click Save to save each rule individually, Add Rule to add an entirely new rule, and Update to update any changes made.

Escalations also have an option of "repeating", as shown with the toggle switch (pictured above and below). With this option, when the time for the last escalation rule passes, the escalation policy is restarted after the time for repeating (if one is specified) passes.

Escalation settings

If the option to "Revert acknowledge and seen states back on each repeat turn" is selected, all states of the alert that prevent a responder from being notified are reverted while an escalation is repeating and the alert is still open. In other words, even if the alert is acknowledged or a responder from an escalation has seen the details of the alert via any of the Opsgenie apps, the responder of the escalation rules are notified on the next repeat turn.

If the option to "If escalation repeats are completed, close the alert automatically" is selected, the escalation automatically closes the alert after the repeats are completed (even if the alert is acknowledged).

  • An escalation can be configured to repeat at most 20 times for a single alert.

When the responders field of an alert is set to an escalation policy, Opsgenie uses that escalation policy to determine who to notify, when, and in what order. Opsgenie escalations are defined on Team > On-call section or Escalations API. In addition, a default team escalation policy is created automatically for each team. When a team is added to an alert, the escalation policy of the team is used to determine who should be notified, and when. The following is an example escalation of a team:

Escalation policies

The default team escalation policy is a good example to understand escalations. Using this escalation policy, Opsgenie first sends notifications to the on-call user(s) based on the on-call schedule. In the example above, on-call users can view and acknowledge/close the alert. If/when the alert is acknowledged or closed, the escalation policy stops.

If the alert is NOT acknowledged or closed after 5 minutes, then Opsgenie executes the second escalation step and notifies the next user in the rotation. Finally, if the alert is still not acknowledged or closed after 10 minutes, the third escalation step is executed and all members of the team are notified.

Additional Help