Link Health
os-linkhealth · Hardware del equipo
Vigila cada puerto físico y nombra el cable o el transceptor que se está estropeando por la etiqueta impresa en el chasis.
En el menú
- Con os-xgs-npu instalado: XGS: Link Health
- Sin os-xgs-npu: Interfaces: Link Health
El veredicto sale del cambio en los contadores de errores de hardware de un puerto durante una ventana, nunca de las lecturas ópticas. El plugin se escribió después de que una fibra de 10G corrompiera el 3,81 % de las tramas recibidas mientras el enlace aparecía activo y todas las lecturas del transceptor eran normales.
Un puerto está down, disabled, idle, ok, watch, warn o fail. Un puerto tranquilo queda idle —ni bueno ni malo— hasta que ha llevado tramas suficientes para juzgarlo, y un puerto apagado nunca es una alerta.
Los puertos llevan los nombres impresos en el chasis. En un equipo Sophos XGS con os-xgs-npu, los puertos del coprocesador y el módulo de expansión instalado se nombran al arrancar. La tabla cubre 35 placas XGS y 14 módulos FleXi; el XGS 3300, el XGS 136 y el XG 330 se comprobaron toma por toma.
Funciones
-
Veredicto por puerto
Tramas con errores por millón en la ventana, una bajada por debajo de la velocidad más alta que anuncia el puerto, colisiones en un enlace full dúplex y caídas del enlace en una hora.
-
Frontal dibujado
El frontal del equipo dibujado a partir de su disposición, cada toma coloreada según su veredicto. Una disposición que nadie ha comprobado sobre el metal lo dice en la página.
-
Identificar
Hace parpadear el LED de la propia toma, 30 segundos por defecto, sin cortar el enlace, para unir la etiqueta impresa con el nombre de la interfaz. En los equipos Sophos XGS lo hace parpadear la herramienta propia del coprocesador.
-
Prueba de carga
Para un puerto demasiado tranquilo para juzgarlo: tráfico ICMP limitado hacia un vecino que ya está en la tabla del puente de ese puerto, y luego la comparación de contadores. Satura el enlace mientras dura.
-
Un solo correo
Warn y fail se envían por correo tras dos ventanas, una vez por puerto y periodo de espera (6 horas por defecto), al momento si un puerto empeora, y otra vez cuando se recupera, con los ajustes de correo que OPNsense tiene para Monit.
-
Datos del transceptor
Tipo, fabricante, número de pieza y de serie, temperatura, tensión y potencia recibida cuando el controlador los da: un motivo orientativo, nunca el veredicto.
Instalar y actualizar
En un equipo Sophos XGS viene con la imagen de xgs-image-builder y está activo tras el primer arranque. Sus nuevas versiones se instalan a mano desde la pestaña Plugins de XGS: Updates; nada se actualiza por sí solo. En cualquier otro sitio, instale con pkg add el paquete adjunto a una versión, o uno compilado en el cortafuegos con tools/make-package.sh; install/install.sh hace lo mismo sin paquete. Después abra Interfaces: Link Health, o XGS: Link Health con os-xgs-npu instalado, y dele dos minutos: la primera pasada solo registra una línea base.
Límites, y lo que aún no se ha probado
- Todos los umbrales proceden de un equipo con puertos igb e ix. Los mapas de contadores de los demás controladores están escritos a partir de sus fuentes y no se han ejecutado en hardware.
- Identificar se probó en los puertos igb e ix de la máquina de referencia; los demás controladores no se han probado y puede que no ofrezcan el botón.
- Las entradas de placas generadas a partir de los archivos del fabricante están marcadas como no verificadas; solo el XGS 3300, el XGS 136 y el XG 330 se comprobaron toma por toma.
- Sin longitud de cable ni distancia a la avería, sin lecturas del extremo remoto y sin datos del transceptor en puertos em, igb o igc.
Repositorio
Primera versión: 2026-10-16