管理平面：控制台、OOB、API、SNMP 与光模块遥测

交换机对光模块了解的一切——身份信息、DDM、告警、拒绝某个模块的原因——都保存在控制平面中，并通过管理平面传递给你：一根 console 线、一个带外端口、一次 CLI 或 API 会话、一次 SNMP 轮询、一条遥测流或一行 syslog。本页列出主流平台上承载光模块数据的接入方式、自动化接口、SNMP 对象和遥测路径，值得告警的 syslog 消息，以及涉及光模块的运维流程（备份、升级、ZTP）。

接入方式

方式	端口 / 接口	用途	说明
Console	RJ45 RS-232（Cisco rollover 线缆，9600 8N1）和/或 USB-C / mini-USB（虚拟 COM）	初次配置、故障恢复、观察启动过程	许多新设备使用 115200；USB console 在 Windows 上需要驱动
带外管理	专用 `mgmt0` / `Management1` / `me0` 以太网口，独立 VRF	日常管理、MLAG 保活、遥测	独立的物理网络；1G 铜口，有时是 SFP（端口命名与指示灯）
带内管理	数据网络上的环回接口或 SVI	没有带外管理时使用	数据平面故障时同时失效
BMC / IPMI / Redfish	白牌及部分数据中心交换机上提供	电源、传感器、固件	服务器风格
蓝牙 / USB App	部分园区交换机	用手机完成初始设置	—

配置与自动化接口

接口	标准	支持平台	光模块用途
CLI（SSH）	—	所有平台	`show interfaces transceiver` 及同类命令（在交换机上验证光模块）
NETCONF / YANG	RFC 6241、OpenConfig 及各厂商原生模型	Junos、IOS-XE/XR、NX-OS、Arista、Huawei、SONiC（部分支持）	`openconfig-platform-transceiver` 读取身份信息和 DDM
RESTCONF / REST	RFC 8040、厂商 REST（Arista eAPI、AOS-CX REST、NX-API、Dell OS10 REST）	大多数平台	与 show 命令相同内容的 JSON 输出
gNMI / gRPC	OpenConfig gNMI	Arista、Cisco、Juniper、Nokia、SONiC	流式遥测订阅
SNMP	v2c / 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`（料号）、`entPhysicalSerialNum`（序列号）、`entPhysicalMfgName`（厂商）、`entPhysicalClass` = port/module	模块作为端口的子实体出现
传感器（标准）	`ENTITY-SENSOR-MIB`（RFC 3433）：`entPhySensorType`（摄氏度、伏特、安培、以 ×10^scale 表示瓦特的 dBm）、`entPhySensorValue`、`entPhySensorScale`、`entPhySensorPrecision`	Arista、部分 Cisco、Dell、SONiC 使用
Cisco	`CISCO-ENTITY-SENSOR-MIB`（`entSensorValue`，阈值在 `CISCO-ENTITY-SENSOR-EXT-MIB` 中）、`CISCO-ENTITY-FRU-CONTROL-MIB`；光模块 DOM 索引位于端口的子实体下	IOS/IOS-XE/NX-OS
Juniper	`JUNIPER-DOM-MIB`：`jnxDomCurrentRxLaserPower`、`jnxDomCurrentTxLaserOutputPower`、`jnxDomCurrentTxLaserBiasCurrent`、`jnxDomCurrentModuleTemperature`、`jnxDomCurrentModuleVoltage`，以及告警/预警列；按通道的表 `jnxDomCurrentLane*`	数值单位为 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	AOS-CX 上为 `ENTITY-SENSOR-MIB`；AOS-S 上为 `hpicfTransceiver` MIB	—
Dell OS10	`ENTITY-SENSOR-MIB` + `os10-platform` REST	—
Extreme	EXOS 上为 `EXTREME-PORT-MIB` / `extremeOpticalPort`	—
MikroTik	`MIKROTIK-MIB`：`mtxrOpticalTable`（`mtxrOpticalRxPower`、`mtxrOpticalTxPower`、`mtxrOpticalTemperature`、`mtxrOpticalVoltage`、`mtxrOpticalTxBias`）	RouterOS
Ubiquiti	`UBNT-…` 支持有限；改用 SSH/`ethtool -m`	—
SONiC	通过 snmpagent 提供 `ENTITY-SENSOR-MIB`；状态保存在 redis 的 `TRANSCEIVER_DOM_SENSOR` 表中	—
Trap	`linkDown`/`linkUp`（IF-MIB）、厂商 DOM 阈值 trap（`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/`）	更丰富：阈值、告警、各通道状态

典型采样间隔：DDM 为 30–60 秒，计数器为 10 秒；遥测采用推送方式，因此数百个端口给交换机带来的开销很小。

值得告警的 syslog 消息

类别	示例（措辞因平台而异）	含义
模块接受/拒绝	`%PHY-4-UNSUPPORTED_TRANSCEIVER`、`Transceiver … unsupported`、`phony transceiver`、`Mod_Inv`、`PIC … optics unsupported`	策略（各操作系统如何校验模块）
模块插入/拔出	`%SFF8472-…`、`XCVR inserted/removed`、`Transceiver present`	资产清单
DOM 阈值	`Rx 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`	端口被策略关闭
FEC	`FEC uncorrectable errors`、`pre-FEC BER threshold`	链路处于临界状态
电源/散热	`power class exceeds`、`Module … high temperature`、风扇/电源告警	电源与热管理
CMIS	`Module not ready`、`DataPath … state`、`CDB failure`	CMIS 问题

涉及光模块的运维流程

流程	对模块要做的事
配置备份	需要包含光模块策略命令（`service unsupported-transceiver`、FEC 设置、breakout）——恢复配置时若丢失这些命令，端口会中断
软件升级	阅读发行说明中关于光模块的条目，先在金丝雀设备上测试，保留已编码模块的清单（兼容性矩阵与固件）
模块固件	部分 NOS 会推送模块固件（Cisco、Arista、Juniper 对 OEM 光模块）——新版本 NOS 可能悄悄更新模块（控制器与固件）
清单导出	通过 `show inventory` / ENTITY-MIB / 遥测导入 CMDB：厂商、料号、序列号、端口
ZTP	开局配置中必须已经包含 FEC/速率/策略相关命令，否则新上线的 leaf 上行链路会保持不通
时间同步	NTP/PTP，使各设备的 DDM 历史和 syslog 时间对齐
AAA 与日志	记录谁修改了端口的速率/FEC——"光模块坏了"的工单中有一半其实是配置变更

在 CodingBox 中

工作台读取的数据和交换机的遥测数据描述的是同一批字节：厂商、料号、序列号、生产日期、DDM 数值和阈值。导出交换机清单并将序列号与代码数据库中的记录比对，可以找出身份信息被编码过的模块、阈值与数据手册不符的模块，以及在端口之间被移动过的模块（检测光模块、用工具读取 DDM）。

如果您发现本资料中有不准确之处或错误，请选中相应片段并按 Ctrl+Enter，即可。