Webhook-Warnungen

Was der Webhook-Kanal macht

Ein Webhook-Benachrichtigungskanal sendet einen HTTP-POST mit einem JSON-Body an eine von Ihnen kontrollierte URL, sobald sich der Zustand eines Ihrer Monitore ändert: eine Prüfung schlägt fehl, erholt sich wieder, läuft beeinträchtigt oder ein SSL-Zertifikat bald abläuft. Es ist der flexibelste Kanal: Alles, was einen eingehenden JSON-Webhook akzeptiert, kann ihn nutzen.

Aufbau des Payloads

Jede Warnung wird als einzelnes JSON-Objekt geliefert:

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

Das Feld event ist einer der Werte check.failed, check.degraded, check.recovered, ssl.expiry, domain.expiry, sla.breach, sla.recovered oder test. Bei Prüfungs-Ereignissen ist status entweder failed, degraded oder passed (eine Wiederherstellung ist passed). Manche Ereignisse enthalten zusätzlich ein Objekt details, und nicht zutreffende Felder, etwa status bei einem SSL-Ablauf, sind null. Ihr Endpunkt kann anhand dieser Felder einen Vorfall öffnen oder auflösen, in einen Chat posten oder das Ereignis speichern. Es gibt kein Feld für eigene Header oder ein Signatur-Secret, halten Sie Ihre Endpunkt-URL daher privat.

Den Kanal in LoadFocus hinzufügen

1. Gehen Sie zur Seite Warnungskanäle.
2. Klicken Sie auf Neuer Alarmkanal und wählen Sie Webhook als Kanaltyp.
3. Füllen Sie die beiden Felder aus:
   • ein Name, um den Kanal später wiederzuerkennen
   • die Webhook-URL, die den POST empfängt (muss mit https:// beginnen)
4. Klicken Sie auf Kanal speichern.

Gleich nachdem der Kanal erstellt wurde, sendet LoadFocus einen einmaligen Bestätigungs-POST an ihn (Ereignis test), sodass Sie überprüfen können, dass Ihr Endpunkt den Payload empfängt und parst, ohne einen echten Vorfall auszulösen. Klicken Sie in der Zeile des Kanals auf Test, um ihn erneut zu senden.

Funktioniert mit jedem JSON-Webhook

Derselbe Kanal bedient viele Ziele:

• Eingehende Integrationen von PagerDuty und Opsgenie (oder verwenden Sie die dedizierten Kanäle PagerDuty und Opsgenie für natives Erstellen und automatisches Auflösen von Vorfällen; diese beiden sind nur in kostenpflichtigen Tarifen verfügbar, der Webhook-Kanal ist in jedem Tarif enthalten)
• Automatisierungstools wie Zapier und n8n
• Ihren eigenen Dienst, um bei jedem Ereignis eigene Logik auszuführen

An Ihre Prüfungen anhängen

Das Erstellen des Kanals macht ihn für Ihr gesamtes Team verfügbar. Um die Warnungen eines bestimmten Monitors an Ihren Endpunkt zu leiten, wählen Sie den Kanal in den Benachrichtigungseinstellungen der Prüfung aus, siehe Benachrichtigungskanäle bei einer Prüfung. Benachrichtigungskanäle werden über alle LoadFocus-Dienste hinweg geteilt, sodass Lasttest- und Page-Speed-Warnungen an denselben Endpunkt posten können.

Fehlerbehebung

• Kein Bestätigungs-POST angekommen: Bestätigen Sie, dass die URL mit https:// beginnt und aus dem öffentlichen Internet erreichbar ist (private und interne Adressen werden blockiert) und dass Ihr Endpunkt einen 2xx-Status zurückgibt. Weiterleitungen werden nicht verfolgt, verwenden Sie daher die endgültige URL.
• Antworten Sie innerhalb von 10 Sekunden, sonst wird die Zustellung als Timeout gewertet.
• Teammitglieder mit einer Nur-Ansicht-Rolle können Kanäle sehen, aber keine erstellen oder löschen.