Monitoring
Diese Seite beschreibt, wie COD Ihre vorhandene Zabbix-Instanz anbindet, was Sie dafür in Zabbix und COD einrichten und wo die Grenzen liegen.
Was das Modul leistet, steht auf der Modulseite.
Stand: November 2026, COD 3.8.6
Inhalt der Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Überblick
| Merkmal | Wert |
|---|---|
| Zweck | Sicht auf eine vorhandene Zabbix-Instanz: Dashboard, Hosts, Templates, Problems, Unlinked Assets. Probleme quittieren, Hosts aus dem Asset anlegen und ändern |
| Zabbix | bringen Sie mit. Zabbix gehört nicht zur Lieferung von COD |
| Verbindung und Richtung | COD-Server zur Zabbix-API über die eingetragene API-URL. Die Geräte fragt Zabbix oder ein Zabbix-Proxy ab, nicht COD |
| Zugangsdaten | API-URL und API-Token je Standort, optional ein Filter auf Host-Gruppen |
| Alarmierung | bleibt bei Zabbix. COD alarmiert nicht |
| Freigaben | Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt. |
Voraussetzungen
In Zabbix
| Anforderung | Warum |
|---|---|
| API-Token mit Schreibrecht nur auf die eigenen Server-Gruppen | Hostanlage und Quittieren. Weitere Rechte braucht COD nicht |
| Host-Gruppen in Zabbix angelegt | COD legt keine Host-Gruppen an |
| Hostname in Zabbix gleich Asset-Name in COD | Der Abgleich vergleicht ganze Namen |
| API-URL vom COD-Server erreichbar, empfohlen über HTTPS | Alle Abfragen kommen vom COD-Server |
Empfehlung: Ein Zabbix-Proxy je Standort hat sich in der Praxis bewährt. Er fragt die Geräte vor Ort ab.
In COD
- Modul Monitoring am Mandanten freigeschaltet.
- Einstellung „Monitoring Config“ je Standort: API-URL, API-Token, optional Host-Gruppen.
- Asset-Namen nach dem Namensschema. Siehe Namen und Adressen.
Einrichtung
- Legen Sie in Zabbix die Host-Gruppen für den Standort an.
- Legen Sie in Zabbix einen Benutzer für COD an und erzeugen Sie einen API-Token. Geben Sie dem Benutzer Schreibrecht nur auf diese Host-Gruppen.
- Schalten Sie das Modul mit dem Manager-Konto unter „Admin Area > Tenant > Modules“ frei. Melden Sie sich danach ab und wieder an.
- Tragen Sie in „Monitoring Config“ des Standorts API-URL und API-Token ein.
- Wählen Sie die Host-Gruppen, die der Standort sehen soll.
- Prüfen Sie die Liste „Unlinked Assets“. Sie nennt Assets ohne Zabbix-Host.
- Legen Sie fehlende Hosts aus dem Asset an: Tab „Monitoring“ am Asset, mit Hostname, Templates, Host-Gruppen und Interface.
Technische Details
| Merkmal | Wert |
|---|---|
| Schnittstelle | Zabbix-API (JSON-RPC) über die eingetragene API-URL |
| Abgleich | nächtlich. COD verknüpft Assets und Zabbix-Hosts über den ganzen Namen |
| Filter | je Standort über Zabbix-Host-Gruppen, Auswahl per Multiselect |
| Hostanlage aus dem Asset | Interface Zabbix-Agent oder SNMP v2c. Adresse per IP oder DNS |
| SNMP v2c bei der Hostanlage | Community ab Werk als Makro {$SNMP_COMMUNITY}, Bulk an, Max repetitions 10 |
| Überwacht von | „Monitored by“: Server, Proxy oder Proxy-Gruppe |
| Quittieren | aus COD. COD hängt den quittierenden Benutzer serverseitig an den Kommentar |
| Monitoring am Asset ausschalten | COD entfernt nur die eigene Verknüpfung. Der Host bleibt in Zabbix |
| Asset | Der Tab „References“ zeigt den Zabbix-Host neben Firewall, Voucher und Aufgaben |
Was COD nicht tut
- COD erkennt keine Probleme und alarmiert nicht. Trigger, Schwellwerte und Alarmierung bleiben in Zabbix.
- COD löscht nie Zabbix-Hosts. Löschen ist der Oberfläche von Zabbix vorbehalten.
- Die Erreichbarkeitsprüfung der Firewalls gehört zum Modul Firewall, nicht zu Monitoring.
Bekannte Grenzen
| Grenze | Was Sie tun können |
|---|---|
| COD alarmiert nicht selbst | Richten Sie Alarme in Zabbix ein |
| COD löscht nie Zabbix-Hosts | Löschen Sie Hosts in Zabbix |
| Benennen Sie einen Host in Zabbix um, löst sich die Verknüpfung beim nächtlichen Abgleich | Ändern Sie Namen in COD und Zabbix zugleich |
| Die Zuordnung braucht exakt gleiche Namen | Ein Name für jedes Gerät in allen Systemen |
| Hostanlage aus dem Asset nur mit Zabbix-Agent oder SNMP v2c | Andere Interfaces legen Sie in Zabbix an |
| COD legt keine Host-Gruppen an | Legen Sie die Gruppen in Zabbix an |
| Der Host-Gruppen-Filter gilt nicht für Vorlagen und Proxy-Listen | Benennen Sie Vorlagen und Proxys so, dass die Zuordnung erkennbar ist |
| Zabbix gehört nicht zur Lieferung | Betreiben Sie eine eigene Zabbix-Instanz |
Weiterführend
- Modulseite Monitoring
- Was Ihr Netz für Monitoring braucht
- Namen und Adressen
- Firewall: Erreichbarkeitsprüfung
- Fehlerbilder
- Fragen zu den Modulen
- Support: Zuerst hilft Ihr Partner. Technische Rückfragen an extocode stellen Sie über das Helpdesk-Formular.