CodingBox Документация

Плоскость управления: консоль, OOB, API, SNMP и телеметрия для оптики

Всё, что коммутатор знает о трансивере — идентификация, DDM, аварии, причина отказа модулю, — живёт в плоскости управления и доходит до вас через плоскость менеджмента: консольный кабель, внеполосный порт, сессию CLI или API, опрос SNMP, поток телеметрии или строку syslog. Здесь перечислены методы доступа, интерфейсы автоматизации, объекты SNMP и пути телеметрии, несущие данные о трансиверах на основных платформах, сообщения syslog, на которые стоит ставить алерты, и эксплуатационные процедуры (бэкапы, обновления, ZTP), касающиеся оптики.

Методы доступа

МетодПорт / интерфейсПрименениеПримечания
КонсольRJ45 RS-232 (кабель Cisco rollover, 9600 8N1) и/или USB-C / mini-USB (виртуальный COM)первичная настройка, восстановление, наблюдение загрузки115 200 на многих новых коробках; USB-консоли в Windows нужен драйвер
Внеполосное управлениевыделенный Ethernet mgmt0 / Management1 / me0, свой VRFповседневное управление, keepalive для MLAG, телеметрияотдельная физическая сеть; 1G медь, иногда SFP (Именование портов и светодиоды)
In-bandloopback или SVI через сеть данныхкогда OOB неттеряется вместе с плоскостью данных
BMC / IPMI / Redfishна white-box и части ДЦ-коммутаторовпитание, датчики, прошивкасерверный стиль
Bluetooth / USB-приложениечасть кампусных коммутаторовпервичная настройка с телефона

Интерфейсы конфигурации и автоматизации

ИнтерфейсСтандартыГдеИспользование для оптики
CLI (SSH)всеshow interfaces transceiver и подобные (Проверка оптики на коммутаторе)
NETCONF / YANGRFC 6241, OpenConfig и вендорские моделиJunos, IOS-XE/XR, NX-OS, Arista, Huawei, SONiC (частично)openconfig-platform-transceiver читает идентификацию и DDM
RESTCONF / RESTRFC 8040, вендорский REST (Arista eAPI, AOS-CX REST, NX-API, Dell OS10 REST)большинствоJSON тех же команд show
gNMI / gRPCOpenConfig gNMIArista, Cisco, Juniper, Nokia, SONiCподписки потоковой телеметрии
SNMPv2c / v3всеопрос DDM и статуса (Мониторинг)
Ansible / Terraform / Pythonповерх перечисленногоинвентарь трансиверов по всему парку
ZTP / PoAP / autoinstallопции DHCP + HTTP/TFTPразвёртываниеновый коммутатор тянет образ и конфигурацию; команды политики к оптике должны быть в этой конфигурации

Объекты SNMP для трансиверов

ОбластьMIB / объектПримечания
Статус и счётчики интерфейсов (все)IF-MIB: ifOperStatus, ifHighSpeed, ifInErrors, ifHCInOctets; EtherLike-MIB: dot3StatsFCSErrorsлинк и CRC
Физический инвентарь (все)ENTITY-MIB: entPhysicalDescr, entPhysicalModelName (PN), entPhysicalSerialNum (SN), entPhysicalMfgName (вендор), entPhysicalClass = port/moduleмодули появляются как дочерние сущности порта
Датчики (стандарт)ENTITY-SENSOR-MIB (RFC 3433): entPhySensorType (celsius, volts, amperes, dBm как ватты ×10^scale), entPhySensorValue, entPhySensorScale, entPhySensorPrecisionиспользуют Arista, Cisco (часть), Dell, SONiC
CiscoCISCO-ENTITY-SENSOR-MIB (entSensorValue, пороги в CISCO-ENTITY-SENSOR-EXT-MIB), CISCO-ENTITY-FRU-CONTROL-MIB; индексы DOM трансивера под дочерними сущностями портаIOS/IOS-XE/NX-OS
JuniperJUNIPER-DOM-MIB: jnxDomCurrentRxLaserPower, jnxDomCurrentTxLaserOutputPower, jnxDomCurrentTxLaserBiasCurrent, jnxDomCurrentModuleTemperature, jnxDomCurrentModuleVoltage, столбцы аварий/предупреждений; поканальная таблица jnxDomCurrentLane*значения в 0,01 дБм / 0,001 мА
HuaweiHUAWEI-ENTITY-EXTENT-MIB: hwEntityOpticalRxPower, hwEntityOpticalTxPower, hwEntityOpticalBiasCurrent, hwEntityOpticalTemperature, hwEntityOpticalVendorSn, hwEntityOpticalVendorPn, hwEntityOpticalType; hwEntityOpticalUserEepromVRP
H3CHH3C-TRANSCEIVER-INFO-MIB: hh3cTransceiverHardwareType, hh3cTransceiverVendorName, hh3cTransceiverCurRXPower, hh3cTransceiverCurTXPower, hh3cTransceiverTemperatureComware
HPE ArubaENTITY-SENSOR-MIB на AOS-CX; MIB hpicfTransceiver на AOS-S
Dell OS10ENTITY-SENSOR-MIB + REST os10-platform
ExtremeEXTREME-PORT-MIB / extremeOpticalPort на EXOS
MikroTikMIKROTIK-MIB: mtxrOpticalTable (mtxrOpticalRxPower, mtxrOpticalTxPower, mtxrOpticalTemperature, mtxrOpticalVoltage, mtxrOpticalTxBias)RouterOS
UbiquitiUBNT-… ограниченно; используйте SSH/ethtool -m
SONiCENTITY-SENSOR-MIB через snmpagent; состояние в redis, таблица TRANSCEIVER_DOM_SENSOR
ТрапыlinkDown/linkUp (IF-MIB), вендорские трапы порогов DOM (jnxDomAlarm*, hwEntityOpticalTrap, cefcFRU*)

Совет по масштабу — опрашивать DDM раз в 60–300 с, а не в 10 с; алерты по дельтам: Мониторинг.

Пути потоковой телеметрии (OpenConfig)

ПутьДанные
/components/component[name=<port>-transceiver]/transceiver/state/vendor, vendor-part, serial-no, form-factor, connector-type, ethernet-pmd, present, date-code
…/transceiver/physical-channels/channel[index]/state/input-power, output-power, laser-bias-current по каналам (мгновенное/среднее/мин/макс)
/components/component/state/temperature/instantтемпература модуля
/interfaces/interface[name]/state/counters/in-crc-errors, in-fcs-errors, carrier-transitions (число флапов)
/interfaces/interface/ethernet/state/negotiated-port-speed, fec-mode (новые модели)
Вендорские (Cisco XR Cisco-IOS-XR-controller-optics-oper, Junos /junos/system/linecard/optics/, Arista /Sysdb/hardware/xcvr/status/)богаче: пороги, аварии, состояния каналов

Интервалы выборки 30–60 с для DDM и 10 с для счётчиков типичны; телеметрия push-ориентирована, так что сотни портов стоят коммутатору немного.

Сообщения syslog, на которые стоит ставить алерты

КлассПримеры (формулировки различаются)Смысл
Модуль принят/отвергнут%PHY-4-UNSUPPORTED_TRANSCEIVER, Transceiver … unsupported, phony transceiver, Mod_Inv, PIC … optics unsupportedполитика (Как каждая NOS проверяет модуль)
Модуль вставлен/извлечён%SFF8472-…, XCVR inserted/removed, Transceiver presentинвентарь
Порог DOMRx power low warning, TEMP_HIGH_ALARM, jnxDomAlarmSet, %SFF8472-5-THRESHOLD_VIOLATIONуровни (Пороги и аварии)
Состояние линка%LINK-3-UPDOWN, %LINEPROTO-5-UPDOWN, SNMP_TRAP_LINK_DOWNфлапы (Флап линка)
Errdisable%PM-4-ERR_DISABLE gbic-invalid, link-flap error detectedпорт выключен политикой
FECFEC uncorrectable errors, pre-FEC BER thresholdмаргинальный линк
Питание/теплоpower class exceeds, Module … high temperature, аварии вентиляторов/БППитание и тепло
CMISModule not ready, DataPath … state, CDB failureПроблемы CMIS

Эксплуатационные процедуры, касающиеся оптики

ПроцедураЧто делать с модулями
Бэкап конфигурациивключает команды политики к оптике (service unsupported-transceiver, настройки FEC, breakout) — их потеря при восстановлении гасит порты
Обновление софтачитать release notes на предметы о трансиверах, тестировать на канарейке, держать инвентарь закодированных модулей (Матрицы совместимости и прошивки)
Прошивка модулейчасть NOS заливает прошивку модулей (Cisco, Arista, Juniper для OEM-оптики) — новая NOS может обновить модули молча (Контроллер и прошивка)
Экспорт инвентаряshow inventory / ENTITY-MIB / телеметрия в CMDB: вендор, PN, SN, порт
ZTPконфигурация развёртывания должна уже содержать строки FEC/скорости/политики, иначе свежий leaf поднимается с тёмными аплинками
Синхронизация времениNTP/PTP, чтобы история DDM и syslog совпадали между устройствами
AAA и журналированиефиксировать, кто менял скорость/FEC порта — половина тикетов «оптика умерла» — изменения конфигурации

В CodingBox

Столовое чтение и телеметрия коммутатора описывают одни и те же байты: вендор, PN, SN, код даты, значения и пороги DDM. Экспорт инвентаря коммутатора и сверка серийников с базой кодов находит модули, чья идентификация была закодирована, чьи пороги отличаются от даташита или которые переехали между портами (Check transceiver, Снятие DDM инструментами).