Link Health
os-linkhealth · Matériel du boîtier
Surveille chaque port physique et nomme le câble ou le transceiver qui se dégrade par l'étiquette imprimée sur le châssis.
Dans le menu
- Avec os-xgs-npu installé : XGS: Link Health
- Sans os-xgs-npu : Interfaces: Link Health
Le verdict vient de la variation des compteurs d'erreurs matériels d'un port sur une fenêtre, jamais des mesures optiques. Le plugin a été écrit après qu'une fibre 10G a corrompu 3,81 % des trames reçues alors que le lien apparaissait actif et que toutes les mesures du transceiver étaient normales.
Un port est down, disabled, idle, ok, watch, warn ou fail. Un port calme reste idle — ni bon ni mauvais — jusqu'à ce qu'il ait porté assez de trames pour être jugé, et un port éteint n'est jamais une alerte.
Les ports portent les noms imprimés sur le châssis. Sur une appliance Sophos XGS avec os-xgs-npu, les ports du coprocesseur et le module d'extension installé sont nommés au démarrage. La table couvre 35 cartes XGS et 14 modules FleXi ; les XGS 3300, XGS 136 et XG 330 ont été vérifiées prise par prise.
Fonctions
-
Verdict par port
Trames en erreur par million sur la fenêtre, une négociation sous la vitesse la plus haute qu'annonce le port, des collisions sur un lien en duplex intégral et les coupures du lien sur une heure.
-
Façade dessinée
La façade de l'appliance dessinée d'après sa disposition, chaque prise colorée selon son verdict. Une disposition que personne n'a vérifiée sur le métal le dit sur la page.
-
Identifier
Fait clignoter la DEL de la prise elle-même, 30 secondes par défaut, sans couper le lien, pour relier l'étiquette imprimée au nom de l'interface. Sur les appliances Sophos XGS, c'est l'outil du coprocesseur lui-même qui la fait clignoter.
-
Test de charge
Pour un port trop calme pour être jugé : un trafic ICMP plafonné vers un voisin déjà présent dans la table du pont pour ce port, puis la comparaison des compteurs. Il sature le lien pendant qu'il tourne.
-
Un seul courriel
Warn et fail sont envoyés par courriel après deux fenêtres, une fois par port et par délai (6 heures par défaut), tout de suite quand un port empire, et de nouveau quand il se rétablit — avec les réglages de courriel qu'OPNsense a pour Monit.
-
Données du transceiver
Type, fabricant, référence et numéro de série, température, tension et puissance reçue quand le pilote les donne — une raison indicative, jamais le verdict.
Installer et mettre à jour
Sur une appliance Sophos XGS, il est fourni avec l'image de xgs-image-builder et activé après le premier démarrage. Ses nouvelles versions s'installent à la main depuis l'onglet Plugins de XGS: Updates ; rien ne se met à jour tout seul. Ailleurs, installez avec pkg add le paquet joint à une version, ou un paquet construit sur le pare-feu avec tools/make-package.sh ; install/install.sh fait la même chose sans paquet. Ouvrez ensuite Interfaces: Link Health, ou XGS: Link Health quand os-xgs-npu est installé, et laissez-lui deux minutes : le premier passage n'enregistre qu'une référence.
Limites, et ce qui n'est pas encore testé
- Tous les seuils viennent d'une seule appliance à ports igb et ix. Les tables de compteurs de tous les autres pilotes sont écrites d'après les sources des pilotes et n'ont pas tourné sur du matériel.
- Identifier a été testé sur les ports igb et ix de la machine de référence ; les autres pilotes ne sont pas testés et peuvent n'offrir aucun bouton.
- Les entrées de cartes générées à partir des fichiers du fabricant sont marquées non vérifiées ; seules les XGS 3300, XGS 136 et XG 330 ont été vérifiées prise par prise.
- Pas de longueur de câble ni de distance jusqu'au défaut, pas de mesures de l'extrémité distante, et pas de données de transceiver sur les ports em, igb ou igc.
Dépôt
Première version: 2026-10-16