Configuration Guide for Cisco Optical Site Manager, IOS XR Release 26.x.x

Provision optical threshold settings

Updated: October 14, 2026

Want to summarize with AI?

Use this procedure to provision optical threshold settings. This task helps you complete the required configuration, verification, or management action in Cisco Optical Site Manager.

Set the limits for optical performance parameters that trigger alarms or threshold crossing alerts (TCAs). This enables proactive monitoring and management of optical signal quality when parameters exceed or fall below defined thresholds.

Provisioning optical threshold settings involves configuring threshold crossing alert values for optical parameters on network cards such as SVO, OSCM, OSC-CSM, or DWDM cards. These thresholds include these parameters:

received/transmitted optical power
laser bias
chromatic dispersion
OSNR
polarization mode dispersion

Note

This feature is not supported for the FX-MXP card mode of the OTN-XP card.

Before you begin

Follow these steps to set the threshold crossing alert values on the card.

Procedure

Click the Provisioning tab.
Click the Optics Thresholds section to expand it.
Choose the type of threshold that you want to change, 15 Min or 24 Hour.
Click Add Optical Threshold button.

New Optical Threshold dialog box is displayed.
In the New Optical Threshold dialog box, add these details:
1. Select the Interface from the drop-down list.
2. Select Granularity from the drop-down list to set the threshold crossing alert for 15-minute or 24-hour interval.
3. Select Location from the drop-down list.
4. Select Direction from the drop-down list.
5. Select the performance monitoring type from the PM Type from the drop-down.
6. Select the parameter for which you want to set the threshold value from the PM Type Extension drop-down list.
  For more details about the parameters, see Table 1.
7. Enter the minimum threshold value in the Low field and the maximum threshold value in the High field.
Click Apply.

After configuring and applying the optical threshold settings, the system monitors the optical parameters against these thresholds. Alarms are raised when thresholds are crossed.

Table 1. Performance Monitoring Parameters
Use this parameter	to
amplifierTilt	configure the thresholds for ingress or egress amplifier tilt.
amplifierGain	configure the thresholds for ingress or egress amplifier gain.
opticalPower	configure the thresholds for total Rx or Tx power.
opticalPowerOSC	configure the thresholds for total Rx or Tx OSC power.
opticalPowerBackReflection	configure thresholds for optical power back reflection.
opticalPowerBackReflectionRatio	configure threshold to monitor and limit the amount of optical signal reflected back toward the transmitter.
Raman - 1	configure threshold to monitor and control the performance of the first Raman amplifier, ensuring optimal signal amplification in the optical link.

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.