Webhook-Kanal
Webhook-Benachrichtigungskanal
Abschnitt betitelt „Webhook-Benachrichtigungskanal“Mit dem Webhook-Kanal sendet LoadFocus einen HTTP POST mit JSON-Body an eine beliebige URL, sobald sich der Status einer überwachten Prüfung ändert. Es ist der flexibelste Kanal: alles, was eingehende JSON-Webhooks akzeptiert, etwa Zapier, n8n, Make oder Ihr eigener Dienst, kann LoadFocus-Benachrichtigungen empfangen. PagerDuty hat einen eigenen Kanal (kostenpflichtige Tarife), der das von PagerDuty erwartete Format sendet.
Webhook-Kanal anlegen
Abschnitt betitelt „Webhook-Kanal anlegen“- Öffnen Sie die Alarmkanäle und klicken Sie auf Neuer Alarmkanal.
- Wählen Sie Webhook.
- Vergeben Sie einen Namen (erscheint in der Kanalliste) und fügen Sie die HTTPS-URL ein, die den POST erhalten soll.
- Klicken Sie auf Kanal speichern, aktivieren Sie den Kanal an einer Prüfung und wählen Sie über die Routing-Schalter, welche Ereignisse er erhalten soll.
Wann LoadFocus Ihren Webhook aufruft
Abschnitt betitelt „Wann LoadFocus Ihren Webhook aufruft“LoadFocus sendet bei folgenden Ereignissen einen POST an Ihre URL:
| Ereignis | event-Wert |
Wann es ausgelöst wird |
|---|---|---|
| Check fehlgeschlagen | check.failed |
Eine Prüfung wechselt in den Fehlerzustand (Assertion, Fehler oder Timeout). |
| Check erholt | check.recovered |
Eine zuvor fehlgeschlagene Prüfung ist wieder erfolgreich. |
| Check degradiert | check.degraded |
Die Antwortzeit überschreitet den Degraded-Schwellwert, ohne fehlzuschlagen. |
| SSL-Ablauf | ssl.expiry |
14, 7 und 3 Tage vor Ablauf eines überwachten HTTPS-Zertifikats sowie am Ablauftag. |
| Domain-Ablauf | domain.expiry |
Die Registrierung einer überwachten Domain läuft bald ab. |
| SLA verletzt | sla.breach |
Der Verbrauch des SLO-Fehlerbudgets der Prüfung überschreitet den Wert Budget consumed %, den Sie unter Alert on breach auf der SLA-/SLO-Seite festgelegt haben. |
| SLA wiederhergestellt | sla.recovered |
Nach einem Verletzungsalarm sinkt der Verbrauch des Fehlerbudgets der Prüfung wieder unter den Wert Budget consumed %, den Sie festgelegt haben. |
| Test | test |
Sie klicken die Schaltfläche Test neben dem Kanal. |
Welche dieser Ereignisse einen Kanal erreichen, steuern die Schalter Fail / Recover / Degraded / SSL / Domain unter dem Kanal auf der Bearbeitungsseite der Prüfung. Standardmäßig sind alle aktiviert. Die SLA-Ereignisse haben keinen Schalter: Sie werden nur für Prüfungen gesendet, bei denen Alert on breach aktiviert ist. Das Ereignis test wird immer gesendet, wenn Sie auf Test klicken.
Payload
Abschnitt betitelt „Payload“Der POST-Body ist application/json und wird mit dem Header User-Agent: LoadFocus-Webhook/1.0 gesendet:
{ "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"}Feldreferenz:
- source: immer
loadfocus. Damit erkennen Sie den Absender. - event: eines von
check.failed,check.recovered,check.degraded,ssl.expiry,domain.expiry,sla.breach,sla.recovered,test. - check.id / check.name / check.url: der Monitor, der die Benachrichtigung ausgelöst hat (null bei einem
test-Ereignis). - status: der Prüfstatus zum Sendezeitpunkt (
failed,passed,degradedoder null bei SSL-, Domain- und Test-Ereignissen). - location: die Region, aus der die Prüfung lief (null bei SSL-, Domain-, SLA- und Test-Ereignissen).
- timestamp: ISO-8601-UTC-Zeit des Ereignisses.
SSL-Ablauf-Ereignisse ergänzen ein details-Objekt, Domain-Ablauf-Ereignisse eines mit domain, daysRemaining, expiresAt und source, und ein test-Ereignis hat einen Text details.message. SLA-Ereignisse ergänzen ein details-Objekt mit slaTarget, slaWindow, consumedPct, remainingMs und state (breached oder recovered). Das SSL-Beispiel:
{ "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" }}Sicherheit und Voraussetzungen
Abschnitt betitelt „Sicherheit und Voraussetzungen“- Nur HTTPS. Webhook-URLs müssen mit
https://beginnen. Reinehttp-URLs werden abgelehnt. - Private Adressen werden blockiert. Zum Schutz vor Server-Side Request Forgery löst LoadFocus Ihren Hostnamen auf und ruft keine privaten, Loopback-, Link-local- oder CGNAT-Adressen auf (z. B.
10.0.0.0/8,127.0.0.1,169.254.0.0/16,192.168.0.0/16). Ihr Endpunkt muss öffentlich erreichbar sein. - Keine Weiterleitungen. LoadFocus folgt bei Webhook-Aufrufen keinen HTTP-Redirects, geben Sie die finale URL an.
- Timeout. Jeder Aufruf läuft nach 10 Sekunden ab. Es gibt keinen automatischen Retry, Ihr Empfänger sollte die Payload schnell annehmen und einreihen.
- Funktion prüfen. Senden Sie mit Test ein
test-Ereignis, bevor Sie sich auf den Kanal verlassen. Ein kostenloser Dienst wie webhook.site eignet sich, um die genaue Payload zu prüfen.
Integrationsbeispiele
Abschnitt betitelt „Integrationsbeispiele“- Zapier / Make / n8n: Starten Sie einen Workflow über einen "Catch Hook"- oder Webhook-Trigger und verzweigen Sie auf dem
event-Feld, um in den Chat zu posten, Tickets anzulegen oder eine Statusseite zu aktualisieren. - Eigener Dienst: Nehmen Sie den POST an, prüfen Sie
source === "loadfocus"und reagieren Sie aufevent. - PagerDuty: Nutzen Sie den eigenen Alarmkanal (kostenpflichtige Tarife), nicht den Webhook-Kanal.
Verwandt
Abschnitt betitelt „Verwandt“- Benachrichtigungskanäle: Überblick über alle Kanaltypen und das Ereignis-Routing pro Kanal.