Link Health
os-linkhealth · Hardware des Geräts
Überwacht jeden physischen Port und benennt das Kabel oder den Transceiver, der schlecht wird, mit der Beschriftung auf dem Gehäuse.
Im Menü
- Mit installiertem os-xgs-npu: XGS: Link Health
- Ohne os-xgs-npu: Interfaces: Link Health

Das Urteil kommt aus der Änderung der Hardware-Fehlerzähler eines Ports über ein Zeitfenster, nie aus optischen Messwerten. Das Plugin entstand, nachdem eine 10G-Glasfaser 3,81 % der empfangenen Frames beschädigte, während der Link als aktiv galt und jeder Messwert des Transceivers normal war.
Ein Port ist down, disabled, idle, ok, watch, warn oder fail. Ein ruhiger Port bleibt idle – weder gut noch schlecht –, bis er genug Frames für ein Urteil getragen hat, und ein dunkler Port ist nie ein Alarm.
Ports tragen die auf dem Gehäuse gedruckten Namen. Auf einer Sophos XGS Appliance mit os-xgs-npu werden die Ports des Koprozessors und das eingesetzte Erweiterungsmodul beim Booten benannt. Die Tabelle umfasst 35 XGS-Boards und 14 FleXi-Module; XGS 3300, XGS 136 und XG 330 wurden Buchse für Buchse geprüft.
Funktionen
-
Urteil je Port
Fehlerhafte Frames pro Million im Fenster, ein Downshift unter die schnellste Geschwindigkeit, die der Port anbietet, Kollisionen auf einem Vollduplex-Link und Link-Flaps in einer Stunde.
-
Gezeichnete Front
Die Front der Appliance, aus ihrem Layout gezeichnet, jede Buchse in der Farbe ihres Urteils. Ein Layout, das niemand am Gerät geprüft hat, sagt das auf der Seite.
-
Identifizieren
Lässt die eigene LED einer Buchse blinken, standardmäßig 30 Sekunden, ohne den Link zu unterbrechen, damit sich Beschriftung und Schnittstellenname zuordnen lassen. Auf Sophos XGS Appliances blinkt sie über das eigene Werkzeug des Koprozessors.
-
Lasttest
Für einen Port, der zu ruhig für ein Urteil ist: begrenzter ICMP-Verkehr an einen Nachbarn, der bereits in der Bridge-Tabelle dieses Ports steht, danach der Vergleich der Zähler. Während er läuft, lastet er den Link aus.
-
Eine Mail
Warn und fail werden nach zwei Fenstern gemailt, einmal pro Port und Sperrfrist (standardmäßig 6 Stunden), sofort, wenn ein Port schlechter wird, und erneut, wenn er sich erholt – über die Mail-Einstellungen, die OPNsense für Monit hat.
-
Transceiver-Daten
Typ, Hersteller, Teile- und Seriennummer, Temperatur, Spannung und Empfangsleistung, wo der Treiber sie liefert – als Hinweis, nie als Urteil.
Installieren und aktualisieren
Auf einer Sophos XGS Appliance kommt es mit dem Image von xgs-image-builder und ist nach dem ersten Start eingeschaltet. Neue Releases werden von Hand über den Tab Plugins von XGS: Updates installiert; nichts wird von selbst aktualisiert. Anderswo installieren Sie mit pkg add das Paket, das einem Release beiliegt, oder eines, das auf der Firewall mit tools/make-package.sh gebaut wurde; install/install.sh erledigt dasselbe ohne Paket. Dann öffnen Sie Interfaces: Link Health, mit installiertem os-xgs-npu XGS: Link Health, und geben ihm zwei Minuten: Der erste Lauf zeichnet nur eine Basislinie auf.
Grenzen, und was noch nicht getestet ist
- Alle Schwellen stammen von einer Appliance mit igb- und ix-Ports. Die Zählerzuordnungen aller anderen Treiber sind aus den Treiberquellen geschrieben und liefen nicht auf Hardware.
- Identifizieren wurde an den igb- und ix-Ports der Referenzmaschine getestet; andere Treiber sind nicht getestet und bieten womöglich keine Schaltfläche.
- Aus den Herstellerdateien erzeugte Board-Einträge sind als ungeprüft markiert; nur XGS 3300, XGS 136 und XG 330 wurden Buchse für Buchse geprüft.
- Keine Kabellänge oder Entfernung zum Fehler, keine Werte vom fernen Ende und keine Transceiver-Daten an em-, igb- oder igc-Ports.
Repository
Erste Veröffentlichung: 2026-10-16