Link Health
os-linkhealth · Оборудование устройства
Следит за каждым физическим портом и называет портящийся кабель или трансивер по метке, напечатанной на корпусе.
В меню
- С установленным os-xgs-npu: XGS: Link Health
- Без os-xgs-npu: Interfaces: Link Health
Вердикт строится на изменении аппаратных счётчиков ошибок порта за окно, а не на оптических показаниях. Плагин был написан после того, как 10G-волокно портило 3,81 % принятых кадров, хотя канал считался поднятым, а все показания трансивера были в норме.
Порт находится в одном из состояний: down, disabled, idle, ok, watch, warn или fail. Тихий порт остаётся idle — ни хорошим, ни плохим, — пока не пропустит достаточно кадров для вердикта, а тёмный порт никогда не вызывает оповещения.
Порты носят имена, напечатанные на корпусе. На устройстве Sophos XGS с os-xgs-npu порты сопроцессора и установленный модуль расширения получают имена при загрузке. Таблица охватывает 35 плат XGS и 14 модулей FleXi; XGS 3300, XGS 136 и XG 330 проверены разъём за разъёмом.
Возможности
-
Вердикт для каждого порта
Ошибочные кадры на миллион за окно, понижение ниже самой высокой скорости, которую объявляет порт, коллизии в полнодуплексном канале и падения канала за час.
-
Нарисованная передняя панель
Передняя панель устройства, нарисованная по его раскладке, каждый разъём окрашен по вердикту. Раскладка, которую никто не сверил с железом, так и помечена на странице.
-
Опознание
Заставляет мигать собственный светодиод разъёма, по умолчанию 30 секунд, не разрывая канал, чтобы связать напечатанную метку с именем интерфейса. На устройствах Sophos XGS мигание обеспечивает собственный инструмент сопроцессора.
-
Нагрузочный тест
Для порта, слишком тихого для вердикта: ограниченный ICMP-трафик к соседу, уже присутствующему в таблице моста этого порта, затем сравнение счётчиков. Пока он идёт, канал загружен полностью.
-
Одно письмо
Warn и fail отправляются письмом после двух окон, раз на порт за период ожидания (по умолчанию 6 часов), сразу, если порт ухудшается, и ещё раз, когда он восстанавливается, — через почтовые настройки, которые есть в OPNsense для Monit.
-
Данные трансивера
Тип, производитель, номер детали и серийный номер, температура, напряжение и мощность приёма, если драйвер их даёт, — как пояснение, никогда как вердикт.
Установка и обновление
На устройстве Sophos XGS он входит в образ xgs-image-builder и включён после первой загрузки. Новые выпуски устанавливаются вручную на вкладке Plugins в XGS: Updates; ничего не обновляется само. В остальных случаях установите через pkg add пакет, приложенный к выпуску, или собранный на межсетевом экране с помощью tools/make-package.sh; install/install.sh делает то же без пакета. Затем откройте Interfaces: Link Health, или XGS: Link Health при установленном os-xgs-npu, и подождите две минуты: первый запуск только записывает исходные значения.
Ограничения и то, что ещё не проверено
- Все пороги получены на одном устройстве с портами igb и ix. Карты счётчиков всех остальных драйверов написаны по исходникам драйверов и на оборудовании не запускались.
- Опознание проверено на портах igb и ix эталонной машины; другие драйверы не проверялись, и кнопки у них может не быть.
- Записи плат, созданные из файлов производителя, помечены как непроверенные; разъём за разъёмом проверены только XGS 3300, XGS 136 и XG 330.
- Нет длины кабеля или расстояния до неисправности, нет показаний с дальнего конца и нет данных трансивера на портах em, igb и igc.
Репозиторий
Первый выпуск: 2026-10-16