Diagnostic parameters for optical transceivers | Configuring controllers | Optics and Hardware Configuration Guide for Cisco 8000 Series Routers

Introduces diagnostic parameters for optical transceivers and explains the core idea and technical context. Highlights the main characteristics and usage guidance needed before configuration.

To monitor and report optical transceiver performance and enhance troubleshooting, the observable-info keyword is added to the show controllers optics command to display the diagnostics parameters. These parameters help in monitoring the health of the network when the optical transceiver heats up, when the link is down, when alarms are raised, or when there's traffic loss in the network. This improvement in the show controllers optics command now displays the following diagnostic parameters:

Effective Signal to Noise Ratio (eSNR)
Pulse Amplitude Modulation with Four Levels (PAM4) Level Transition Parameter (LTP)
Pre-Forward Error Correction (FEC) and Post-FEC Bit Error Rate (BER)
Frame Error Count (FERC)
Laser age
Thermoelectric Cooler (TEC) current
Laser frequency
Laser temperature

Table 1. Feature History Table
Feature Name	Release Information	Description
Diagnostic Parameters for Optical Transceivers	Release 25.4.1	Introduced in this release on: Fixed Systems (8010 [ASIC: A100])(select variants only) This feature is supported on: 8011-32Y8L2H2FH 8011-12G12X4Y-A/D
Diagnostic Parameters for Optical Transceivers	Release 25.1.1	Introduced in this release on: Fixed Systems (8010 [ASIC: A100])(select variants only) This feature is supported on Cisco 8011-4G24Y4H-I routers.
Diagnostic Parameters for Optical Transceivers	Release 24.4.1	Introduced in this release on: Fixed Systems (8200 [ASIC: P100], 8700 [ASIC: P100, K100])(select variants only); Modular Systems (8800 [LC ASIC: P100])(select variants only) *This feature is now supported on: 8212-48FH-M 8711-32FH-M 8712-MOD-M 88-LC1-12TH24FH-E 88-LC1-36EH+A8:B12 88-LC1-52Y8H-EM
Diagnostic Parameters for Optical Transceivers	Release 7.11.1	You can analyze the diagnostic parameters for optical transceivers installed on a network device and detect potential issues with the optical transceivers, such as excessive power levels, abnormal temperature readings, or degradation of the optical signal. Such analysis is possible because the show controllers optics command now displays the diagnostic parameters: Effective Signal to Noise Ratio (eSNR) Pulse Amplitude Modulation with Four Levels (PAM4) Level Transition Parameter (LTP) Pre-Forward Error Correction (FEC) and Post-FEC Bit Error Rate (BER) Frame Error Count (FERC) Laser age Thermoelectric Cooler (TEC) current Laser frequency Laser temperature For additional information on VDM (Versatile Diagnostics Monitoring), see the Common Management Interface Specification. The feature introduces these changes: CLI: The observable-info keyword is added to the show controller optics command. YANG Data Model: New XPath for `Cisco-IOS-XR-controller-optics-oper.yang` (see GitHub, YANG Data Models Navigator)

Note

Not all optical transceivers support the observable-info keyword. Also, the parameters that are displayed depend on what the optical transceiver supports, that is, not all optical transceivers display the same parameters. For additional information on VDM (Versatile Diagnostics Monitoring), see the Common Management Interface Specification.

The show controllers optics observable-info command displays the monitoring parameters of the optical transceiver present in the 0/0/0/9 location ID. The 0/0/0/9 location ID represents rack/slot/instance/port. Network administrators can use the displayed values of this command for monitoring and troubleshooting.

Router#show controllers optics 0/0/0/9 observable-info
Observable Information

[eSNR Media Input]
 Unit: dB
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Lane0    21.30               0.00                0.00                0.00                0.00                n   n     n   n     
 Lane1    22.05               0.00                0.00                0.00                0.00                n   n     n   n     
 Lane2    22.62               0.00                0.00                0.00                0.00                n   n     n   n     
 Lane3    22.05               0.00                0.00                0.00                0.00                n   n     n   n     

[PAM4 Level Transition Parameter Media Input]
 Unit: dB
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Lane0    47.79               0.00                0.00                0.00                0.00                n   n     n   n     
 Lane1    54.70               0.00                0.00                0.00                0.00                n   n     n   n     
 Lane2    64.34               0.00                0.00                0.00                0.00                n   n     n   n     
 Lane3    59.64               0.00                0.00                0.00                0.00                n   n     n   n     

[Pre-FEC BER Minimum Media Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[Pre-FEC BER Minimum Host Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[Pre-FEC BER Maximum Media Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[Pre-FEC BER Maximum Host Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[Pre-FEC BER Average Media Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[Pre-FEC BER Average Host Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[Pre-FEC BER Current Media Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[Pre-FEC BER Current Host Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[FERC Minimum Media Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[FERC Minimum Host Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[FERC Maximum Media Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[FERC Maximum Host Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[FERC Average Media Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[FERC Average Host Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[FERC Current Media Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n     

[FERC Current Host Input]
 Unit: n/a
 Id       Value               LowThreshWarn       HighThresWarn       LowThreshAlarm      HighThreshAlarm     TCAWarn   TCAAlarm  
                                                                                                              Low High  Low High  
 Module   0.000E+00           0.000E+00           0.000E+00           0.000E+00           0.000E+00           n   n     n   n