Alertes Webhook

Ce que fait le canal webhook

Un canal d'alerte webhook envoie un POST HTTP avec un corps JSON vers une URL que vous contrôlez chaque fois qu'un de vos moniteurs change d'état : une vérification échoue, se rétablit, s'exécute en mode dégradé, ou un certificat SSL est sur le point d'expirer. C'est le canal le plus flexible, tout ce qui accepte un webhook JSON entrant peut le consommer.

Forme du payload

Chaque alerte est livrée sous la forme d'un unique objet JSON :

{
  "source": "loadfocus",
  "event": "check.failed",
  "check": { "id": "...", "name": "...", "url": "..." },
  "status": "failed",
  "location": "...",
  "timestamp": "..."
}

Les champs event et status vous indiquent ce qui s'est passé (par exemple check.failed, check.recovered), afin que votre endpoint puisse s'y adapter, ouvrir ou résoudre un incident, publier dans un chat, ou stocker l'évènement.

Ajouter le canal dans LoadFocus

1. Rendez-vous sur la page Alert Channels.
2. Cliquez sur New Alert Channel et choisissez Webhook dans la liste des canaux.
3. Renseignez les deux champs :
   • un nom pour reconnaître le canal plus tard
   • l'URL de l'endpoint qui recevra le POST (doit commencer par https://)
4. Cliquez sur Save Configuration.

Juste après la création du canal, LoadFocus lui envoie un POST de confirmation ponctuel, afin que vous puissiez vérifier que votre endpoint reçoit et analyse le payload sans déclencher un véritable incident.

Fonctionne avec tout webhook JSON

Le même canal pilote de nombreuses destinations :

• les intégrations entrantes PagerDuty et Opsgenie (ou utilisez les canaux dédiés PagerDuty et Opsgenie pour la création et la résolution automatique d'incidents natives)
• des outils d'automatisation comme Zapier et n8n
• votre propre service, pour exécuter une logique personnalisée à chaque évènement

Attacher le canal à vos vérifications

Créer le canal le rend disponible pour toute votre équipe. Pour router les alertes d'un moniteur spécifique vers votre endpoint, sélectionnez le canal dans les paramètres de notification de la vérification, voir Canaux d'alerte d'une vérification. Les canaux d'alerte sont partagés entre les services LoadFocus, si bien que les alertes de tests de charge et de performance des pages peuvent publier vers le même endpoint.

Dépannage

• Aucun POST de confirmation n'est arrivé : confirmez que l'URL commence par https:// et qu'elle est accessible depuis l'internet public, et que votre endpoint renvoie un statut 2xx.
• Renvoyez une réponse rapidement (en moins de quelques secondes) afin que la livraison ne soit pas considérée comme un timeout.
• Les membres de l'équipe avec un rôle en lecture seule peuvent voir les canaux mais ne peuvent ni en créer ni en supprimer.