Canal Webhook
Canal d'alerte Webhook
Section intitulée « Canal d'alerte Webhook »Le canal webhook permet à LoadFocus d'envoyer une requête HTTP POST avec un corps JSON vers l'URL de votre choix lorsqu'une vérification surveillée change d'état. C'est le canal le plus flexible : tout ce qui accepte les webhooks JSON entrants, comme Zapier, n8n, Make ou votre propre service, peut recevoir les alertes LoadFocus. PagerDuty a son propre canal (forfaits payants) qui envoie le format attendu par PagerDuty.
Créer un canal webhook
Section intitulée « Créer un canal webhook »- Allez dans les Canaux d'alerte et cliquez sur Nouveau canal d'alerte.
- Choisissez Webhook.
- Donnez un nom (affiché dans la liste des canaux) et collez l'URL HTTPS qui recevra le POST.
- Cliquez sur Enregistrer le canal, activez le canal sur une vérification et choisissez les événements qu'il recevra avec les pastilles de routage par canal.
Quand LoadFocus appelle votre webhook
Section intitulée « Quand LoadFocus appelle votre webhook »LoadFocus envoie un POST à votre URL pour ces événements :
| Événement | valeur event |
Quand il se déclenche |
|---|---|---|
| Vérification échouée | check.failed |
Une vérification passe en échec (assertion, erreur ou timeout). |
| Vérification rétablie | check.recovered |
Une vérification précédemment en échec repasse au vert. |
| Vérification dégradée | check.degraded |
Le temps de réponse dépasse le seuil de dégradation sans échouer. |
| Expiration SSL | ssl.expiry |
14, 7 et 3 jours avant l'expiration d'un certificat HTTPS surveillé, et le jour de l'expiration. |
| Expiration de domaine | domain.expiry |
L'enregistrement d'un domaine surveillé est sur le point d'expirer. |
| SLA non respecté | sla.breach |
La consommation du budget d'erreur du SLO de la vérification dépasse le Budget consumed % défini sous Alert on breach sur la page SLA / SLO. |
| SLA rétabli | sla.recovered |
Après une alerte de non-respect, la consommation du budget d'erreur de la vérification repasse sous le Budget consumed % que vous avez défini. |
| Test | test |
Vous cliquez sur le bouton Test à côté du canal. |
Les pastilles Fail / Recover / Degraded / SSL / Domain sous le canal, sur la page d'édition de la vérification, déterminent lesquels de ces événements atteignent un canal. Tous sont activés par défaut. Les événements SLA n'ont pas de pastille : ils ne sont envoyés que pour les vérifications où Alert on breach est activé. L'événement test est toujours envoyé quand vous cliquez sur Test.
Le corps du POST est application/json, envoyé avec l'en-tête User-Agent: LoadFocus-Webhook/1.0 :
{ "source": "loadfocus", "event": "check.failed", "check": { "id": "75be9e45e858177eea4a18bbdc765472", "name": "Checkout API", "url": "https://api.example.com/checkout" }, "status": "failed", "location": "us-east-1", "timestamp": "2026-06-07T12:00:00.000Z"}Référence des champs :
- source : toujours
loadfocus. Utilisez-le pour reconnaître l'émetteur. - event : l'un de
check.failed,check.recovered,check.degraded,ssl.expiry,domain.expiry,sla.breach,sla.recovered,test. - check.id / check.name / check.url : le moniteur qui a déclenché l'alerte (null dans un événement
test). - status : le statut de la vérification à l'envoi (
failed,passed,degradedou null pour les événements SSL, domaine et test). - location : la région d'où la vérification a été exécutée (null pour les événements SSL, domaine, SLA et test).
- timestamp : heure ISO-8601 UTC de l'événement.
Les événements d'expiration SSL ajoutent un objet details, ceux d'expiration de domaine en ajoutent un avec domain, daysRemaining, expiresAt et source, et un événement test a un texte details.message. Les événements SLA ajoutent un objet details avec slaTarget, slaWindow, consumedPct, remainingMs et state (breached ou recovered). L'exemple SSL :
{ "source": "loadfocus", "event": "ssl.expiry", "check": { "id": "...", "name": "...", "url": "https://..." }, "status": null, "location": null, "timestamp": "2026-06-07T12:00:00.000Z", "details": { "daysRemaining": 7, "validTo": "Jun 14 23:59:59 2026 GMT" }}Sécurité et prérequis
Section intitulée « Sécurité et prérequis »- HTTPS uniquement. Les URLs de webhook doivent commencer par
https://. Les URLshttpsont rejetées. - Les adresses privées sont bloquées. Pour empêcher le server-side request forgery, LoadFocus résout votre nom d'hôte et n'appelle pas les adresses privées, loopback, link-local ou CGNAT (par exemple
10.0.0.0/8,127.0.0.1,169.254.0.0/16,192.168.0.0/16). Votre endpoint doit être accessible sur l'internet public. - Pas de redirections. LoadFocus ne suit pas les redirections HTTP sur les appels webhook, pointez donc le canal vers l'URL finale.
- Timeout. Chaque appel expire après 10 secondes. Il n'y a pas de relance automatique, votre récepteur doit donc accepter et mettre en file la payload rapidement.
- Vérifiez que ça marche. Utilisez le bouton Test pour envoyer un événement
testavant de compter sur le canal. Un service gratuit comme webhook.site permet d'inspecter la payload exacte.
Exemples d'intégration
Section intitulée « Exemples d'intégration »- Zapier / Make / n8n : démarrez un workflow via un trigger "Catch Hook" ou webhook et branchez sur le champ
eventpour publier dans un chat, créer des tickets ou mettre à jour une page de statut. - Votre propre service : acceptez le POST, vérifiez
source === "loadfocus"et agissez selonevent. - PagerDuty : utilisez son propre canal d'alerte (forfaits payants), pas le canal webhook.
Voir aussi
Section intitulée « Voir aussi »- Canaux d'alerte : vue d'ensemble de tous les types de canaux et du routage des événements par canal.