Escalatiematrix - meer mensen waarschuwen

Doel: Een escalatiematrix instellen die na een bepaalde tijd van een onopgelost incident (storing) een melding stuurt naar verdere verantwoordelijke personen of naar een ander kanaal.

Wanneer escalatie gebruiken

Een veelvoorkomend scenario: uw dienst valt 's nachts uit, de primaire dienstdoende reageert niet binnen 15 minuten - het systeem moet automatisch de ploegleider waarschuwen en na nog een uur ook de manager. Escalatie voorkomt dat een storing onopgemerkt blijft.

Stap 1: Maak een escalatiebeleid aan

1. Ga naar Dashboard → Escalatie (of naar het adres /dashboard/escalation).
2. Vul een naam in (bijvoorbeeld "Nachtdienst") en klik op + Nieuw beleid.

Stap 2: Voeg stappen toe

Een beleid is een reeks stappen. Elke stap bevat:

• Vertraging (min) - na hoeveel minuten vanaf het begin van het incident de stap moet worden geactiveerd. 0 betekent onmiddellijk.
• Kanaal - E-mail of Webhook (Slack, Discord, uw eigen doel-endpoint).
• Ontvangers - door komma's gescheiden e-mailadressen, of een webhook-adres.
• Notitie - optioneel, wat de ontvanger moet doen.

Stap 3: Wijs het beleid toe aan monitors

U kunt een beleid toewijzen:

• Globaal - met de knop "Als standaard instellen" wordt het gebruikt voor al uw monitors die geen eigen beleid hebben.
• Voor een specifieke monitor - selecteer bij het aanmaken of bewerken van een monitor een concreet beleid.

Bevestiging van het incident (ACK)

Elke escalatiemelding bevat een ACK-link (acknowledge, oftewel "ik heb het gezien en ik handel het af"). U hoeft er alleen op te klikken en:

• De verdere escalatiestappen worden gestopt.
• In het systeem wordt opgeslagen wie en wanneer het incident heeft bevestigd.
• Anderen in dezelfde stap ontvangen geen verdere escalatieberichten meer voor dit incident.

De ACK-link vereist geen inloggen - hij is ondertekend met een uniek token (een eenmalige tekenreeks), zodat niemand anders er misbruik van kan maken. Nadat het incident is opgelost (de monitor keert terug naar de status UP) eindigt de escalatie ook automatisch.

Webhook-formaat

Voor Slack, Discord, Microsoft Teams en uw eigen endpoint sturen we het verzoek met de POST-methode. Bij Slack, Discord en Teams formatteren we de payload natief (Block Kit / Embed / Adaptive Card). Bij andere adressen (eigen endpoint) sturen we een generieke JSON:

{
  "event": "incident_escalation",
  "monitor": {
    "name": "Productiewebsite",
    "target": "https://example.com",
    "url": "https://epulz.io/dashboard/monitor/42"
  },
  "message": "ESCALATION step 2 (delay 15 min): e-mail naar de ploegleider",
  "timestamp": "2026-05-31T14:33:45+00:00",
  "source": "epulzio"
}

Het veld event heeft bij escalatie de waarde incident_escalation. In het veld message staat een tekstuele beschrijving van de stap (volgorde van de stap, vertraging en beschrijving van de actie). Andere velden (incident_id, step_order, ack_url) bestaan niet op het hoogste niveau - de ACK-link maakt deel uit van het opgemaakte bericht in Slack/Discord/Teams. Voor Slack volstaat het adres van de Incoming webhook. Bij een Discord-adres is de parameter ?wait=true niet nodig.

Veelgestelde vragen