Webhook-Warnungen
Was der Webhook-Kanal macht
Abschnitt betitelt „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
Abschnitt betitelt „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
Abschnitt betitelt „Den Kanal in LoadFocus hinzufügen“- Gehen Sie zur Seite Warnungskanäle.
- Klicken Sie auf Neuer Alarmkanal und wählen Sie Webhook als Kanaltyp.
- 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)
- 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
Abschnitt betitelt „Funktioniert mit jedem JSON-Webhook“Derselbe Kanal bedient viele Ziele:
- Eingehende Integrationen von PagerDuty und Opsgenie (oder verwenden Sie den dedizierten Kanal PagerDuty für natives Erstellen und automatisches Auflösen von Vorfällen; er ist nur in kostenpflichtigen Tarifen verfügbar, der Webhook-Kanal ist in jedem Tarif enthalten. Neue Opsgenie-Kanäle können nicht mehr hinzugefügt werden)
- Automatisierungstools wie Zapier und n8n
- Ihren eigenen Dienst, um bei jedem Ereignis eigene Logik auszuführen
An Ihre Prüfungen anhängen
Abschnitt betitelt „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
Abschnitt betitelt „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 einen2xx-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.