CISCO-OPTICAL-MONITOR-MIB

All MIBs › CISCO-OPTICAL-MONITOR-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2007-01-02

Category: Cisco Devices, Optical and WDM

Description: Monitors optical signal power, wavelength, and OSNR parameters on Cisco optical transport network platforms.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is CISCO-OPTICAL-MONITOR-MIB?

CISCO-OPTICAL-MONITOR-MIB is a Cisco Systems proprietary MIB monitoring optical characteristics (power levels) and configuring corresponding alarm/warning thresholds on optical interfaces. Its monitor table, keyed by direction/location/parameter type, records the current measured value, high/low alarm and warning thresholds with associated severities, current alarm status, the maximum threshold currently in effect and its severity, last-change time, threshold source, notification enable, monitoring enable/poll interval, and counts of valid 15-minute/24-hour collection intervals. As a performance/hardware-status MIB it lets an administrator confirm optical power levels stay within configured alarm/warning bounds, catching a degrading transceiver before a link failure. It is deployed on Cisco optical transport/DWDM platforms. Engineers can download the CISCO-OPTICAL-MONITOR-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-OPTICAL-MONITOR-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Cisco optical transport/DWDM platforms

Monitoring Examples

An administrator monitors cOpticalParameterValue against cOpticalParamLowWarningThresh to catch a degrading optical transceiver's power output before it crosses into alarm territory on a Cisco optical platform.

What Can Be Monitored

optical power levels vs. configured alarm/warning thresholds

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From IF-MIB

ifIndex

OBJECT-TYPE

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Integer32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

TEXTUAL-CONVENTION
TimeStamp

How to Use in IPNetwork Monitor

Example using cOpticalPMCurrentUnavailSecs OID:

Select a Cisco DWDM optical transport platform as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type cOpticalPMCurrentUnavailSecs into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. This object is used to indicate the number of seconds, in the current 15 minute or the current 24 hour interval, for which the optical performance data is not accounted for. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is an Integer32-type OID, Value bounds is the most useful condition here — trigger an alert if the count changes from its expected baseline, since that would indicate the underlying set of items changed unexpectedly. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoOpticalMonitorMIB	1.3.6.1.4.1.9.9.264			This MIB module defines objects to monitor optical characteristics and set corresponding thresholds on the optical interfaces in a network element.
cOpticalMonitorMIBObjects	1.3.6.1.4.1.9.9.264.1
cOpticalMonGroup	1.3.6.1.4.1.9.9.264.1.1
cOpticalMonTable	1.3.6.1.4.1.9.9.264.1.1.1		not-accessible	This table provides objects to monitor optical parameters in a network element. It also provides objects for setting high and low threshold levels, with configurable severities, on these monitored parameters.
cOpticalMonEntry	1.3.6.1.4.1.9.9.264.1.1.1.1		not-accessible	An entry in the cOpticalMonTable provides objects to monitor an optical parameter and set threshold levels on that parameter, at an optical interface. Note that the set of monitored optical parameters may vary based on interface type, direction, and monitoring location. Examples of interfaces that can have an entry in this table include optical transceivers, interfaces before and after optical amplifiers, and interfaces before and after optical attenuators.
OPT cOpticalMonDirection	1.3.6.1.4.1.9.9.264.1.1.1.1.1	OpticalIfDirection	not-accessible	This object indicates the direction monitored for the optical interface, in this entry.
OPT cOpticalMonLocation	1.3.6.1.4.1.9.9.264.1.1.1.1.2	OpticalIfMonLocation	not-accessible	This object indicates whether the optical characteristics are measured before or after adjustment (e.g. optical amplification or attenuation), at this interface.
OPT cOpticalMonParameterType	1.3.6.1.4.1.9.9.264.1.1.1.1.3	OpticalParameterType	not-accessible	This object specifies the optical parameter that is being monitored in this entry.
OPT cOpticalParameterValue	1.3.6.1.4.1.9.9.264.1.1.1.1.4	OpticalParameterValue	read-only	This object gives the value measured for the particular optical parameter specified by the cOpticalMonParameterType object.
OPT cOpticalParamHighAlarmThresh	1.3.6.1.4.1.9.9.264.1.1.1.1.5	OpticalParameterValue	read-write	This object is used to set a high alarm threshold on the optical parameter being monitored. An alarm condition will be raised if the value given by cOpticalParameterValue goes from below the value configured in this object to above the value configured in this object, or if the initial value of cOpticalParameterValue exceeds the value configured in this object. For network elements that incorporate a soak time in the status indications, this alarm will be indicated in the cOpticalParamAlarmStatus object only after it persists for a period of time that equals the set soak interval. The severity level of the alarm is specified by the cOpticalParamHighAlarmSev object. When the cOpticalMonParameterType object is set to 'power' for the receive direction at a transceiver, this object specifies the receiver saturation level.
OPT cOpticalParamHighAlarmSev	1.3.6.1.4.1.9.9.264.1.1.1.1.6	OpticalAlarmSeverity	read-write	This object is used to specify a severity level associated with the high alarm threshold given by the cOpticalParamHighAlarmThresh object. The values 'notAlarmed', 'notReported', and 'cleared' do not apply. The severity level configured in this object must be higher than the level configured in the cOpticalParamHighWarningSev object.
OPT cOpticalParamHighWarningThresh	1.3.6.1.4.1.9.9.264.1.1.1.1.7	OpticalParameterValue	read-write	This object is used to set a high warning threshold on the optical parameter being monitored. A threshold crossing condition will be indicated if the value given by cOpticalParameterValue goes from below the value configured in this object to above the value configured in this object, or if the initial value of cOpticalParameterValue exceeds the value configured in this object. For network elements that incorporate a soak time in the status indications, this threshold violation will be indicated in the cOpticalParamAlarmStatus object only after it persists for a period of time that equals the set soak interval. This threshold crossing may or may not be alarmed or reported, based on the severity level specified by the cOpticalParamHighWarningSev object.
OPT cOpticalParamHighWarningSev	1.3.6.1.4.1.9.9.264.1.1.1.1.8	OpticalAlarmSeverity	read-write	This object is used to specify a severity level associated with the high warning threshold given by the cOpticalParamHighWarningThresh object. The values 'critical', 'major', and 'cleared' do not apply. The severity level configured in this object must be lower than the level configured in the cOpticalParamHighAlarmSev object. If this object is set to 'notReported', no notifications will be generated when this threshold is exceeded, irrespective of the value configured in the cOpticalNotifyEnable object.
OPT cOpticalParamLowAlarmThresh	1.3.6.1.4.1.9.9.264.1.1.1.1.9	OpticalParameterValue	read-write	This object is used to set a low alarm threshold on the optical parameter being monitored. An alarm condition will be raised if the value given by cOpticalParameterValue goes from above the value configured in this object to below the value configured in this object, or if the initial value of cOpticalParameterValue is lower than the value configured in this object. For network elements that incorporate a soak time in the status indications, this alarm will be indicated in the cOpticalParamAlarmStatus object only after it persists for a period of time that equals the set soak interval. The severity level of this alarm is specified by the cOpticalParamLowAlarmSev object. When the cOpticalMonParameterType object is set to 'power' for the receive direction and when the interface supports alarms based on loss of light, this object specifies the optical power threshold for declaring loss of light. Also, when optical amplifiers are present in the network, in the receive direction, this value may need to be configured, since the noise floor may be higher than the minimum sensitivity of the receiver.
OPT cOpticalParamLowAlarmSev	1.3.6.1.4.1.9.9.264.1.1.1.1.10	OpticalAlarmSeverity	read-write	This object is used to specify a severity level associated with the low alarm threshold given by the cOpticalParamLowAlarmThresh object. The values 'notAlarmed', 'notReported', and 'cleared' do not apply. The severity level configured in this object must be higher than the level configured in the cOpticalParamLowWarningSev object.
OPT cOpticalParamLowWarningThresh	1.3.6.1.4.1.9.9.264.1.1.1.1.11	OpticalParameterValue	read-write	This object is used to set a low warning threshold on the optical parameter being monitored. A threshold crossing condition will be indicated if the value given by cOpticalParameterValue goes from above the value configured in this object to below the value configured in this object, or if the initial value of cOpticalParameterValue object is lower than the value configured in this object. For network elements that incorporate a soak time in the status indications, this threshold violation will be indicated in the cOpticalParamAlarmStatus object only after it persists for a period of time that equals the set soak interval. This threshold crossing may or may not be alarmed or reported, based on the severity level specified by the cOpticalParamLowWarningSev object.
OPT cOpticalParamLowWarningSev	1.3.6.1.4.1.9.9.264.1.1.1.1.12	OpticalAlarmSeverity	read-write	This object is used to specify a severity level associated with the low warning threshold given by the cOpticalParamLowWarningThresh object. The values 'critical', 'major', and 'cleared' do not apply. The severity level configured in this object must be lower than the level configured in the cOpticalParamLowAlarmSev object. If this object is set to 'notReported', no notifications will be generated when this threshold is exceeded, irrespective of the value configured in the cOpticalNotifyEnable object.
OPT cOpticalParamAlarmStatus	1.3.6.1.4.1.9.9.264.1.1.1.1.13	OpticalAlarmStatus	read-only	This object is used to indicate the current status of the thresholds for the monitored optical parameter on the interface. If a threshold is currently being exceeded on the interface, the corresponding bit in this object will be set to 1. Otherwise, the bit will be set to 0.
OPT cOpticalParamAlarmCurMaxThresh	1.3.6.1.4.1.9.9.264.1.1.1.1.14	OpticalParameterValue	read-only	This object indicates the threshold value of the highest severity threshold that is currently being exceeded on the interface, for the optical parameter. If no threshold value is currently being exceeded, then the value '-1000000' is returned.
OPT cOpticalParamAlarmCurMaxSev	1.3.6.1.4.1.9.9.264.1.1.1.1.15	OpticalAlarmSeverity	read-only	This object indicates the maximum severity of any thresholds that are currently being exceeded on the interface, for the optical parameter.
TIM cOpticalParamAlarmLastChange	1.3.6.1.4.1.9.9.264.1.1.1.1.16	TimeStamp	read-only	This object specifies the value of sysUpTime at the last time a threshold related to a particular optical parameter was exceeded or cleared on the interface.
U32 cOpticalMon15MinValidIntervals	1.3.6.1.4.1.9.9.264.1.1.1.1.17	Unsigned32	read-only	This object gives the number of previous 15 minute intervals for which valid performance monitoring data has been stored on the interface. The value of this object will be n (where n is the maximum number of 15 minute intervals supported at this interface), unless the measurement was (re-)started within the last (nx15) minutes, in which case the value will be the number of previous 15 minute intervals for which the agent has some data.
U32 cOpticalMon24HrValidIntervals	1.3.6.1.4.1.9.9.264.1.1.1.1.18	Unsigned32	read-only	This object gives the number of previous 24 hour intervals for which valid performance monitoring data has been stored on the interface. The value of this object will be 0 if the measurement was (re-)started within the last 24 hours, or 1 otherwise.
BIT cOpticalParamThreshSource	1.3.6.1.4.1.9.9.264.1.1.1.1.19	Bits	read-write	This object indicates if the current value of a particular threshold in this entry is user configured value or it is a system default value. It also allows user to specify the list of thresholds for this entry which should be restored to their system default values. The bit 'highAlarmThresh' corresponds to the object cOpticalParamHighAlarmThresh. The bit 'highWarnThresh' corresponds to the object cOpticalParamHighWarningThresh. The bit 'lowAlarmThresh' corresponds to the object cOpticalParamLowAlarmThresh. The bit 'lowWarnThresh' corresponds to the object cOpticalParamLowWarningThresh. A value of 0 for a bit indicates that corresponding object has system default value of threshold. A value of 1 for a bit indicates that corresponding object has user configured threshold value. A user may only change value of each of the bits to zero. Setting a bit to 0 will reset the corresponding threshold to its default value. System will change a bit from 0 to 1 when its corresponding threshold is changed by user from its default to any other value.
OPT cOpticalNotifyEnable	1.3.6.1.4.1.9.9.264.1.1.2	OpticalAlarmSeverityOrZero	read-write	This object specifies the minimum severity threshold governing the generation of cOpticalMonParameterStatus notifications. For example, if the value of this object is set to 'major', then the agent generates these notifications if and only if the severity of the alarm being indicated is 'major' or 'critical'. The values of 'notReported', and 'cleared' do not apply. The value of '0' disables the generation of notifications.
BIT cOpticalMonEnable	1.3.6.1.4.1.9.9.264.1.1.3	Bits	read-write	This object specifies the types of transceivers for which optical monitoring is enabled. A value of 1 for the bit 'all', specifies that optical monitoring functionality is enabled for all the types of transceivers which are supported by system and have optical monitoring capability.
U32 cOpticalMonPollInterval	1.3.6.1.4.1.9.9.264.1.1.4	Unsigned32	read-write	This object specifies the interval in minutes after which optical transceiver data will be polled by system repeatedly and updated in cOpticalMonTable when one or more bits in cOpticalMonEnable is set.
cOpticalMonIfTable	1.3.6.1.4.1.9.9.264.1.1.5		not-accessible	This table contains the list of optical interfaces populated in cOpticalMonTable.
cOpticalMonIfEntry	1.3.6.1.4.1.9.9.264.1.1.5.1		not-accessible	An entry containing the information for a particular optical interface.
U32 cOpticalMonIfTimeInSlot	1.3.6.1.4.1.9.9.264.1.1.5.1.1	Unsigned32	read-only	This object indicates when this optical transceiver was detected by the system.
cOpticalPMGroup	1.3.6.1.4.1.9.9.264.1.2
cOpticalPMCurrentTable	1.3.6.1.4.1.9.9.264.1.2.1		not-accessible	This table contains performance monitoring data for the various optical parameters, collected over the current 15 minute or the current 24 hour interval.
cOpticalPMCurrentEntry	1.3.6.1.4.1.9.9.264.1.2.1.1		not-accessible	An entry in the cOpticalPMCurrentTable. It contains performance monitoring data for a monitored optical parameter at an interface, collected over the current 15 minute or the current 24 hour interval. Note that the set of monitored optical parameters may vary based on interface type, direction, and monitoring location. Examples of interfaces that can have an entry in this table include optical transceivers, interfaces before and after optical amplifiers, and interfaces before and after optical attenuators.
OPT cOpticalPMCurrentPeriod	1.3.6.1.4.1.9.9.264.1.2.1.1.1	OpticalPMPeriod	not-accessible	This object indicates whether the optical parameter values given in this entry are collected over the current 15 minute or the current 24 hour interval.
OPT cOpticalPMCurrentDirection	1.3.6.1.4.1.9.9.264.1.2.1.1.2	OpticalIfDirection	not-accessible	This object indicates the direction monitored for the optical interface, in this entry.
OPT cOpticalPMCurrentLocation	1.3.6.1.4.1.9.9.264.1.2.1.1.3	OpticalIfMonLocation	not-accessible	This object indicates whether the optical characteristics are measured before or after adjustment (e.g. optical amplification or attenuation), at this interface.
OPT cOpticalPMCurrentParamType	1.3.6.1.4.1.9.9.264.1.2.1.1.4	OpticalParameterType	not-accessible	This object specifies the optical parameter that is being monitored, in this entry.
OPT cOpticalPMCurrentMaxParam	1.3.6.1.4.1.9.9.264.1.2.1.1.5	OpticalParameterValue	read-only	This object gives the maximum value measured for the monitored optical parameter, in the current 15 minute or the current 24 hour interval.
OPT cOpticalPMCurrentMinParam	1.3.6.1.4.1.9.9.264.1.2.1.1.6	OpticalParameterValue	read-only	This object gives the minimum value measured for the monitored optical parameter, in the current 15 minute or the current 24 hour interval.
OPT cOpticalPMCurrentMeanParam	1.3.6.1.4.1.9.9.264.1.2.1.1.7	OpticalParameterValue	read-only	This object gives the average value of the monitored optical parameter, in the current 15 minute or the current 24 hour interval.
I32 cOpticalPMCurrentUnavailSecsEx	1.3.6.1.4.1.9.9.264.1.2.1.1.8	Integer32	read-only	This object is used to indicate the number of seconds, in the current 15 minute or the current 24 hour interval, for which the optical performance data is not accounted for. In the receive direction, the performance data could be unavailable during these periods for multiple reasons like the interface being administratively down or if there is a Loss of Light alarm on the interface. In the transmit direction, performance data could be unavailable when the laser is shutdown.
cOpticalPMIntervalTable	1.3.6.1.4.1.9.9.264.1.2.2		not-accessible	This table stores performance monitoring data for the various optical parameters, collected over previous intervals. This table can have entries for one complete 24 hour interval and up to 96 complete 15 minute intervals. A system is required to store at least 4 completed 15 minute intervals. The number of valid 15 minute intervals in this table is indicated by the cOpticalMon15MinValidIntervals object and the number of valid 24 hour intervals is indicated by the cOpticalMon24HrValidIntervals object.
cOpticalPMIntervalEntry	1.3.6.1.4.1.9.9.264.1.2.2.1		not-accessible	An entry in the cOpticalPMIntervalTable. It contains performance monitoring data for an optical parameter, collected over a previous interval. Note that the set of monitored optical parameters may vary based on interface type, direction, and monitoring location. Examples of interfaces that can have an entry in this table include optical transceivers, interfaces before and after optical amplifiers, and interfaces before and after optical attenuators.
OPT cOpticalPMIntervalPeriod	1.3.6.1.4.1.9.9.264.1.2.2.1.1	OpticalPMPeriod	not-accessible	This object indicates whether the optical parameter values, given in this entry, are collected over a period of 15 minutes or 24 hours.
I32 cOpticalPMIntervalNumber	1.3.6.1.4.1.9.9.264.1.2.2.1.2	Integer32	not-accessible	A number between 1 and 96, which identifies the interval for which the set of optical parameter values is available. The interval identified by 1 is the most recently completed 15 minute or 24 hour interval, and the interval identified by N is the interval immediately preceding the one identified by N-1.
OPT cOpticalPMIntervalDirection	1.3.6.1.4.1.9.9.264.1.2.2.1.3	OpticalIfDirection	not-accessible	This object indicates the direction monitored for the optical interface, in this entry.
OPT cOpticalPMIntervalLocation	1.3.6.1.4.1.9.9.264.1.2.2.1.4	OpticalIfMonLocation	not-accessible	This object indicates whether the optical characteristics are measured before or after adjustment (e.g. optical amplification or attenuation), at this interface.
OPT cOpticalPMIntervalParamType	1.3.6.1.4.1.9.9.264.1.2.2.1.5	OpticalParameterType	not-accessible	This object specifies the optical parameter that is being monitored, in this entry.
OPT cOpticalPMIntervalMaxParam	1.3.6.1.4.1.9.9.264.1.2.2.1.6	OpticalParameterValue	read-only	This object gives the maximum value measured for the optical parameter, in a particular 15 minute or 24 hour interval.
OPT cOpticalPMIntervalMinParam	1.3.6.1.4.1.9.9.264.1.2.2.1.7	OpticalParameterValue	read-only	This object gives the minimum value measured for the optical parameter, in a particular 15 minute or 24 hour interval.
OPT cOpticalPMIntervalMeanParam	1.3.6.1.4.1.9.9.264.1.2.2.1.8	OpticalParameterValue	read-only	This object gives the average value of the measured optical parameter, in a particular 15 minute or 24 hour interval.
I32 cOpticalPMIntervalUnavailSecs	1.3.6.1.4.1.9.9.264.1.2.2.1.9	Integer32	read-only	This object is used to indicate the number of seconds, in the particular 15 minute or 24 hour interval, for which the optical performance data is not accounted for. In the receive direction, the performance data could be unavailable during these periods for multiple reasons like the interface being administratively down or if there is a Loss of Light alarm on the interface. In the transmit direction, performance data could be unavailable when the laser is shutdown.
cOpticalMonitorMIBNotifications	1.3.6.1.4.1.9.9.264.2
cOpticalMonNotificationPrefix	1.3.6.1.4.1.9.9.264.2.0
NTF cOpticalMonParameterStatus	1.3.6.1.4.1.9.9.264.2.0.1			This notification is sent when any threshold related to an optical parameter is exceeded or cleared on an interface. This notification may be suppressed under the following conditions: - depending on the value of the cOpticalNotifyEnable object, or - if the severity of the threshold as specified by the cOpticalParamHighWarningSev or cOpticalParamLowWarningSev object is 'notReported'.
cOpticalMonitorMIBConformance	1.3.6.1.4.1.9.9.264.3
cOpticalMonitorMIBCompliances	1.3.6.1.4.1.9.9.264.3.1
cOpticalMonitorMIBCompliance	1.3.6.1.4.1.9.9.264.3.1.1			The compliance statement for network elements that monitor optical characteristics and set thresholds on the optical interfaces in a network element.
cOpticalMonitorMIBComplianceRev	1.3.6.1.4.1.9.9.264.3.1.2			The compliance statement for network elements that monitor optical characteristics and set thresholds on the optical interfaces in a network element.
cOpticalMonitorMIBGroups	1.3.6.1.4.1.9.9.264.3.2
cOpticalMIBMonGroup	1.3.6.1.4.1.9.9.264.3.2.1			A mandatory object that provides monitoring of optical characteristics.
cOpticalMIBThresholdGroup	1.3.6.1.4.1.9.9.264.3.2.2			A collection of objects that support thresholds on optical parameters and provide status information when the thresholds are exceeded or cleared.
cOpticalMIBSeverityGroup	1.3.6.1.4.1.9.9.264.3.2.3			A collection of objects that support severities for thresholds on optical parameters.
cOpticalMIBPMGroup	1.3.6.1.4.1.9.9.264.3.2.4			A collection of objects that provide optical performance monitoring data for 15 minute and 24 hour intervals.
cOpticalMIBNotifyEnableGroup	1.3.6.1.4.1.9.9.264.3.2.5			An object to control the generation of notifications.
cOpticalMIBNotifGroup	1.3.6.1.4.1.9.9.264.3.2.6			A notification generated when a threshold on an optical parameter is exceeded or cleared.
cOpticalMonIfTimeGroup	1.3.6.1.4.1.9.9.264.3.2.7			A collection of object(s) that provide time related information for transceivers in the system.
cOpticalMIBEnableConfigGroup	1.3.6.1.4.1.9.9.264.3.2.8			A collection of object(s) to enable/disable optical monitoring.
cOpticalMIBIntervalConfigGroup	1.3.6.1.4.1.9.9.264.3.2.9			A collection of object(s) to specify polling interval for monitoring optical transceivers.
cOpticalMonThreshSourceGroup	1.3.6.1.4.1.9.9.264.3.2.10			A collection of object(s) to restore a given threshold to its default value.

RFC description

Monitors optical parameters on Cisco interfaces such as power, temperature, and bias current with configurable thresholds and measurement intervals.

Start monitoring Cisco DWDM optical transport platforms with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download CISCO-OPTICAL-MONITOR-MIB