Documentation

Reminders and Escalations

Version v2.3.1 · Updated
Interactive docs View on GitHub

Reminders and Escalations#

IncidentRelay can send repeated reminders for unacknowledged firing alerts and escalate an alert to the next on-call user after a configured number of reminders.

Reminder interval#

Reminder interval is configured on the rotation.

0       disables reminders for this rotation
>= 60   enables reminders with this interval in seconds
1..59   invalid

Examples:

ValueMeaning
0Do not send reminders
60Send reminders every 60 seconds
300Send reminders every 5 minutes
900Send reminders every 15 minutes

Scheduler interval versus reminder interval#

The scheduler has its own wake-up interval. That value controls how often the scheduler checks for work.

The rotation reminder interval controls whether a specific alert is due for a reminder.

These are different settings:

scheduler interval       -> how often the scheduler wakes up
rotation reminder interval -> how often alerts assigned by that rotation receive reminders

When reminders stop#

Reminders stop when the alert is:

  • acknowledged;
  • resolved;
  • silenced;
  • no longer firing;
  • assigned through a rotation with reminder interval 0.

Escalation after reminders#

Team setting Escalate after reminders controls how many reminders are sent before the alert is escalated to the next on-call user.

Example:

reminder_interval_seconds = 300
escalation_after_reminders = 2

The alert is escalated after two reminder messages if it is still unacknowledged.

If reminders are disabled with 0, reminder-based escalation will not progress for alerts using that rotation.