Skip to content

v5.1.0 — Network Topology for Zabbix

Choose a tag to compare

View all tags
@linuser linuser released this 31 Aug 10:56
· 15 commits to main since this release
v5.1.0
2dc14cd

Zwei Releases auf einmal: 5.0.0 hat den _v6-Suffix aus allen Bezeichnern entfernt, 5.1.0 bringt serverseitig gespeicherte Verbindungen und Kartenanordnung, eine Kennzahlen-Zeile, zwei weitere Dashboard-Widgets und einen LLDP-Qualitätstab. Wer von 4.38.3 kommt, liest bitte den Umstiegsabschnitt — das Modulverzeichnis heißt jetzt anders.

Two releases in one: 5.0.0 dropped the _v6 suffix from every identifier, 5.1.0 adds server-side manual links and node positions, a KPI row, two more dashboard widgets and an LLDP quality tab. Coming from 4.38.3? Read the upgrade section — the module directory has been renamed.

Neu in 5.1.0 / New in 5.1.0

  • Manuelle Verbindungen und Kartenanordnung serverseitig — mit geteilter Ebene für alle und persönlicher Abweichung je Benutzer, statt nur im localStorage. Gleichzeitiges Speichern überschreibt nichts mehr: der Client schickt die Revision mit, auf der seine Änderung beruht.
  • Kennzahlen-Zeile über der Karte — Hosts, OK/Warn/Crit, Kanten, Ghosts.
  • Zwei neue Widgets: NT KPI (Kennzahlen als Ring oder Kacheln) und NT Items (ein Item-Muster über alle Hosts).
  • LLDP-Q-Tab — zeigt je Reporter, wie viele Nachbarn aufgelöst werden konnten und woran der Rest scheitert.
  • Gerätetyp aus dem Protokoll statt aus einer Herstellerliste (IEEE 802.1AB), plus Modellreihen-Erkennung.
  • Dienste-Probe auf Klick, Deinstallations-Skript, CONTRIBUTING.md, SECURITY.md.

Vollständig: CHANGELOG.md

Voraussetzungen / Requirements
Hauptmodul / main module Zabbix 7.0 LTS oder 7.4, PHP 8.x
Dashboard-Widgets Zabbix 7.4 (auf 7.0 LTS bleiben sie auf „Loading…" — abweichende Widget-JS-Basisklasse)

Keine Build-Tools nötig — das JS-Bundle liegt fertig im Paket.
No build tools required — the JS bundle ships prebuilt.

Was ist was: network_topology.zip ist das Modul — eine eigene Seite unter
Monitoring → Network Topology, kein Dashboard-Widget. Die fünf *_widget.zip
sind optionale Kacheln für bestehende Dashboards; sie brauchen Zabbix 7.4
und das installierte und aktivierte Hauptmodul. Im Zweifel: nur die erste
Datei.

Which file is which: network_topology.zip is the module — a page of its own
under Monitoring → Network Topology, not a dashboard widget. The five
*_widget.zip are optional tiles for existing dashboards; they need Zabbix
7.4 and the main module installed and enabled. When in doubt, take only
the first file.

Installation

Das Verzeichnis muss network_topology heißen / the directory must be named network_topology:

cd /usr/share/zabbix/ui/modules
sudo unzip ~/Downloads/network_topology.zip
sudo systemctl reload php8.3-fpm       # RHEL: php-fpm

Dann Administration → General → Modules → Scan directory → Modul auf Enabled.

Alternativ nimmt nt-install.sh aus dem Repository die Arbeit ab (install, update, update --rollback, check) — es prüft die Umgebung, sichert die alte Version und räumt Altbestände weg.

Or use nt-install.sh from the repository (install, update, update --rollback, check) — it checks the environment, backs up the previous version and removes leftovers.

⚠️ Umstieg von 4.38.3 / Upgrading from 4.38.3

Der _v6-Suffix ist weg. Bleibt das alte Verzeichnis liegen, registriert Zabbix beide Module und der Menüeintrag erscheint doppelt:

cd /usr/share/zabbix/ui/modules
sudo rm -rf network_topology_v6 network_topology_v6_widget \
            network_topology_v6_health_widget network_topology_v6_table_widget

Die Widget-IDs haben sich mitgeändert, bestehende Dashboard-Kacheln müssen deshalb einmalig neu hinzugefügt werden. Wer das vermeiden will, findet im CHANGELOG unter „Optional: Dashboards per SQL erhalten" ein Skript, das die Bezeichner direkt in der Datenbank umschreibt.

The _v6 suffix is gone; remove the old directories or Zabbix registers both modules. Widget IDs changed too, so existing dashboard tiles need to be re-added — or rewrite the identifiers in the database, see the CHANGELOG.

Update von 5.0 auf 5.1 — „Scan directory" ist Pflicht

5.1 bringt drei neue Actions mit (network.topology.links, .positions, .portscan). Zabbix registriert Actions beim Scannen des Modulverzeichnisses, nicht beim Kopieren der Dateien. Ohne „Scan directory" lädt die Karte zwar — aber manuelle Verbindungen und die gespeicherte Knotenanordnung bleiben mit „Unknown action" stehen.

5.1 adds three actions. Without "Scan directory" the map still loads, but manual links and the saved node layout stop with "Unknown action".

Kartenanordnung und Verbindungen liegen serverseitig und überstehen das Update; Pins, Notizen und Presets liegen im localStorage des Browsers. Es gibt nichts zu migrieren.

Dashboard-Widgets (Zabbix 7.4)

ZIP Im Dashboard-Menü Zeigt
network_topology_widget.zip NT Topology die Karte als Kachel
network_topology_health_widget.zip NT Health Score Score je Hostgruppe
network_topology_table_widget.zip NT Table Nagios-Style Hostliste
network_topology_kpi_widget.zip NT KPI Kennzahlen als Ring oder Kacheln
network_topology_items_widget.zip NT Items ein Item-Muster über alle Hosts

Die Widget-ZIPs enthalten ihre Dateien direkt, ohne Oberordner — deshalb ist -d <ziel> zwingend:

for w in widget health_widget table_widget kpi_widget items_widget; do
    sudo unzip "/pfad/network_topology_$w.zip" -d "network_topology_$w"
done

LLDP/CDP

Kanten entstehen aus Zabbix-Items, nicht aus eigenem SNMP. Die offiziellen Vendor-Templates sammeln die Nachbartabelle nicht — dafür liegt ein Template im Repository, Einrichtung in LLDP-SETUP.md.

Edges come from Zabbix items, not from SNMP polling of our own. The official vendor templates do not collect the neighbour table — a template ships in the repository, see LLDP-SETUP.md.

Assets 8
Loading