Zabbix-Integration

Diese Anleitung beschreibt, wie Sie Ihre Zabbix 5.4-Installation mit Zammad unter Verwendung der Zabbix-Webhook-Funktion integrieren. Sie enthält Anweisungen zum Einrichten eines Medientyps, eines Benutzers und einer Aktion in Zabbix.

Anforderungen

  • Zammad mit aktivierter HTTP-Token-Authentifizierung

  • Zabbix Version 5.4 oder höher

Einrichten von Zammad

  1. Aktivieren Sie API Token Zugriff unter Einstellungen > System > API.

  2. Erstellen Sie einen neuen Benutzer für eine Zabbix-Benachrichtigung mit einer E-Mail-Adresse und erstellen Sie ein persönliches Benutzertoken mit ticket.agent-Berechtigungen.

Zabbix Webhook-Konfiguration

Ein globales Makro erstellen

  1. Bevor Sie den Webhook einrichten, müssen Sie das globale Makro {$ZABBIX.URL} einrichten, das die URL zum Zabbix-Frontend enthalten muss.

  2. Importieren Sie im Bereich Administration > Media types das Template.

  1. Öffnen Sie den hinzugefügten Medientyp Zammad und stellen Sie ein:

    • zammad_access_token zu Ihrem Personal User Token

    • zammad_url zur frontend URL Ihrer Zammad-Installation

    • zammad_customer zu Ihrer Zammad-Benutzer-E-Mail.

    • zammad_enable_tags auf true oder false, um Trigger-Tags zu aktivieren oder zu deaktivieren. Wichtig: Wenn Sie die Tag-Unterstützung aktivieren, wird jedes Tag mit einer separaten Anfrage gesetzt.

  2. Wenn Sie Probleme in Zabbix nach Schweregrad priorisieren möchten, können Sie Zuordnungsparameter definieren:

    • severity_<name>: Zammad priority ID

  3. Klicken Sie auf die Schaltfläche Aktualisieren, um die Webhook-Einstellungen zu speichern.

  4. Um Benachrichtigungen in Zammad zu erhalten, müssen Sie einen Zabbix-Benutzer anlegen und Medien mit dem Typ Zammad hinzufügen.

    Für Send to: Geben Sie einen beliebigen Text ein, da dieser Wert nicht verwendet wird, aber erforderlich ist.

Weitere Informationen finden Sie in der Zabbix-Dokumentation.