管理平面：控制台、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，即可。