Piano di gestione: console, OOB, API, SNMP e telemetria per l’ottica
Tutto ciò che uno switch sa di un ricetrasmettitore — identità, DDM, allarmi, il motivo per cui ha rifiutato un modulo — vive nel control plane e arriva a te attraverso il management plane: un cavo console, una porta out-of-band, una sessione CLI o API, un polling SNMP, uno stream di telemetria o una riga di syslog. Questa pagina elenca i metodi di accesso, le interfacce di automazione, gli oggetti SNMP e i percorsi di telemetria che trasportano i dati del ricetrasmettitore sulle piattaforme principali, i messaggi syslog su cui vale la pena allertare, e le routine operative (backup, aggiornamenti, ZTP) che toccano l’ottica.
Metodi di accesso
| Metodo | Porta / interfaccia | Uso | Note |
|---|
| Console | RJ45 RS-232 (cavo rollover Cisco, 9600 8N1) e/o USB-C / mini-USB (COM virtuale) | prima configurazione, recovery, osservazione del boot | 115 200 su molti apparati più recenti; la console USB richiede un driver su Windows |
| Gestione out-of-band | Ethernet dedicata mgmt0 / Management1 / me0, VRF propria | gestione quotidiana, keepalive per MLAG, telemetria | rete fisica separata; rame 1G, a volte SFP (Denominazione delle porte e LED) |
| In-band | loopback o SVI sulla rete dati | quando manca l’OOB | si perde insieme al data plane |
| BMC / IPMI / Redfish | su white-box e alcuni switch da data center | alimentazione, sensori, firmware | in stile server |
| App Bluetooth / USB | alcuni switch da campus | configurazione iniziale da telefono | — |
Interfacce di configurazione e automazione
| Interfaccia | Standard | Dove | Uso per l’ottica |
|---|
| CLI (SSH) | — | tutti | show interfaces transceiver e comandi simili (Verifica delle ottiche su uno switch) |
| NETCONF / YANG | RFC 6241, OpenConfig e modelli nativi | Junos, IOS-XE/XR, NX-OS, Arista, Huawei, SONiC (parziale) | openconfig-platform-transceiver legge identità e DDM |
| RESTCONF / REST | RFC 8040, REST del produttore (Arista eAPI, AOS-CX REST, NX-API, Dell OS10 REST) | sulla maggior parte | JSON degli stessi comandi show |
| gNMI / gRPC | OpenConfig gNMI | Arista, Cisco, Juniper, Nokia, SONiC | sottoscrizioni di telemetria in streaming |
| SNMP | v2c / v3 | tutti | polling di DDM e stato (Monitoraggio) |
| Ansible / Terraform / Python | sopra le precedenti | — | inventario dei ricetrasmettitori su tutta la flotta |
| ZTP / PoAP / autoinstall | opzioni DHCP + HTTP/TFTP | provisioning | uno switch nuovo scarica immagine e configurazione; i comandi di policy sull’ottica devono trovarsi in quella configurazione |
Oggetti SNMP per i ricetrasmettitori
| Ambito | MIB / oggetto | Note |
|---|
| Stato e contatori dell’interfaccia (tutti) | IF-MIB: ifOperStatus, ifHighSpeed, ifInErrors, ifHCInOctets; EtherLike-MIB: dot3StatsFCSErrors | link e CRC |
| Inventario fisico (tutti) | ENTITY-MIB: entPhysicalDescr, entPhysicalModelName (PN), entPhysicalSerialNum (SN), entPhysicalMfgName (produttore), entPhysicalClass = port/module | i moduli compaiono come entità figlie della porta |
| Sensori (standard) | ENTITY-SENSOR-MIB (RFC 3433): entPhySensorType (celsius, volt, ampere, dBm come watt ×10^scale), entPhySensorValue, entPhySensorScale, entPhySensorPrecision | usato da Arista, Cisco (alcuni), Dell, SONiC |
| Cisco | CISCO-ENTITY-SENSOR-MIB (entSensorValue, soglie in CISCO-ENTITY-SENSOR-EXT-MIB), CISCO-ENTITY-FRU-CONTROL-MIB; gli indici DOM del ricetrasmettitore sono sotto le entità figlie della porta | IOS/IOS-XE/NX-OS |
| Juniper | JUNIPER-DOM-MIB: jnxDomCurrentRxLaserPower, jnxDomCurrentTxLaserOutputPower, jnxDomCurrentTxLaserBiasCurrent, jnxDomCurrentModuleTemperature, jnxDomCurrentModuleVoltage, colonne di allarme/avviso; tabella per lane jnxDomCurrentLane* | valori in 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 su AOS-CX; MIB hpicfTransceiver su AOS-S | — |
| Dell OS10 | ENTITY-SENSOR-MIB + os10-platform REST | — |
| Extreme | EXTREME-PORT-MIB / extremeOpticalPort su EXOS | — |
| MikroTik | MIKROTIK-MIB: mtxrOpticalTable (mtxrOpticalRxPower, mtxrOpticalTxPower, mtxrOpticalTemperature, mtxrOpticalVoltage, mtxrOpticalTxBias) | RouterOS |
| Ubiquiti | UBNT-… limitato; usa SSH/ethtool -m | — |
| SONiC | ENTITY-SENSOR-MIB via snmpagent; stato in redis nella tabella TRANSCEIVER_DOM_SENSOR | — |
| Trap | linkDown/linkUp (IF-MIB), trap di soglia DOM del produttore (jnxDomAlarm*, hwEntityOpticalTrap, cefcFRU*) | — |
Consiglio per la scalabilità — esegui il polling del DDM ogni 60–300 s, non ogni 10 s; genera allarmi sulle variazioni: Monitoraggio.
Percorsi di telemetria in streaming (OpenConfig)
| Percorso | Dati |
|---|
/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 per lane (istantaneo/medio/min/max) |
/components/component/state/temperature/instant | temperatura del modulo |
/interfaces/interface[name]/state/counters/ | in-crc-errors, in-fcs-errors, carrier-transitions (conteggio dei flap) |
/interfaces/interface/ethernet/state/ | negotiated-port-speed, fec-mode (modelli più recenti) |
Nativo del produttore (Cisco XR Cisco-IOS-XR-controller-optics-oper, Junos /junos/system/linecard/optics/, Arista /Sysdb/hardware/xcvr/status/) | più ricco: soglie, allarmi, stati delle lane |
Intervalli di campionamento tipici sono 30–60 s per il DDM e 10 s per i contatori; la telemetria è push, quindi centinaia di porte costano poco allo switch.
Messaggi syslog su cui vale la pena allertare
| Classe | Esempi (la formulazione varia) | Significato |
|---|
| Modulo accettato/rifiutato | %PHY-4-UNSUPPORTED_TRANSCEIVER, Transceiver … unsupported, phony transceiver, Mod_Inv, PIC … optics unsupported | policy (Come ogni NOS convalida un modulo) |
| Modulo inserito/rimosso | %SFF8472-…, XCVR inserted/removed, Transceiver present | inventario |
| Soglia DOM | Rx power low warning, TEMP_HIGH_ALARM, jnxDomAlarmSet, %SFF8472-5-THRESHOLD_VIOLATION | livelli (Soglie e allarmi) |
| Stato del link | %LINK-3-UPDOWN, %LINEPROTO-5-UPDOWN, SNMP_TRAP_LINK_DOWN | flap (Flapping del collegamento) |
| Errdisable | %PM-4-ERR_DISABLE gbic-invalid, link-flap error detected | porta disattivata da policy |
| FEC | FEC uncorrectable errors, pre-FEC BER threshold | collegamento marginale |
| Alimentazione/termico | power class exceeds, Module … high temperature, allarmi di ventola/PSU | Potenza e termica |
| CMIS | Module not ready, DataPath … state, CDB failure | Problemi CMIS |
Routine operative che toccano l’ottica
| Routine | Cosa fare per i moduli |
|---|
| Backup della configurazione | include i comandi di policy sull’ottica (service unsupported-transceiver, impostazioni FEC, breakout) — perderli al ripristino porta le porte down |
| Aggiornamento software | leggi le release notes per le voci sui ricetrasmettitori, testa su uno switch canarino, mantieni l’inventario dei moduli codificati (Matrici di compatibilità e firmware) |
| Firmware del modulo | alcuni NOS distribuiscono il firmware dei moduli (Cisco, Arista, Juniper per ottiche OEM) — un nuovo NOS può aggiornare i moduli silenziosamente (Controller e firmware) |
| Esportazione dell’inventario | show inventory / ENTITY-MIB / telemetria verso il CMDB: produttore, PN, SN, porta |
| ZTP | la configurazione di provisioning deve già contenere le righe di FEC/velocità/policy, altrimenti un leaf appena provisionato si avvia con gli uplink spenti |
| Sincronizzazione oraria | NTP/PTP in modo che lo storico DDM e il syslog siano allineati tra i dispositivi |
| AAA e logging | registra chi ha cambiato la velocità/FEC di una porta — metà dei ticket «l’ottica è morta» sono in realtà modifiche di configurazione |
In CodingBox
La lettura al banco e la telemetria dello switch descrivono gli stessi byte: produttore, PN, SN, date code, valori DDM e soglie. Esportare l’inventario dello switch e confrontare i numeri di serie con il code database trova i moduli la cui identità è stata codificata, quelli le cui soglie differiscono dal datasheet, o quelli che si sono spostati tra le porte (Check transceiver, Leggere il DDM con gli strumenti).