Hoe we je informeren of waarschuwen
Een storing is alleen de moeite waard om te detecteren als we de juiste persoon kunnen informeren. We kunnen je informeren via kanalen die je team al gebruikt.
De kanalen
Elk kanaal krijgt hetzelfde bericht: welke monitor, sinds wanneer en waarom. Elk is een adres dat je één keer toevoegt en vervolgens benoemt in een regel.
-
Email Elk abonnement
Een bericht naar elk adres, één keer bevestigd voordat we het versturen, zodat een alert niet naar iemand anders' inbox kan worden gestuurd.
-
Webhook (POST) Elk abonnement
Een JSON-body met alle velden hieronder, naar een URL van jou. Voor je eigen automatisering: open een ticket, roep een dienst op, zet een statuslampje om.
-
Webhook (GET) Elk abonnement
Dezelfde velden als queryparameters, voor een ontvanger die alleen een GET kan verwerken.
-
PagerDuty Starter en hoger
Een incident via de Events API v2, geopend bij een storing en opgelost bij herstel, zodat PagerDuty's eigen escalatie het verder afhandelt. Een trage of verliesrijke check komt binnen als een waarschuwing, niet als kritiek.
-
Slack Pro en Business
Een bericht in een kanaal, rood voor down en groen voor weer up, via een webhook.
-
Microsoft Teams Pro en Business
Hetzelfde bericht in een Teams-kanaal, via een webhook.
-
Discord Pro en Business
Hetzelfde bericht in een Discord-kanaal, via een kanaal-webhook.
-
Telegram Pro en Business
Hetzelfde bericht in een chat, via je eigen bot.
Wie hoort wat, en wanneer
Eerst bevestigd
Niets wordt verstuurd op basis van één probe. Een fout wordt een storing wanneer probes op twee andere continenten het eens zijn, zodat een alert betekent dat de site down is en niet een netwerk ertussen.
Regels en escalatie
Een regel bepaalt wie hoort over welke monitors en hoe lang na het begin van de storing. Zet het on-call rooster in een contactgroep met een vertraging per lid, en één regel wordt een escalatie die stopt zodra de monitor herstelt.
Back-up, één keer gezegd
Iedereen die over de storing is geïnformeerd, hoort wanneer het eindigt en hoe lang het duurde. We maken je niet wakker om te zeggen dat de storing voorbij is.
Test voordat je het nodig hebt
Elke adres heeft een knop die een test stuurt via hetzelfde pad als een echte alert, geformuleerd zodat het niet kan worden verward met een echte storing.
De webhook, voor je eigen systemen
Een webhook-adres is een URL van jou. We roepen het aan wanneer een storing wordt bevestigd, wanneer het herstelt en wanneer je op test drukt. POST stuurt de velden als een JSON-body; GET stuurt ze als queryparameters. De URL wordt versleuteld opgeslagen en nooit meer volledig getoond, omdat iedereen die het heeft ernaar kan posten.
| Veld | Wat het bevat |
|---|---|
| reason | down wanneer een storing is bevestigd, recovery wanneer het eindigt, test wanneer iemand op de knop heeft gedrukt |
| monitor | De naam van de monitor |
| monitor_id | Zijn id, dezelfde als in zijn adres in het dashboard |
| target | Wat het controleert: de URL, host of naam |
| type | Het type check, als een korte naam zoals https, dns of ssl_cert |
| cause | Waarom het faalde, in een paar woorden, als we het weten |
| error_class | Hetzelfde als een korte naam waarop een programma kan vertakken, zoals timeout, connection of certificate_expired |
| started | Wanneer de storing begon, als een tijdstip met zijn zone |
| confirmed_at | Wanneer de storing werd bevestigd |
| confirmed_from | De continenten die het bevestigden, als een lijst van namen. Het was één naam tot september 2026 |
| degraded | true wanneer de monitor traag is of pakketten verliest in plaats van down |
| resolved | Wanneer het eindigde, als een ISO 8601-timestamp, bij een recovery |
| duration | Hoe lang het duurde, in woorden, bij een recovery |
| incident_id | De id van het incident, dezelfde bij de outage en de recovery |
Een veld zonder inhoud is null in de JSON en wordt weggelaten bij een GET. Antwoord met elke status onder 400. Alles daarboven telt als een mislukte levering en wordt opnieuw geprobeerd na 30 seconden, 2 minuten en 10 minuten, waarna het opgegeven wordt: een alert die niet binnen een kwartier aankomt is geschiedenis, geen nieuws.