Plano de gerenciamento: console, OOB, APIs, SNMP e telemetria para óptica

Tudo o que um switch sabe sobre um transceptor — identidade, DDM, alarmes, o motivo pelo qual recusou um módulo — vive no plano de controle e chega até você pelo plano de gerenciamento: um cabo de console, uma porta out-of-band, uma sessão de CLI ou API, uma consulta SNMP, um fluxo de telemetria ou uma linha de syslog. Esta página lista os métodos de acesso, as interfaces de automação, os objetos SNMP e os caminhos de telemetria que carregam dados de transceptor nas principais plataformas, as mensagens de syslog que vale a pena monitorar com alertas, e as rotinas operacionais (backups, atualizações, ZTP) que envolvem módulos ópticos.

Métodos de acesso

Método	Porta / interface	Uso	Notas
Console	RJ45 RS-232 (cabo rollover Cisco, 9600 8N1) e/ou USB-C / mini-USB (COM virtual)	primeira configuração, recuperação, acompanhar o boot	115 200 em muitos equipamentos mais novos; o console USB exige driver no Windows
Gerenciamento out-of-band	Ethernet dedicada `mgmt0` / `Management1` / `me0`, VRF própria	gerenciamento do dia a dia, keepalives do MLAG, telemetria	rede física separada; cobre 1G, às vezes SFP (Nomenclatura de portas e LEDs)
In-band	loopback ou SVI sobre a rede de dados	quando não há OOB	perdido junto com o plano de dados
BMC / IPMI / Redfish	em white-box e alguns switches de DC	energia, sensores, firmware	ao estilo servidor
Aplicativo Bluetooth / USB	alguns switches de campus	configuração inicial pelo celular	—

Interfaces de configuração e automação

Interface	Padrões	Onde	Uso para óptica
CLI (SSH)	—	todos	`show interfaces transceiver` e afins (Verificando módulos ópticos em um switch)
NETCONF / YANG	RFC 6241, OpenConfig e modelos nativos	Junos, IOS-XE/XR, NX-OS, Arista, Huawei, SONiC (parcial)	`openconfig-platform-transceiver` lê identidade e DDM
RESTCONF / REST	RFC 8040, REST de fabricante (Arista eAPI, AOS-CX REST, NX-API, Dell OS10 REST)	a maioria	JSON dos mesmos comandos show
gNMI / gRPC	OpenConfig gNMI	Arista, Cisco, Juniper, Nokia, SONiC	assinaturas de telemetria em streaming
SNMP	v2c / v3	todos	consulta de DDM e status (Monitoramento)
Ansible / Terraform / Python	sobre os anteriores	—	inventário de transceptores em toda a frota
ZTP / PoAP / autoinstall	opções de DHCP + HTTP/TFTP	provisionamento	um switch novo baixa a imagem e a configuração; os comandos de política de módulos ópticos precisam estar nessa configuração

Objetos SNMP para transceptores

Escopo	MIB / objeto	Notas
Status e contadores de interface (todos)	`IF-MIB`: `ifOperStatus`, `ifHighSpeed`, `ifInErrors`, `ifHCInOctets`; `EtherLike-MIB`: `dot3StatsFCSErrors`	enlace e CRC
Inventário físico (todos)	`ENTITY-MIB`: `entPhysicalDescr`, `entPhysicalModelName` (PN), `entPhysicalSerialNum` (SN), `entPhysicalMfgName` (fabricante), `entPhysicalClass` = port/module	os módulos aparecem como entidades filhas da porta
Sensores (padrão)	`ENTITY-SENSOR-MIB` (RFC 3433): `entPhySensorType` (celsius, volts, amperes, dBm como watts ×10^scale), `entPhySensorValue`, `entPhySensorScale`, `entPhySensorPrecision`	usado por Arista, Cisco (alguns modelos), Dell, SONiC
Cisco	`CISCO-ENTITY-SENSOR-MIB` (`entSensorValue`, limiares na `CISCO-ENTITY-SENSOR-EXT-MIB`), `CISCO-ENTITY-FRU-CONTROL-MIB`; os índices de DOM do transceptor ficam sob as entidades filhas da porta	IOS/IOS-XE/NX-OS
Juniper	`JUNIPER-DOM-MIB`: `jnxDomCurrentRxLaserPower`, `jnxDomCurrentTxLaserOutputPower`, `jnxDomCurrentTxLaserBiasCurrent`, `jnxDomCurrentModuleTemperature`, `jnxDomCurrentModuleVoltage`, colunas de alarme/aviso; tabela por lane `jnxDomCurrentLane*`	valores em 0,01 dBm / 0,001 mA
Huawei	`HUAWEI-ENTITY-EXTENT-MIB`: `hwEntityOpticalRxPower`, `hwEntityOpticalTxPower`, `hwEntityOpticalBiasCurrent`, `hwEntityOpticalTemperature`, `hwEntityOpticalVendorSn`, `hwEntityOpticalVendorPn`, `hwEntityOpticalType`; `hwEntityOpticalUserEeprom`	VRP
H3C	`HH3C-TRANSCEIVER-INFO-MIB`: `hh3cTransceiverHardwareType`, `hh3cTransceiverVendorName`, `hh3cTransceiverCurRXPower`, `hh3cTransceiverCurTXPower`, `hh3cTransceiverTemperature`	Comware
HPE Aruba	`ENTITY-SENSOR-MIB` no AOS-CX; MIB `hpicfTransceiver` no AOS-S	—
Dell OS10	`ENTITY-SENSOR-MIB` + REST `os10-platform`	—
Extreme	`EXTREME-PORT-MIB` / `extremeOpticalPort` no EXOS	—
MikroTik	`MIKROTIK-MIB`: `mtxrOpticalTable` (`mtxrOpticalRxPower`, `mtxrOpticalTxPower`, `mtxrOpticalTemperature`, `mtxrOpticalVoltage`, `mtxrOpticalTxBias`)	RouterOS
Ubiquiti	`UBNT-…` limitado; use SSH/`ethtool -m`	—
SONiC	`ENTITY-SENSOR-MIB` via snmpagent; estado na tabela redis `TRANSCEIVER_DOM_SENSOR`	—
Traps	`linkDown`/`linkUp` (IF-MIB), traps de limiar de DOM por fabricante (`jnxDomAlarm`, `hwEntityOpticalTrap`, `cefcFRU`)	—

Dica de escala — consulte o DDM a cada 60–300 s, não a cada 10 s; alerte sobre deltas: Monitoramento.

Caminhos de telemetria em streaming (OpenConfig)

Caminho	Dados
`/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` por lane (instantâneo/média/mín/máx)
`/components/component/state/temperature/instant`	temperatura do módulo
`/interfaces/interface[name]/state/counters/`	`in-crc-errors`, `in-fcs-errors`, `carrier-transitions` (contagem de oscilações)
`/interfaces/interface/ethernet/state/`	`negotiated-port-speed`, `fec-mode` (modelos mais novos)
Nativo do fabricante (Cisco XR `Cisco-IOS-XR-controller-optics-oper`, Junos `/junos/system/linecard/optics/`, Arista `/Sysdb/hardware/xcvr/status/`)	mais completo: limiares, alarmes, estado das lanes

Intervalos de amostragem típicos são 30–60 s para DDM e 10 s para contadores; a telemetria é baseada em push, então centenas de portas custam pouco ao switch.

Mensagens de syslog que vale a pena monitorar com alertas

Classe	Exemplos (a redação varia)	Significado
Módulo aceito/rejeitado	`%PHY-4-UNSUPPORTED_TRANSCEIVER`, `Transceiver … unsupported`, `phony transceiver`, `Mod_Inv`, `PIC … optics unsupported`	política (Como cada NOS valida um módulo)
Módulo inserido/removido	`%SFF8472-…`, `XCVR inserted/removed`, `Transceiver present`	inventário
Limiar de DOM	`Rx power low warning`, `TEMP_HIGH_ALARM`, `jnxDomAlarmSet`, `%SFF8472-5-THRESHOLD_VIOLATION`	níveis (Limiares e alarmes)
Estado do enlace	`%LINK-3-UPDOWN`, `%LINEPROTO-5-UPDOWN`, `SNMP_TRAP_LINK_DOWN`	oscilações (Oscilação de enlace)
Errdisable	`%PM-4-ERR_DISABLE gbic-invalid`, `link-flap error detected`	porta desativada por política
FEC	`FEC uncorrectable errors`, `pre-FEC BER threshold`	enlace marginal
Potência/térmico	`power class exceeds`, `Module … high temperature`, alarmes de ventoinha/PSU	Potência e aspectos térmicos
CMIS	`Module not ready`, `DataPath … state`, `CDB failure`	Problemas de CMIS

Rotinas operacionais que envolvem módulos ópticos

Rotina	O que fazer quanto aos módulos
Backup de configuração	inclui os comandos de política de módulos ópticos (`service unsupported-transceiver`, ajustes de FEC, breakout) — perdê-los em uma restauração derruba portas
Atualização de software	leia as notas de versão quanto a itens de transceptor, teste em um equipamento canário, mantenha o inventário de módulos codificados (Matrizes de compatibilidade e firmware)
Firmware do módulo	alguns NOS enviam firmware para o módulo (Cisco, Arista, Juniper para módulos ópticos OEM) — um NOS novo pode atualizar módulos silenciosamente (Controlador e firmware)
Exportação de inventário	`show inventory` / ENTITY-MIB / telemetria para a CMDB: fabricante, PN, SN, porta
ZTP	a configuração de provisionamento já precisa conter as linhas de FEC/velocidade/política, senão um leaf recém-provisionado sobe com uplinks apagados
Sincronização de horário	NTP/PTP para que o histórico de DDM e o syslog fiquem alinhados entre os equipamentos
AAA e logging	registra quem alterou a velocidade/FEC de uma porta — metade dos chamados de “o módulo morreu” são mudanças de configuração

No CodingBox

A leitura na bancada e a telemetria do switch descrevem os mesmos bytes: fabricante, PN, SN, data de fabricação, valores de DDM e limiares. Exportar o inventário do switch e cruzar os números de série com o code database encontra módulos cuja identidade foi codificada, cujos limiares diferem da folha de dados, ou que mudaram de porta (Check transceiver, Lendo DDM com ferramentas).

Se você encontrar uma imprecisão ou um erro neste artigo, selecione o trecho correspondente e pressione Ctrl+Enter para .