mibs/MIBS/cisco/CISCO-OPTICAL-MONITOR-MIB
2023-12-05 12:25:34 +01:00

1352 lines
50 KiB
Plaintext

-- *****************************************************************
-- CISCO-OPTICAL-MONITOR-MIB.my
--
-- May 2002, Sonal Maheshwari, Mickey Spiegel
--
-- Copyright (c) 2002,-2007 by Cisco Systems, Inc.
--
-- All rights reserved.
-- ****************************************************************
CISCO-OPTICAL-MONITOR-MIB DEFINITIONS ::= BEGIN
IMPORTS
Integer32,
Unsigned32,
MODULE-IDENTITY,
NOTIFICATION-TYPE,
OBJECT-TYPE
FROM SNMPv2-SMI
MODULE-COMPLIANCE,
NOTIFICATION-GROUP,
OBJECT-GROUP
FROM SNMPv2-CONF
TEXTUAL-CONVENTION,
TimeStamp
FROM SNMPv2-TC
ifIndex
FROM IF-MIB
ciscoMgmt
FROM CISCO-SMI;
ciscoOpticalMonitorMIB MODULE-IDENTITY
LAST-UPDATED "200701020000Z"
ORGANIZATION "Cisco Systems, Inc."
CONTACT-INFO
"Cisco Systems
Customer Service
Postal: 170 W Tasman Drive
San Jose, CA 95134
Tel: +1 800 553-NETS
E-mail: cs-dwdm@cisco.com"
DESCRIPTION
"This MIB module defines objects to monitor optical
characteristics and set corresponding thresholds on the
optical interfaces in a network element.
"
REVISION "200701020000Z"
DESCRIPTION
"Add cOpticalMonIfTimeGroup,
cOpticalMIBEnableConfigGroup,
cOpticalMIBIntervalConfigGroup,
cOpticalMonThreshSourceGroup."
REVISION "200205100000Z"
DESCRIPTION
"The initial revision of this MIB."
::= { ciscoMgmt 264 }
-- Textual Conventions
OpticalParameterType ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"This value indicates the optical parameter that is
being monitored. Valid values are -
power (1) : Optical Power (AC + DC) in 1/10ths of dBm
acPower (2) : Optical AC Power in 1/10ths of dBm
ambientTemp (3) : Ambient Temperature in 1/10ths of degrees
centigrade
laserTemp (4) : Laser Temperature in 1/10ths of degrees
centigrade
biasCurrent (5) : Laser bias current in 100s of microamperes
peltierCurrent (6) : Laser peltier current in milliamperes
xcvrVoltage (7) : Transceiver voltage in millivolts
"
SYNTAX INTEGER {
power(1),
acPower(2),
ambientTemp(3),
laserTemp(4),
biasCurrent(5),
peltierCurrent(6),
xcvrVoltage(7)
}
OpticalParameterValue ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The value of the optical parameter that is being monitored.
The range of values varies depending on the type of optical
parameter being monitored, as identified by a corresponding
object with syntax OpticalParameterType.
When the optical parameter being monitored is 'power' or
'acPower', the supported range is from -400 to 250, in
1/10ths of dBm.
Example: A value of -300 represents a power level of -30.0 dBm.
When the optical parameter being monitored is 'laserTemp' or
'ambientTemp', the supported range is from -500 to 850, in
1/10ths of degrees centigrade.
Example: A value of 235 represents a temperature reading of
23.5 degrees C.
When the optical parameter being monitored is 'biasCurrent',
the supported range is from 0 to 10000, in 100s of
microamperes.
Example: A value of 500 represents a bias current reading of
50,000 microamperes.
When the optical parameter being monitored is 'peltierCurrent',
the supported range is from -10000 to 10000, in milliamperes.
When the optical parameter being monitored is 'xcvrVoltage',
the supported range is from 0 to 10000, in millivolts.
The distinguished value of '-1000000' indicates that the object
has not yet been initialized or does not apply.
"
SYNTAX Integer32 (-1000000..1000000 )
OpticalIfDirection ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"This value indicates the direction being monitored at
the optical interface.
"
SYNTAX INTEGER {
receive(1),
transmit(2),
notApplicable(3)
}
OpticalIfMonLocation ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"This value applies when there are multiple points
at which optical characteristics can be measured, in the
given direction, at an interface. It indicates whether the
optical characteristics are measured before or after
adjustment (e.g. optical amplification or attenuation).
The codepoint 'notApplicable' should be used if no
amplifier/attenuator exists at an interface.
"
SYNTAX INTEGER {
beforeAdjustment(1),
afterAdjustment(2),
notApplicable(3)
}
OpticalAlarmStatus ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"A bitmap that indicates the current status of thresholds
on an interface. The bit is set to 1 if the threshold is
currently being exceeded on the interface and will be set to 0
otherwise.
(MSB) (LSB)
7 6 5 4 3 2 1 0
+----------------------+
| |
+----------------------+
| | | |
| | | +-- High alarm threshold
| | +----- High warning threshold
| +-------- Low alarm threshold
+----------- Low warning threshold
To minimize the probability of prematurely reacting to
momentary signal variations, a soak time may be incorporated
into the status indications in the following manner.
The indication is set when the threshold violation persists
for a period of time that exceeds the set soak interval.
The indication is cleared when no threshold violation occurs
for a period of time which exceeds the clear soak interval.
In GR-2918-CORE, the recommended set soak interval is 2.5
seconds (plus/minus 0.5 seconds), and the recommended clear
soak interval is 10 seconds (plus/minus 0.5 seconds).
"
REFERENCE
"Telcordia Technologies Generic Requirements
GR-2918-CORE, Issue 4, December 1999, Section 8.11"
SYNTAX OCTET STRING (SIZE (1))
OpticalAlarmSeverity ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The severity of a trouble condition. A smaller enumerated
integer value indicates that the condition is more severe.
The severities are defined as follows:
'critical' An alarm used to indicate a severe,
service-affecting condition has occurred and that
immediate corrective action is imperative,
regardless of the time of day or day of the week.
'major' An alarm used for hardware or software conditions
that indicate a serious disruption of service or
malfunctioning or failure of important hardware.
These troubles require the immediate attention and
response of a technician to restore or maintain
system capability. The urgency is less than in
critical situations because of a lesser immediate
or impending effect on service or system
performance.
'minor' An alarm used for troubles that do not have a
serious effect on service to customers or for
troubles in hardware that are not essential to
the operation of the system.
'notAlarmed' An event used for troubles that do not require
action, for troubles that are reported as a
result of manually initiated diagnostics, or for
transient events such as crossing warning
thresholds. This event can also be used to
raise attention to a condition that could
possibly be an impending problem.
'notReported' An event used for troubles similar to those
described under 'notAlarmed', and that
do not cause notifications to be generated. The
information for these events is retrievable from
the network element.
'cleared' This value indicates that a previously
occuring alarm condition has been cleared, or
that no trouble condition is present.
"
REFERENCE
"Telcordia Technologies Generic Requirements
GR-474-CORE, Issue 1, December 1997, Section 2.2"
SYNTAX INTEGER {
critical(1),
major(2),
minor(3),
notAlarmed(4),
notReported(5),
cleared(6)
}
OpticalAlarmSeverityOrZero ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"A value of either '0' or a valid optical alarm severity."
SYNTAX INTEGER (0..6)
OpticalPMPeriod ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"This value indicates the time period over which performance
monitoring data has been collected."
SYNTAX INTEGER {
fifteenMin(1),
twentyFourHour(2)
}
-- MIB Object Definitions
cOpticalMonitorMIBObjects OBJECT IDENTIFIER
::= { ciscoOpticalMonitorMIB 1 }
-- groups in this MIB module
cOpticalMonGroup OBJECT IDENTIFIER
::= { cOpticalMonitorMIBObjects 1 }
cOpticalPMGroup OBJECT IDENTIFIER
::= { cOpticalMonitorMIBObjects 2 }
-- cOpticalMonTable
cOpticalMonTable OBJECT-TYPE
SYNTAX SEQUENCE OF COpticalMonEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonGroup 1 }
cOpticalMonEntry OBJECT-TYPE
SYNTAX COpticalMonEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"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."
INDEX {
ifIndex,
cOpticalMonDirection,
cOpticalMonLocation,
cOpticalMonParameterType
}
::= { cOpticalMonTable 1 }
COpticalMonEntry ::= SEQUENCE {
cOpticalMonDirection OpticalIfDirection,
cOpticalMonLocation OpticalIfMonLocation,
cOpticalMonParameterType OpticalParameterType,
cOpticalParameterValue OpticalParameterValue,
cOpticalParamHighAlarmThresh OpticalParameterValue,
cOpticalParamHighAlarmSev OpticalAlarmSeverity,
cOpticalParamHighWarningThresh OpticalParameterValue,
cOpticalParamHighWarningSev OpticalAlarmSeverity,
cOpticalParamLowAlarmThresh OpticalParameterValue,
cOpticalParamLowAlarmSev OpticalAlarmSeverity,
cOpticalParamLowWarningThresh OpticalParameterValue,
cOpticalParamLowWarningSev OpticalAlarmSeverity,
cOpticalParamAlarmStatus OpticalAlarmStatus,
cOpticalParamAlarmCurMaxThresh OpticalParameterValue,
cOpticalParamAlarmCurMaxSev OpticalAlarmSeverity,
cOpticalParamAlarmLastChange TimeStamp,
cOpticalMon15MinValidIntervals Unsigned32,
cOpticalMon24HrValidIntervals Unsigned32,
cOpticalParamThreshSource BITS
}
cOpticalMonDirection OBJECT-TYPE
SYNTAX OpticalIfDirection
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object indicates the direction monitored for the
optical interface, in this entry."
::= { cOpticalMonEntry 1 }
cOpticalMonLocation OBJECT-TYPE
SYNTAX OpticalIfMonLocation
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object indicates whether the optical characteristics are
measured before or after adjustment (e.g. optical amplification
or attenuation), at this interface."
::= { cOpticalMonEntry 2 }
cOpticalMonParameterType OBJECT-TYPE
SYNTAX OpticalParameterType
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object specifies the optical parameter that is being
monitored in this entry."
::= { cOpticalMonEntry 3 }
cOpticalParameterValue OBJECT-TYPE
SYNTAX OpticalParameterValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object gives the value measured for the particular
optical parameter specified by the cOpticalMonParameterType
object."
::= { cOpticalMonEntry 4 }
cOpticalParamHighAlarmThresh OBJECT-TYPE
SYNTAX OpticalParameterValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 5 }
cOpticalParamHighAlarmSev OBJECT-TYPE
SYNTAX OpticalAlarmSeverity
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 6 }
cOpticalParamHighWarningThresh OBJECT-TYPE
SYNTAX OpticalParameterValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 7 }
cOpticalParamHighWarningSev OBJECT-TYPE
SYNTAX OpticalAlarmSeverity
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 8 }
cOpticalParamLowAlarmThresh OBJECT-TYPE
SYNTAX OpticalParameterValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 9 }
cOpticalParamLowAlarmSev OBJECT-TYPE
SYNTAX OpticalAlarmSeverity
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 10 }
cOpticalParamLowWarningThresh OBJECT-TYPE
SYNTAX OpticalParameterValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 11 }
cOpticalParamLowWarningSev OBJECT-TYPE
SYNTAX OpticalAlarmSeverity
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 12 }
cOpticalParamAlarmStatus OBJECT-TYPE
SYNTAX OpticalAlarmStatus
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 13 }
cOpticalParamAlarmCurMaxThresh OBJECT-TYPE
SYNTAX OpticalParameterValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 14 }
cOpticalParamAlarmCurMaxSev OBJECT-TYPE
SYNTAX OpticalAlarmSeverity
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the maximum severity of any thresholds
that are currently being exceeded on the interface, for the
optical parameter."
::= { cOpticalMonEntry 15 }
cOpticalParamAlarmLastChange OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 16 }
cOpticalMon15MinValidIntervals OBJECT-TYPE
SYNTAX Unsigned32 (0..96 )
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 17 }
cOpticalMon24HrValidIntervals OBJECT-TYPE
SYNTAX Unsigned32 (0..1 )
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 18 }
cOpticalParamThreshSource OBJECT-TYPE
SYNTAX BITS {
highAlarmDefThresh(0),
highWarnDefThresh(1),
lowAlarmDefThresh(2),
lowWarnDefThresh(3)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonEntry 19 }
-- Notification related objects
cOpticalNotifyEnable OBJECT-TYPE
SYNTAX OpticalAlarmSeverityOrZero
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"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."
DEFVAL { 0 }
::= { cOpticalMonGroup 2 }
-- Scalar object(s) for optical monitoring configuration.
cOpticalMonEnable OBJECT-TYPE
SYNTAX BITS {
all(0)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonGroup 3 }
cOpticalMonPollInterval OBJECT-TYPE
SYNTAX Unsigned32
UNITS "minutes"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"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."
::= { cOpticalMonGroup 4 }
-- cOpticalMonTransceiverTable
cOpticalMonIfTable OBJECT-TYPE
SYNTAX SEQUENCE OF COpticalMonIfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains the list of optical interfaces
populated in cOpticalMonTable."
::= { cOpticalMonGroup 5 }
cOpticalMonIfEntry OBJECT-TYPE
SYNTAX COpticalMonIfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry containing the information for a particular optical interface."
INDEX { ifIndex }
::= { cOpticalMonIfTable 1 }
COpticalMonIfEntry ::= SEQUENCE {
cOpticalMonIfTimeInSlot Unsigned32
}
cOpticalMonIfTimeInSlot OBJECT-TYPE
SYNTAX Unsigned32
UNITS "seconds"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates when this optical transceiver was detected by the
system."
::= { cOpticalMonIfEntry 1 }
-- cOpticalPMCurrent Table
cOpticalPMCurrentTable OBJECT-TYPE
SYNTAX SEQUENCE OF COpticalPMCurrentEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains performance monitoring data for the
various optical parameters, collected over the current 15
minute or the current 24 hour interval."
::= { cOpticalPMGroup 1 }
cOpticalPMCurrentEntry OBJECT-TYPE
SYNTAX COpticalPMCurrentEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"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."
INDEX {
cOpticalPMCurrentPeriod,
ifIndex,
cOpticalPMCurrentDirection,
cOpticalPMCurrentLocation,
cOpticalPMCurrentParamType
}
::= { cOpticalPMCurrentTable 1 }
COpticalPMCurrentEntry ::= SEQUENCE {
cOpticalPMCurrentPeriod OpticalPMPeriod,
cOpticalPMCurrentDirection OpticalIfDirection,
cOpticalPMCurrentLocation OpticalIfMonLocation,
cOpticalPMCurrentParamType OpticalParameterType,
cOpticalPMCurrentMaxParam OpticalParameterValue,
cOpticalPMCurrentMinParam OpticalParameterValue,
cOpticalPMCurrentMeanParam OpticalParameterValue,
cOpticalPMCurrentUnavailSecs Integer32
}
cOpticalPMCurrentPeriod OBJECT-TYPE
SYNTAX OpticalPMPeriod
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"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."
::= { cOpticalPMCurrentEntry 1 }
cOpticalPMCurrentDirection OBJECT-TYPE
SYNTAX OpticalIfDirection
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object indicates the direction monitored for the optical
interface, in this entry."
::= { cOpticalPMCurrentEntry 2 }
cOpticalPMCurrentLocation OBJECT-TYPE
SYNTAX OpticalIfMonLocation
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object indicates whether the optical characteristics are
measured before or after adjustment (e.g. optical amplification
or attenuation), at this interface."
::= { cOpticalPMCurrentEntry 3 }
cOpticalPMCurrentParamType OBJECT-TYPE
SYNTAX OpticalParameterType
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object specifies the optical parameter that is being
monitored, in this entry."
::= { cOpticalPMCurrentEntry 4 }
cOpticalPMCurrentMaxParam OBJECT-TYPE
SYNTAX OpticalParameterValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object gives the maximum value measured for the monitored
optical parameter, in the current 15 minute or the current
24 hour interval."
::= { cOpticalPMCurrentEntry 5 }
cOpticalPMCurrentMinParam OBJECT-TYPE
SYNTAX OpticalParameterValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object gives the minimum value measured for the monitored
optical parameter, in the current 15 minute or the current
24 hour interval."
::= { cOpticalPMCurrentEntry 6 }
cOpticalPMCurrentMeanParam OBJECT-TYPE
SYNTAX OpticalParameterValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object gives the average value of the monitored
optical parameter, in the current 15 minute or the current
24 hour interval."
::= { cOpticalPMCurrentEntry 7 }
cOpticalPMCurrentUnavailSecs OBJECT-TYPE
SYNTAX Integer32 (0..86400 )
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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."
::= { cOpticalPMCurrentEntry 8 }
-- cOpticalPMInterval Table
cOpticalPMIntervalTable OBJECT-TYPE
SYNTAX SEQUENCE OF COpticalPMIntervalEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"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."
::= { cOpticalPMGroup 2 }
cOpticalPMIntervalEntry OBJECT-TYPE
SYNTAX COpticalPMIntervalEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"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."
INDEX {
cOpticalPMIntervalPeriod,
cOpticalPMIntervalNumber,
ifIndex,
cOpticalPMIntervalDirection,
cOpticalPMIntervalLocation,
cOpticalPMIntervalParamType
}
::= { cOpticalPMIntervalTable 1 }
COpticalPMIntervalEntry ::= SEQUENCE {
cOpticalPMIntervalPeriod OpticalPMPeriod,
cOpticalPMIntervalNumber Integer32,
cOpticalPMIntervalDirection OpticalIfDirection,
cOpticalPMIntervalLocation OpticalIfMonLocation,
cOpticalPMIntervalParamType OpticalParameterType,
cOpticalPMIntervalMaxParam OpticalParameterValue,
cOpticalPMIntervalMinParam OpticalParameterValue,
cOpticalPMIntervalMeanParam OpticalParameterValue,
cOpticalPMIntervalUnavailSecs Integer32
}
cOpticalPMIntervalPeriod OBJECT-TYPE
SYNTAX OpticalPMPeriod
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object indicates whether the optical parameter values,
given in this entry, are collected over a period of 15 minutes
or 24 hours."
::= { cOpticalPMIntervalEntry 1 }
cOpticalPMIntervalNumber OBJECT-TYPE
SYNTAX Integer32 (1..96 )
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"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."
::= { cOpticalPMIntervalEntry 2 }
cOpticalPMIntervalDirection OBJECT-TYPE
SYNTAX OpticalIfDirection
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object indicates the direction monitored for the optical
interface, in this entry."
::= { cOpticalPMIntervalEntry 3 }
cOpticalPMIntervalLocation OBJECT-TYPE
SYNTAX OpticalIfMonLocation
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object indicates whether the optical characteristics
are measured before or after adjustment (e.g.
optical amplification or attenuation), at this interface."
::= { cOpticalPMIntervalEntry 4 }
cOpticalPMIntervalParamType OBJECT-TYPE
SYNTAX OpticalParameterType
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object specifies the optical parameter that is being
monitored, in this entry."
::= { cOpticalPMIntervalEntry 5 }
cOpticalPMIntervalMaxParam OBJECT-TYPE
SYNTAX OpticalParameterValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object gives the maximum value measured for the optical
parameter, in a particular 15 minute or 24 hour interval."
::= { cOpticalPMIntervalEntry 6 }
cOpticalPMIntervalMinParam OBJECT-TYPE
SYNTAX OpticalParameterValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object gives the minimum value measured for the optical
parameter, in a particular 15 minute or 24 hour interval."
::= { cOpticalPMIntervalEntry 7 }
cOpticalPMIntervalMeanParam OBJECT-TYPE
SYNTAX OpticalParameterValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object gives the average value of the measured optical
parameter, in a particular 15 minute or 24 hour interval."
::= { cOpticalPMIntervalEntry 8 }
cOpticalPMIntervalUnavailSecs OBJECT-TYPE
SYNTAX Integer32 (0..86400 )
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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."
::= { cOpticalPMIntervalEntry 9 }
-- Notifications
cOpticalMonitorMIBNotifications OBJECT IDENTIFIER
::= { ciscoOpticalMonitorMIB 2 }
cOpticalMonNotificationPrefix OBJECT IDENTIFIER
::= { cOpticalMonitorMIBNotifications 0 }
cOpticalMonParameterStatus NOTIFICATION-TYPE
OBJECTS {
cOpticalParameterValue,
cOpticalParamAlarmStatus,
cOpticalParamAlarmCurMaxThresh,
cOpticalParamAlarmCurMaxSev,
cOpticalParamAlarmLastChange
}
STATUS current
DESCRIPTION
"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'.
"
::= { cOpticalMonNotificationPrefix 1 }
-- MIB Conformance Statements
cOpticalMonitorMIBConformance OBJECT IDENTIFIER
::= { ciscoOpticalMonitorMIB 3 }
cOpticalMonitorMIBCompliances OBJECT IDENTIFIER
::= { cOpticalMonitorMIBConformance 1 }
cOpticalMonitorMIBGroups OBJECT IDENTIFIER
::= { cOpticalMonitorMIBConformance 2 }
cOpticalMonitorMIBCompliance MODULE-COMPLIANCE
STATUS deprecated
DESCRIPTION
"The compliance statement for network elements that
monitor optical characteristics and set thresholds on the
optical interfaces in a network element."
MODULE -- this module
MANDATORY-GROUPS { cOpticalMIBMonGroup }
GROUP cOpticalMIBThresholdGroup
DESCRIPTION
"This group is required for network elements that support
thresholds on optical parameters."
GROUP cOpticalMIBSeverityGroup
DESCRIPTION
"This group is required for network elements that support
severities for thresholds on optical parameters."
GROUP cOpticalMIBPMGroup
DESCRIPTION
"This group is required for network elements that
support collection of optical performance monitoring
data for 15 minute or 24 hour intervals."
GROUP cOpticalMIBNotifyEnableGroup
DESCRIPTION
"This group is required for network elements that
support the cOpticalMIBNotifGroup."
GROUP cOpticalMIBNotifGroup
DESCRIPTION
"This group is required for network elements that
generate notifications when a threshold is exceeded or
cleared on an interface."
OBJECT cOpticalParamHighAlarmThresh
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamHighWarningThresh
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamLowAlarmThresh
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamLowWarningThresh
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamHighAlarmSev
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamHighWarningSev
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamLowAlarmSev
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamLowWarningSev
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
::= { cOpticalMonitorMIBCompliances 1 }
cOpticalMonitorMIBComplianceRev MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for network elements that
monitor optical characteristics and set thresholds on the
optical interfaces in a network element."
MODULE -- this module
MANDATORY-GROUPS { cOpticalMIBMonGroup }
GROUP cOpticalMIBThresholdGroup
DESCRIPTION
"This group is required for network elements that support
thresholds on optical parameters."
GROUP cOpticalMIBSeverityGroup
DESCRIPTION
"This group is required for network elements that support
severities for thresholds on optical parameters."
GROUP cOpticalMIBPMGroup
DESCRIPTION
"This group is required for network elements that
support collection of optical performance monitoring
data for 15 minute or 24 hour intervals."
GROUP cOpticalMonIfTimeGroup
DESCRIPTION
"This group is required for network elements that maintain
time related information for optical transceivers."
GROUP cOpticalMIBNotifyEnableGroup
DESCRIPTION
"This group is required for network elements that
support the cOpticalMIBNotifGroup."
GROUP cOpticalMIBNotifGroup
DESCRIPTION
"This group is required for network elements that
generate notifications when a threshold is exceeded or
cleared on an interface."
GROUP cOpticalMIBEnableConfigGroup
DESCRIPTION
"This group is required for network elements that
are capable of enabling/disabling optical monitoring
functionality."
GROUP cOpticalMIBIntervalConfigGroup
DESCRIPTION
"This group is mandatory for network elements that
support optical monitoring polling interval
configuration."
GROUP cOpticalMonThreshSourceGroup
DESCRIPTION
"This group is mandatory for the network elements that
support restoring the optical monitoring threshold
to the default value."
OBJECT cOpticalParamHighAlarmThresh
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamHighWarningThresh
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamLowAlarmThresh
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamLowWarningThresh
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamHighAlarmSev
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamHighWarningSev
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamLowAlarmSev
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
OBJECT cOpticalParamLowWarningSev
MIN-ACCESS read-only
DESCRIPTION "Write access is not required."
::= { cOpticalMonitorMIBCompliances 2 }
-- Units of Conformance
cOpticalMIBMonGroup OBJECT-GROUP
OBJECTS { cOpticalParameterValue }
STATUS current
DESCRIPTION
"A mandatory object that provides monitoring of optical
characteristics."
::= { cOpticalMonitorMIBGroups 1 }
cOpticalMIBThresholdGroup OBJECT-GROUP
OBJECTS {
cOpticalParamHighAlarmThresh,
cOpticalParamHighWarningThresh,
cOpticalParamLowAlarmThresh,
cOpticalParamLowWarningThresh,
cOpticalParamAlarmStatus,
cOpticalParamAlarmCurMaxThresh,
cOpticalParamAlarmLastChange
}
STATUS current
DESCRIPTION
"A collection of objects that support thresholds on optical
parameters and provide status information when the thresholds
are exceeded or cleared."
::= { cOpticalMonitorMIBGroups 2 }
cOpticalMIBSeverityGroup OBJECT-GROUP
OBJECTS {
cOpticalParamHighAlarmSev,
cOpticalParamHighWarningSev,
cOpticalParamLowAlarmSev,
cOpticalParamLowWarningSev,
cOpticalParamAlarmCurMaxSev
}
STATUS current
DESCRIPTION
"A collection of objects that support severities for thresholds
on optical parameters."
::= { cOpticalMonitorMIBGroups 3 }
cOpticalMIBPMGroup OBJECT-GROUP
OBJECTS {
cOpticalMon15MinValidIntervals,
cOpticalMon24HrValidIntervals,
cOpticalPMCurrentMaxParam,
cOpticalPMCurrentMinParam,
cOpticalPMCurrentMeanParam,
cOpticalPMCurrentUnavailSecs,
cOpticalPMIntervalMaxParam,
cOpticalPMIntervalMinParam,
cOpticalPMIntervalMeanParam,
cOpticalPMIntervalUnavailSecs
}
STATUS current
DESCRIPTION
"A collection of objects that provide optical performance
monitoring data for 15 minute and 24 hour intervals."
::= { cOpticalMonitorMIBGroups 4 }
cOpticalMIBNotifyEnableGroup OBJECT-GROUP
OBJECTS { cOpticalNotifyEnable }
STATUS current
DESCRIPTION
"An object to control the generation of notifications."
::= { cOpticalMonitorMIBGroups 5 }
cOpticalMIBNotifGroup NOTIFICATION-GROUP
NOTIFICATIONS { cOpticalMonParameterStatus }
STATUS current
DESCRIPTION
"A notification generated when a threshold on an optical
parameter is exceeded or cleared."
::= { cOpticalMonitorMIBGroups 6 }
cOpticalMonIfTimeGroup OBJECT-GROUP
OBJECTS { cOpticalMonIfTimeInSlot }
STATUS current
DESCRIPTION
"A collection of object(s) that provide time related information
for transceivers in the system."
::= { cOpticalMonitorMIBGroups 7 }
cOpticalMIBEnableConfigGroup OBJECT-GROUP
OBJECTS { cOpticalMonEnable }
STATUS current
DESCRIPTION
"A collection of object(s) to enable/disable optical
monitoring."
::= { cOpticalMonitorMIBGroups 8 }
cOpticalMIBIntervalConfigGroup OBJECT-GROUP
OBJECTS { cOpticalMonPollInterval }
STATUS current
DESCRIPTION
"A collection of object(s) to specify polling interval for
monitoring optical transceivers."
::= { cOpticalMonitorMIBGroups 9 }
cOpticalMonThreshSourceGroup OBJECT-GROUP
OBJECTS { cOpticalParamThreshSource }
STATUS current
DESCRIPTION
"A collection of object(s) to restore a given threshold
to its default value."
::= { cOpticalMonitorMIBGroups 10 }
END