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 läuft bald ab. Es ist der flexibelste Kanal, alles, was einen eingehenden JSON-Webhook akzeptiert, kann ihn verarbeiten.
Aufbau des Payloads
Jede Warnung wird als einzelnes JSON-Objekt geliefert:
{"source": "loadfocus","event": "check.failed","check": { "id": "...", "name": "...", "url": "..." },"status": "failed","location": "...","timestamp": "..."}
Die Felder event und status sagen Ihnen, was passiert ist (zum Beispiel check.failed, check.recovered), sodass Ihr Endpunkt darauf verzweigen, einen Vorfall öffnen oder auflösen, in einen Chat posten oder das Ereignis speichern kann.
Den Kanal in LoadFocus hinzufügen
- Gehen Sie zur Seite Warnungskanäle.
- Klicken Sie auf New Alert Channel und wählen Sie Webhook aus der Kanalliste.
- Füllen Sie die beiden Felder aus:
- einen Namen, um den Kanal später wiederzuerkennen
- die Endpunkt-URL, die den POST empfängt (muss mit
https://beginnen)
- Klicken Sie auf Save Configuration.
Gleich nachdem der Kanal erstellt wurde, sendet LoadFocus einen einmaligen Bestätigungs-POST an ihn, sodass Sie überprüfen können, dass Ihr Endpunkt den Payload empfängt und parst, ohne einen echten Vorfall auszulösen.
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)
- 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 und dass Ihr Endpunkt einen2xx-Status zurückgibt. - Geben Sie schnell eine Antwort zurück (in weniger als ein paar Sekunden), damit die Zustellung nicht als Timeout gewertet wird.
- Teammitglieder mit einer Nur-Ansicht-Rolle können Kanäle sehen, aber keine erstellen oder löschen.