Zabbix Anbindung

Generelle Informationen

Was ist die Zabbix Anbindung?

DocBee bietet Ihnen die Möglichkeit, Kunden-Objekte aus dem Monitoring-Tool Zabbix anzulegen und Vorgänge bei Alarmen zu produzieren.

Wann sollten Sie Zabbix Anbindung verwenden?

Falls Sie Zabbix als Monitoring-Tool verwenden.

Einrichtung

Um die Zabbix Anbindung zu aktiveren, müssen Sie unter Administration > Anbindung > Zabbix die Einstellungen bzw. Verknüpfungen vornehmen.

Einstellungen

Die Einstellungen definieren das generelle Verhalten der Zabbix Anbindung und ob diese überhaupt aktiviert ist.

Name	Beschreibung
Aktiviert	Definiert, ob die Zabbix Anbindung aktiv ist oder nicht
URL	Zabbix API URL. Zum Beispiel: https://ihredomain.com/api_jsonrpc.php
Alle Zertifikate erlauben	Definiert, ob alle Zertifikate (auch Self-Signed Zertifikate) erlaubt sind (Wir empfehlen das Hinterlegen von gültigen Zertifikaten und damit das Deaktivieren dieser Funktion)
Benutzername	Zabbix Benutzername
Passwort	Zabbix Passwort
Kunden-Objekte anlegen?	Falls Sie dies aktivieren, versucht DocBee automatisch Kunden-Objekte aus den Zabbix Daten anzulegen.
Objekt	Wählen Sie hier ein DocBee Objekt (Anlegbar unter Verwaltung > Objekte) aus, welches für Objekte aus Zabbix verwendet werden soll. Die Kategorie des Objektes muss Monitoring unterstützen.
Nicht automatisch änderbare Status	Ein Status, der hier ausgewählt ist, kann von Zabbix nicht geändert werden.
Webhook-URL	Dieser Link wird vom System generiert und als URL in den DocBee Media Type hinterlegt werden.
DocBee Media type	Download der Media Type Datei, die in Zabbix importiert werden muss damit, Zabbix Vorgänge in DocBee anlegen kann

Verknüpfung

Damit DocBee Kunden-Objekte für Sie anlegen kann, muss noch eine Verknüpfung zwischen den DocBee Kunden und den Zabbix Daten erstellt werden. Diese Verknüpfung machen Sie in DocBee im Untermenü Verknüpfungen. Hier können Sie via Sammelaktion den jeweiligen Zabbix-Daten DocBee Kunden / Standorte bzw. Kontakten zuweisen.

Hinweis: "Client" vererben den Kunden / Standort / Kontakt automatisch an die jeweiligen "Sites" und "Objects".
"Site" vererben den Kunden / Standort / Kontakt automatisch an "Objects"

Hinweis: Sie können auch Kunden-Objekte manuell anlegen und diese dann manuell mit Ihren Zabbix Assets verbinden.

Einrichtung in Zabbix

Damit in DocBee Vorgänge bzw. Aktualisierungen von Vorgängen vorgenommen werden können, muss in Zabbix ein sogenannter Media Type für DocBee hinterlegt werden. Diese Media Type können Sie direkt in den Einstellungen herunterladen und dann in Zabbix importieren.

Zum Einrichten gehen Sie bitte wie folgt vor:

1. Melden Sie sich bei Ihrem Zabbix System an
2. Öffnen Sie Media types ( Administration > Media types )
3. Klicken Sie auf die Schaltfläche Import ( Oben rechts )
4. Wählen Sie die DocBee Media Type Datei aus und drücken Import
5. Danach erscheint in der Liste der Media Type DocBee
6. Öffnen Sie den Media Type DocBee und hinterlegen Sie die gewünschten bzw. benötigten Werte (Siehe Tabelle )
7. Definieren Sie die Aktionen ( Configuration > Actions ), wann DocBee einen Vorgang anlegen oder aktualisieren soll

Zabbix Media Type Parameter

Name	Parameter muss existieren	Beschreibung
docbee_ack_status_id	Ja	Die DocBee ID eines Status, die gesetzt werden soll, falls das Zabbix Problem den Acknowledge Status bekommt. Der Wert des Parameters darf leer gelassen werden.
docbee_default_priority_id	Ja	Die DocBee ID der Standard Priorität, die ein Vorgang in DocBee bekommen soll. Der Wert des Parameters darf leer gelassen werden.
docbee_department_id	Ja	Die DocBee ID der Abteilung, die ein neuer Vorgang in DocBee bekommen soll. Der Wert des Parameters darf leer gelassen werden.
docbee_new_status_id	Ja	Die DocBee ID des Status, der bei einem neuen Vorgang aus Zabbix gesetzt werden soll. Der Parameter darf leer gelassen werden und verwendet damit den Standard DocBee-Status Offen.
docbee_owner_id	Ja	Die DocBee ID eines Benutzers oder einer Queue, die bei einem neuen Vorgang aus Zabbix gesetzt werden soll. Der Wert des Parameters darf leer gelassen werden.
docbee_resolve_status_id	Ja	Die DocBee ID eines Status, die gesetzt werden soll falls das Zabbix Problem als gelöst markiert wurde. Der Wert des Parameters darf leer gelassen werden.
docbee_ticket_category_id	Ja	Die DocBee ID der Vorgangs-Kategorie, die ein neuer Vorgang in DocBee bekommen soll. Der Wert des Parameters darf leer gelassen werden.
docbee_url	Ja	Die Webhook-URL aus den DocBee Zabbix Einstellungen z.B: https://my.docbee.com/zabbix/webhook/../
severity_information_priority_id	Nein	Fügen Sie diesen Parameter hinzu, um für severity information einen spezielle Priorität zusetzen. Hier setzen Sie wie bei default_default_priority_id eine DocBee Priorität ID.
severity_warning_priority_id	Nein	Fügen Sie diesen Parameter hinzu, um für severity warning eine spezielle Priorität zu setzen. Hier setzen Sie wie bei default_default_priority_id eine DocBee Priorität ID.
severity_average_priority_id	Nein	Fügen Sie diesen Parameter hinzu, um für severity average eine spezielle Priorität zu setzen. Hier setzen Sie wie bei default_default_priority_id eine DocBee Priorität ID.
severity_high_priority_id	Nein	Fügen Sie diesen Parameter hinzu, um für severity high eine spezielle Priorität zu setzen. Hier setzen Sie wie bei default_default_priority_id eine DocBee Priorität ID.
severity_disaster_priority_id	Nein	Fügen Sie diesen Parameter hinzu, um für severity disaster einen spezielle Priorität zusetzen. Hier setzen Sie wie bei default_default_priority_id eine DocBee Priorität ID.

Wichtig: Die weiteren Parameter, die nicht in der Tabelle aufgelistet wurden, dürfen nicht angepasst oder entfernt werden.

FAQ

Warum funktioniert meine Zabbix Anbindungen nicht?

Die Zabbix Anbindung benötigt mindestens die Version 6.4 von Zabbix und zusätzlich sollten Sie, falls Sie einen Reverse Proxy verwenden, überprüfen ob dieser den Authorization Header erlaubt.

Wie häufig findet eine Daten-Synchronisation statt?

Aktuell werden Daten aus Zabbix einmal pro Stunde aktualisiert.

Warum legt DocBee keine Vorgänge an?

Um das Problem zu lösen, prüfen Sie bitte folgende Schritte

1. Haben Sie den Media Type in Zabbix hinterlegt?
2. Wurde der Media Type richtig konfiguriert?
3. Haben Sie eine Aktion in Zabbix hinterlegt?
4. Prüfen Sie, ob im Fehlerprotokoll ein Zabbix Fehler vorliegt.

Kann ich die Nachrichten, die in DocBee erzeugt werden, ändern?

Ja, Sie können die Nachrichten in Zabbix im DocBee Media Type ändern.

Zum Ändern der Nachrichten öffnen Sie den Media Type und klicken dann auf Message templates und ändern dort die gewünschte Vorlage.

Wie finde ich die DocBee Status ID heraus?

Zum Herausfinden der Status ID können Sie in DocBee den gewünschten Status in der Administration öffnen und dort die ID aus der Browser Adresszeile kopieren https://www.ihredocbeedomain.com/status/edit/<STATUS_ID>.

Wie finde ich die DocBee Priorität ID heraus?

Zum Herausfinden der Priorität ID können Sie in DocBee die gewünschte Priorität in der Administration öffnen und dort die ID aus der Browser Adresszeile kopieren https://www.ihredocbeedomain.com/priority/edit/<PRIORITY_ID>.

Wie finde ich die DocBee Vorgangs-Kategorie ID heraus?

Zum Herausfinden der Priorität ID können Sie in DocBee die gewünschte Priorität in der Administration öffnen und dort die ID aus der Browser Adresszeile kopieren https://www.ihredocbeedomain.com/ticketCategory/edit/<CATEGORY_ID>.

Wie finde ich die DocBee Abteilung ID heraus?

Zum Herausfinden der Abteilung ID können Sie in DocBee die gewünschte Abteilung in der Administration öffnen und dort die ID aus der Browser Adresszeile kopieren https://www.ihredocbeedomain.com/department/edit/<ABTEILUNG_ID>.

Wie finde ich die DocBee Benutzer ID heraus?

Zum Herausfinden der Benutzer ID können Sie in DocBee den gewünschten Benutzer in der Verwaltung öffnen und dort die ID aus der Browser Adresszeile kopieren https://www.ihredocbeedomain.com/user/edit/<BENUTZER_ID>.

Wie finde ich die DocBee Queue ID heraus?

Zum Herausfinden der Queue ID können Sie in DocBee die gewünschten Queue in der Verwaltung öffnen und dort die ID aus der Browser Adresszeile kopieren https://www.ihredocbeedomain.com/queue/edit/<QUEUE_ID>.

Welche Zabbix Daten werden für das DocBee Kunden-Objekt verwendet?

Zabbix-Feld	DocBee-Feld
host	Erweiterter Name
inventory.serialno_a	Nummer
description	Details
interfaces.ip	IP Adresse
inventory.os	Betriebssystem
inventory.macaddress_a	MAC-Adresse 1
inventory.macaddress_b	MAC-Adresse 2
inventory.chassis	Bauform

Warum haben meine Vorgänge aus Zabbix keine Kunden-Zuordnung?

Vorgänge aus Zabbix bekommen in DocBee nur die Zuordnung, falls bereits ein mit Zabbix verknüpftes Kunden-Objekt existiert.