Network Topology for Zabbix 5.1.0 – raus aus der Beta.

Vor gut einem Monat habe ich Network Topology for Zabbix als öffentliche Beta veröffentlicht. Seitdem kam einiges an Feedback zurück – vor allem zu einem Punkt, der mich selbst am meisten gestört hat. Mit Version 5.1.0 ist er erledigt, und das Modul verlässt die Beta.

Layouts liegen jetzt auf dem Server #

Bisher lagen manuell gezogene Verbindungen und verschobene Knoten im localStorage des Browsers. Praktisch heißt das: Der Kollege sieht die Karte anders als man selbst, und nach einem geleerten Browser-Cache ist die halbe Stunde Aufräumarbeit weg.

Ab 5.1.0 liegt beides serverseitig, in zwei Ebenen:

• eine gemeinsame Ebene, die alle Nutzer sehen – der abgestimmte Stand der Karte
• eine persönliche Ebene pro Nutzer, für die eigenen Anpassungen darüber

Speichern zwei Leute gleichzeitig, wird nichts stillschweigend überschrieben: Das Modul vergleicht einen Revisions-Hash und meldet den Konflikt, statt die fremde Änderung zu verschlucken.

KPI-Zeile direkt über der Karte #

Über der Topologie steht jetzt eine Zeile mit den wichtigsten Kennzahlen – Hosts, Status-Verteilung (OK / Warning / Critical), Anzahl der Verbindungen und Ghost-Nodes. Der Blick, für den man vorher ins Dashboard wechseln musste, ist damit direkt da, wo man ohnehin hinschaut.

Zwei neue Dashboard-Widgets #

Damit sind es fünf:

Die Widgets brauchen Zabbix 7.4 – die Karte selbst läuft auch unter 7.0 LTS.

Der Item-Pivot ist dabei der Teil, den ich selbst am häufigsten benutze: ein Pattern wie vfs.fs.size[*,pused] über eine ganze Hostgruppe, als eine Tabelle mit Heatmap, Perzentilen und CSV-Export.

LLDP-Qualitäts-Tab #

Der Punkt, an dem in der Praxis die meiste Zeit verloren geht: Warum taucht dieser eine Switch nicht in der Karte auf? Der neue Tab LLDP-Q zeigt pro meldendem Gerät, wie viele Nachbarn sauber aufgelöst wurden – und bei den übrigen den Grund. Statt zu raten, sieht man, welcher Reporter schlechte Daten liefert.

Dazu passend: Der Gerätetyp wird nicht mehr über gepflegte Hersteller-Listen erraten, sondern aus den Capabilities nach IEEE 802.1AB abgeleitet, mit zusätzlicher Erkennung der Modellreihe. Das trifft auch bei Herstellern, an die ich beim Schreiben der Liste nie gedacht hätte.

Kleinigkeiten, die im Alltag zählen #

• Host aus Ghost-Node anlegen: Ein per LLDP entdecktes, aber in Zabbix unbekanntes Gerät lässt sich per Rechtsklick direkt als Host anlegen.
• Service-Probe per Klick: elf gängige Ports werden auf Wunsch direkt aus der Karte heraus geprüft.
• nt-uninstall.sh: ein sauberes Deinstallations-Skript, das auch dokumentiert, welche Daten serverseitig zurückbleiben.

Upgrade – bitte einmal kurz lesen #

Von der Beta (4.38.x / _v6): Das Entwicklungs-Suffix _v6 ist weg. Vor dem Update die alten Verzeichnisse entfernen, sonst registriert Zabbix das Modul doppelt:

sudo rm -rf /usr/share/zabbix/ui/modules/network_topology_v6

Entpackt wird dann nach ui/modules/network_topology. Weil sich die Widget-IDs geändert haben, müssen die Dashboard-Kacheln neu hinzugefügt werden – alternativ liegt ein SQL-Skript bei, das die IDs in der Datenbank umschreibt.

Von 5.0 auf 5.1: einmal Administration → General → Modules → „Scan directory" ausführen. Damit werden die drei neuen Actions (network.topology.links, .positions, .portscan) registriert. Ohne diesen Schritt laufen manuelle Links und gespeicherte Layouts in einen „Unknown action"-Fehler – der häufigste Stolperstein beim Update.

Läuft wo? #

• Zabbix 7.0 LTS und 7.4, PHP 8.x (Widgets nur unter 7.4)
• Dashboard-Dateien für Zabbix 8.0 sind bereits vorbereitet
• Lizenz: AGPL-3.0, keine Build-Tools nötig

Vollständiges Changelog und Download:

→ github.com/linuser/zabbix-network-topology · Release v5.1.0

Ausführliche Release-Notes und die Doku zu allen ZabFox-Modulen stehen auf zabfox.de. Wie die Karte technisch funktioniert – LLDP/CDP-Auswertung, Port-Weathermap, Ausfallsimulation – habe ich im Beitrag Network Topology für Zabbix beschrieben; der Rückblick auf die Beta steht hier.