Übergeben Sie Monitoring-Ereignisse an das zuständige System
Eine E-Mail kann Menschen auf eine Störung hinweisen. Ein Webhook übergibt das Ereignis zusätzlich an Ihren eigenen Empfänger. Dort kann es ein Ticket erstellen, einen internen Vorfallsdatensatz aktualisieren oder einen bewusst eingerichteten Ablauf starten.
MetriBeacon unterstützt HTTP-Webhook-Ziele mit JSON-Nachrichten und HMAC-SHA256-Signaturen. Diese Anleitung erklärt die Verbindung, die Prüfung einer Anfrage und den Umgang mit Zustellwiederholungen ohne doppelte Folgeaktionen. Ticketanlage und Weiterverarbeitung gehören zu Ihrer Integration; ein angelegtes Benachrichtigungsziel richtet sie nicht automatisch ein.
Was ist ein Monitoring-Webhook?
Ein Monitoring-Webhook ist eine HTTP-Anfrage, die bei einer fälligen konfigurierten Benachrichtigung gesendet wird. Ihr Empfänger nimmt das Ereignis an, prüft seine Echtheit und entscheidet über die Verarbeitung. Er ergänzt lesbare Kanäle wie E-Mail und Telegram.
Trennen Sie drei Ergebnisse: Die Monitoringregel erkennt eine Bedingung, MetriBeacon übergibt eine Benachrichtigung an das Ziel, und Ihr System führt seine Folgeaktion aus. Eine erfolgreiche Übergabe beweist weder ein erstelltes Ticket noch einen abgeschlossenen nachgelagerten Ablauf.
Ein beispielhafter Empfänger könnte für einen Website-Vorfall ein internes Ticket öffnen und die Entwarnung demselben Ticket zuordnen. Das ist ein Entwurfsbeispiel und kein eingebautes Versprechen über einen externen Ticketdienst.
Legen Sie das Webhook-Ziel in MetriBeacon an
Folgen Sie der Anleitung für Alarme und Benachrichtigungen. Bereiten Sie einen eigenen Empfänger unter einer erlaubten öffentlichen HTTPS-Adresse vor. Verwenden Sie die endgültige Adresse direkt; der Benachrichtigungsversand folgt keinen Weiterleitungen zu einem anderen Empfänger.
- Öffnen Sie Alarme → Benachrichtigungen und fügen Sie ein Ziel hinzu.
- Wählen Sie den HTTP-Webhook-Kanal und einen verständlichen Namen.
- Tragen Sie die öffentliche HTTPS-Adresse Ihres Empfängers ein.
- Ergänzen Sie optional einen Bearer-Token, falls Ihr Empfänger ihn verlangt.
- Erstellen Sie das Ziel und speichern Sie das erzeugte Signaturgeheimnis bei seiner Anzeige sicher.
- Hinterlegen Sie das Geheimnis beim Empfänger, senden Sie einen Test und prüfen Sie beide Seiten.
- Wählen Sie das Ziel in den Alarmregeln aus, die es verwenden sollen.
Das Signaturgeheimnis erscheint nur einmal. Es ist vom optionalen Bearer-Token getrennt: Der Token authentifiziert nach den Vorgaben Ihres Endpunkts; das erzeugte Geheimnis dient zur Prüfung des signierten Nachrichteninhalts. Beide sind außerdem von Ihren Schlüsseln für die Monitoring-Datenannahme getrennt.
Prüfen Sie beim Speichern einer Regel deren aktive Zielauswahl. Ein aktiver Endpunkt allein erklärt nicht, ob diese Regel ihn tatsächlich verwendet. Beginnen Sie mit einer Testregel, deren Ergebnis Sie klar nachvollziehen können.
Prüfen Sie die ursprünglichen Anfragebytes
MetriBeacon verschickt Webhook-Benachrichtigungen per HTTP POST mit Content-Type: application/json. Die Anfrage enthält diese Header:
| Header | Zweck |
|---|---|
X-MetriBeacon-Timestamp |
Signaturzeitpunkt als Unix-Sekunden |
X-MetriBeacon-Signature |
Präfix v1= und anschließend der HMAC-SHA256-Wert als kleingeschriebene Hexdarstellung |
X-MetriBeacon-Delivery |
Stabile Benachrichtigungskennung für die Erkennung doppelter Zustellungen |
Die Signatur wird so berechnet:
v1=hex(HMAC-SHA256(signing_secret, timestamp + "." + raw_body))
timestamp ist der Zeitstempeltext aus dem Header, raw_body sind die exakt empfangenen Bodybytes. Die Signatur umfasst Zeitstempel, einen wörtlichen Punkt und diese Bytes. Sie bezieht sich nicht auf JSON, das Ihr Framework bereits eingelesen und erneut serialisiert hat.
Erhalten Sie den ursprünglichen Body, bevor ein JSON-Parser ihn verändert. Leerzeichen, Maskierungen und Feldreihenfolge können die Bytes verändern, obwohl zwei JSON-Objekte dieselben Werte darstellen. Vergleichen Sie die Signatur in konstanter Zeit, validieren Sie den Zeitstempel und verwenden Sie ein festgelegtes Frischefenster, bevor Sie die Nachricht verarbeiten.
Signatur und Aktualität beantworten unterschiedliche Fragen. Eine aufgezeichnete, früher gültige Anfrage kann weiterhin eine passende Signatur besitzen. Der Empfänger muss deshalb auch veraltete Anfragen ablehnen und bereits angenommene Arbeit wiedererkennen. Halten Sie Signaturgeheimnisse und Autorisierungswerte aus Anfragelogs und öffentlichen Fehlermeldungen heraus.
Trennen Sie eine Benachrichtigung von ihren einzelnen Ereignissen
Die JSON-Benachrichtigung enthält schema_version, notification_id, type und ein Array entries. Die Einträge führen Vorfalls- und Ereigniskennungen sowie passende Regelinformationen. Eine Benachrichtigung kann mehrere Einträge enthalten. Verarbeiten Sie deshalb nicht nur das erste Arrayelement.
Verwenden Sie notification_id als stabile Identität einer Zustellung. Die incident_id eines Eintrags ordnet Aktualisierungen demselben Vorfall zu; event_id kennzeichnet ein einzelnes Ereignis. Diese Kennungen beantworten unterschiedliche Fragen. Verwenden Sie zur Duplikaterkennung notification_id aus dem signierten Body und prüfen Sie die Übereinstimmung mit X-MetriBeacon-Delivery; dieser Zustellheader selbst gehört nicht zu den signierten Bytes.
In der beispielhaften Ticketintegration darf eine doppelte Zustellung kein zweites Ticket erzeugen. Eine spätere Entwarnung besitzt eine eigene Benachrichtigungskennung, kann sich aber auf denselben Vorfall beziehen. Verwalten Sie diese Zuordnung in Ihrer Anwendung, statt jede Nachricht als neues Problem zu behandeln.
Prüfen Sie unterstützte Schemafassung und Ereignistyp vor der Feldverwendung. Eine Testnachricht belegt keinen tatsächlichen Monitorfehler. Webhook-Zeitpunkte bleiben in UTC; rechnen Sie sie für die Anzeige um, ohne ihre Bedeutung zu ändern.
Nehmen Sie dauerhaft an und verarbeiten Sie längere Aufgaben danach
Ein brauchbarer Empfänger authentifiziert und validiert zuerst die Anfrage. Anschließend speichert er Zustellkennung und beabsichtigte Arbeit gemeinsam dauerhaft, bevor er erfolgreich per HTTP antwortet. Ein Worker kann die langsamere Ticket- oder Ablaufaktion danach ausführen.
Das ist ein Entwurfsmuster für Ihren Empfänger und keine von MetriBeacon in Ihrer Anwendung installierte Warteschlange. Es verhindert die Bestätigung einer Nachricht, die nur im flüchtigen Prozessspeicher liegt. Erkennen Sie erneut zugestellte, bereits angenommene Nachrichten und führen Sie ihre Fachaktion nicht doppelt aus.
MetriBeacon wertet eine erfolgreiche 2xx-Webhook-Antwort als Übergabe an den Endpunkt. Es kann nicht sehen, ob Ihre eigene Warteschlange anschließend stehen bleibt. Überwachen Sie den Verarbeitungszustand getrennt, wenn dieses Ergebnis wichtig ist.
Ist die Verarbeitungsreihenfolge entscheidend, gleiche Aktualisierungen anhand der Vorfalls- und Ereignisinformationen ab. Verwenden Sie die Ankunftsreihenfolge nicht als einzige Grundlage des Vorfallszustands.
Rechnen Sie mit erneuter Zustellung
Eine Netzwerkverbindung kann abbrechen, nachdem Ihr Empfänger eine Benachrichtigung angenommen hat, aber bevor MetriBeacon die Antwort erhält. Ein späterer Versuch kann deshalb dieselbe Benachrichtigung erneut zustellen.
Wiederholungen verwenden einen frischen Signaturzeitstempel bei gleichbleibender Benachrichtigungskennung. Erkennen Sie Duplikate nicht anhand von Zeitstempel oder Signatur: Beide können sich zwischen Versuchen ändern. Speichern Sie angenommene Kennungen mit der zugehörigen Arbeit dauerhaft.
Vorübergehende Fehler können Wiederholungen mit zunehmendem Abstand auslösen. Dauerhafte Ziel- oder Konfigurationsfehler benötigen eine Korrektur. Lesen Sie das tatsächliche Ergebnis im Vorfalls- und Zustellverlauf, statt unbegrenzte Wiederholungen jedes Fehlers anzunehmen.
Alle Benachrichtigungskanäle teilen ihre Zustellkontingente. Ein Webhook umgeht weder Kontolimits noch Stummschaltung oder zutreffende Wartungseinstellungen. Verbrauchsübersicht und Zustellverlauf helfen, Regelprobleme von unterdrückten oder fehlgeschlagenen Übergaben zu unterscheiden.
Testen Sie die Verbindung als vollständigen Weg
Beginnen Sie mit einer folgenarmen Empfängeraktion, etwa einem internen Testdatensatz. Senden Sie den Zieltest von MetriBeacon und prüfen Sie Signatur, angenommene Kennung und nachgelagertes Ergebnis. Tests teilen kontoweit die Grenze von zehn Nachrichten je Stunde über alle Kanäle.
Testen Sie danach eine kontrollierte Bedingung an einem eigenen Testmonitor und prüfen Sie Störungsmeldung und Entwarnung. Verwenden Sie einen Website-Monitor, eine Jobregel oder einen Logalarm, passend zum benötigten Signal.
Ihre Empfängertests sollten auch veränderten Body, ungültige Signatur, veraltete Anfrage und doppelte gültige Zustellung abdecken. Bestätigen Sie, dass das Duplikat die beabsichtigte Aktion nicht wiederholt. Diese Prüfungen schützen unterschiedliche Teile der Integration.
Eine private Webhook-Integration und ein öffentliches Statusseitenabonnement sind getrennte Einrichtungen. Nutzen Sie eine ausdrücklich veröffentlichte Statusseite für geprüfte Dienstinformationen an Besucher. Leiten Sie private Alarmdaten nicht automatisch in öffentliche Meldungen weiter.
Häufige Fragen zu Monitoring-Webhooks
Ersetzt ein Webhook E-Mail- oder Telegram-Alarme?
Nein. Er ist ein weiteres Ziel für konfigurierte Regeln. Behalten Sie die menschlichen Benachrichtigungskanäle, die zu Ihrem Reaktionsablauf passen.
Ist der Bearer-Token das Signaturgeheimnis?
Nein. Optionaler Token und erzeugtes HMAC-Geheimnis erfüllen unterschiedliche Aufgaben. Konfigurieren und schützen Sie beide Werte getrennt, sofern Sie sie verwenden.
Kann dieselbe Benachrichtigung mehrfach ankommen?
Ja. Eine ungewisse Antwort kann einen weiteren Zustellversuch verursachen. Verwenden Sie die stabile Benachrichtigungskennung und dauerhafte Duplikaterkennung statt vorauszusetzen, dass jede Folgeaktion genau einmal ausgeführt wird.
Sind Webhook-Alarme mit MetriBeacon kostenlos?
MetriBeacon ist innerhalb seiner dokumentierten technischen Kontingente kostenlos. Zustellbudgets bleiben wirksam; externe Empfänger oder Automationsanbieter können eigene Kosten verursachen.
Beginnen Sie mit einem Empfänger und einer sinnvollen Aktion
Erstellen Sie ein kostenloses MetriBeacon-Konto, bereiten Sie eine geprüfte Empfängerimplementierung vor und verbinden Sie ein Webhook-Ziel. Testen Sie Authentifizierung, Duplikaterkennung und Folgeergebnis, bevor Sie weitere Regeln zuordnen. Die Website/API-Vorlage unter diesem Artikel erstellt einen ergänzenden HTTP-Monitor; den Webhook-Versand konfigurieren Sie separat unter Alarme → Benachrichtigungen.
