Zabbix

Dieser Alarmeingang öffnet einen Endpunkt für eingehende Webhooks aus dem Monitoring-System Zabbix. Eingehende Zabbix-Ereignisse werden in FE2 als Störungsmeldungen verarbeitet. Der Eingang unterstützt zudem Rückmeldungen an Zabbix (z. B. Quittierung und Auflösung).

Konfiguration in FE2

Feld	Erläuterung	Pflichtfeld

Feld	Erläuterung	Pflichtfeld
Zabbix-URL	Basis-URL Ihrer Zabbix-Instanz. Wird für Rückmeldungen von FE2 an Zabbix verwendet.
Zabbix Shared Secret	Geheime Zeichenfolge zur Absicherung des Webhooks. Zabbix muss diesen Wert bei jedem Aufruf als Header `x-shared-secret` mitsenden.
Zabbix-Token	API-Token, mit dem FE2 Rückmeldungen (Quittierung/Auflösung) an Zabbix sendet.
Einheiten für Störungsmeldungen	Wählen Sie hier die Einheiten, die bei einem Zabbix-Ereignis alarmiert werden sollen.

Konfiguration in Zabbix

Richten Sie in Zabbix einen Webhook-Medientyp ein, der Ereignisse an FE2 sendet:

URL: Die vollständige URL zu Ihrem FE2-System mit dem Suffix /rest/zabbix/event.
Methode:POST, Inhaltstyp application/json.
Header: Fügen Sie den Header x-shared-secret mit dem im Alarmeingang hinterlegten Shared Secret hinzu.
Body: Übertragen Sie die Ereignisdaten als JSON. Ordnen Sie die Zabbix-Makros den unten genannten Feldern zu.
Wählen Sie aus, bei welchen Triggern/Ereignissen der Webhook ausgelöst werden soll.

FE2 erkennt anhand des Feldes event_status automatisch, ob es sich um ein neues Problem (PROBLEM) oder eine Auflösung (RESOLVED) handelt.

FE2 muss für diesen Alarmeingang vom Zabbix-Server via HTTP erreichbar sein!

Beispiel für einen Request-Body:

{
  "event_id": "12345",
  "event_status": "PROBLEM",
  "event_name": "Hohe CPU-Auslastung",
  "event_severity": "High",
  "host_name": "web-server-01",
  "subject": "Problem: Hohe CPU-Auslastung auf web-server-01",
  "message": "Die CPU-Auslastung liegt seit 5 Minuten über 90 %.",
  "event_opdata": "CPU: 95 %",
  "event_ack_status": "No",
  "event_date": "2026-06-02",
  "event_time": "14:32:05",
  "event_duration": "300"
}

Übertragene Daten

Die folgenden Felder werden im JSON-Body erwartet. Wird ein optionales Feld weggelassen, bleibt der zugehörige Alarmparameter einfach leer.

Feld	Beschreibung	Pflichtfeld

Feld	Beschreibung	Pflichtfeld
`event_id`	Eindeutige ID des Zabbix-Ereignisses
`event_status`	`PROBLEM` (neu/aktualisieren) oder `RESOLVED` (auflösen).
`subject`	Betreff / Kurzbeschreibung
`message`	Ausführliche Nachricht
`event_name`	Name des Ereignisses
`event_severity`	Schweregrad (siehe Zuordnung unten)
`host_name`	Betroffener Zabbix-Host
`event_ack_status`	`Yes`/`No` – ob das Ereignis in Zabbix quittiert wurde
`event_time` / `event_date`	Zeit und Datum des Ereignisses
`event_opdata`	Operative Zusatzdaten
`event_duration`	Dauer des Ereignisses

Es werden ausschließlich die oben aufgeführten Felder verarbeitet. Unbekannte oder zusätzliche Felder werden beim Empfang ignoriert und nicht in den Alarm übernommen. Ein Übermitteln eigener, frei definierter Felder ist über diesen Eingang nicht möglich.

Zuordnung des Schweregrads

Zabbix	FE2

Zabbix	FE2
Disaster	Disaster
High	Hoch
Warning	Warnung
Average	Niedrig
Information	Information

Rückmeldungen an Zabbix

Bei entsprechender Konfiguration meldet FE2 Statusänderungen zurück an Zabbix:

Quittierung einer Störungsmeldung → Quittierung des zugehörigen Zabbix-Ereignisses.
Auflösung / Statusänderung → Kommentar am Zabbix-Ereignis.

Ereignisse, die ihren Ursprung in Zabbix haben, werden nicht erneut an Zabbix zurückgemeldet (Schleifenschutz).

Hinweise zur Fehlerbehebung

HTTP 401: Der Header x-shared-secret fehlt oder ist leer. Prüfen Sie die Webhook-Konfiguration in Zabbix.
HTTP 429: Das Anfragelimit (100 Anfragen pro Minute) wurde überschritten. Reduzieren Sie die Auslösefrequenz.
Es werden keine Störungsmeldungen erzeugt: Prüfen Sie URL/Suffix, Shared Secret und ob FE2 erreichbar ist.