Zum Inhalt springen

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.

  1. Öffnen Sie die Alarmkanäle und klicken Sie auf Neuer Alarmkanal.
  2. Wählen Sie Webhook.
  3. Vergeben Sie einen Namen (erscheint in der Kanalliste) und fügen Sie die HTTPS-URL ein, die den POST erhalten soll.
  4. 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.

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.

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, degraded oder 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" }
}
  • Nur HTTPS. Webhook-URLs müssen mit https:// beginnen. Reine http-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.
  • 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 auf event.
  • PagerDuty: Nutzen Sie den eigenen Alarmkanal (kostenpflichtige Tarife), nicht den Webhook-Kanal.