Graham McIntire
b4f8b40b7f
- Remove PVC volume mount from k8s/deployment.yaml - Delete k8s/mib-pvc.yaml (no longer needed) - Update .gitignore to commit MIB files to git - Add mix import_mibs task to copy MIBs from LibreNMS - Add all MIB files from priv/mibs/ to git This fixes the multi-attach volume error in Kubernetes where new pods couldn't start because the RWO (ReadWriteOnce) PVC was attached to the old pod. MIBs are now part of the Docker image and can be used by all pods simultaneously.
882 lines
31 KiB
Text
882 lines
31 KiB
Text
-- *****************************************************************
|
|
-- Definitions of managed objects supporting alarm monitoring.
|
|
--
|
|
-- March 1999, Patrick Gili
|
|
--
|
|
-- Copyright (c) 1999 by cisco Systems, Inc.
|
|
-- All rights reserved.
|
|
-- *****************************************************************
|
|
|
|
CISCO-ENTITY-ALARM-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
Gauge32,
|
|
MODULE-IDENTITY,
|
|
NOTIFICATION-TYPE,
|
|
OBJECT-TYPE FROM SNMPv2-SMI
|
|
TEXTUAL-CONVENTION,
|
|
AutonomousType,
|
|
DisplayString,
|
|
RowStatus,
|
|
TimeStamp,
|
|
TruthValue FROM SNMPv2-TC
|
|
MODULE-COMPLIANCE,
|
|
-- NOTIFICATION-GROUP,
|
|
OBJECT-GROUP FROM SNMPv2-CONF
|
|
SnmpAdminString FROM SNMP-FRAMEWORK-MIB
|
|
entPhysicalIndex,
|
|
PhysicalIndex FROM ENTITY-MIB
|
|
ciscoMgmt FROM CISCO-SMI
|
|
Unsigned32 FROM CISCO-TC
|
|
;
|
|
|
|
ciscoEntityAlarmMIB MODULE-IDENTITY
|
|
LAST-UPDATED "9907062150Z" -- 07/06/99 16:50 PM EDT
|
|
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-dslam@cisco.com"
|
|
DESCRIPTION
|
|
"This MIB module defines the managed objects that support the
|
|
monitoring of alarms generated by physical entities contained
|
|
by the system, including chassis, slots, modules, ports, power
|
|
supplies, and fans. In order to monitor alarms generated by a
|
|
physical entity, it must be represented by a row in the
|
|
entPhysicalTable (see ENTITY-MIB)."
|
|
::= { ciscoMgmt 138 }
|
|
|
|
AlarmType ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An arbitrary integer value that uniquely identifies an event
|
|
relative to a physical entity contained by a system."
|
|
SYNTAX INTEGER (0..255)
|
|
|
|
AlarmSeverity ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Each alarm type defined by a vendor type employed by the
|
|
system has an associated severity. Bellcore TR-NWT-000474
|
|
defines these severities 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 the
|
|
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.
|
|
|
|
'info' An indication used to raise attention to a condition
|
|
that could possibly be an impending problem or to
|
|
notify the customer of an event that improves
|
|
operation."
|
|
REFERENCE
|
|
"Bellcore Technical Reference TR-NWT-000474 Issue 4, December
|
|
1993, OTGR Section 4. Network Maintenance: Alarm and Control -
|
|
Network Element."
|
|
SYNTAX INTEGER {
|
|
critical(1),
|
|
major(2),
|
|
minor(3),
|
|
info(4)
|
|
}
|
|
|
|
AlarmSeverityOrZero ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A value of either '0' or a valid alarm severity."
|
|
SYNTAX INTEGER (0..4)
|
|
|
|
AlarmList ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"For each unique type of physical entity (i.e., for each set
|
|
of physical entities sharing a unique entPhysicalVendorType
|
|
OID), there an exists unique alarm space. Observe that it
|
|
is not necessary that all the alarms within a space be defined.
|
|
|
|
An OCTET STRING represents an alarm list, in which each
|
|
bit represents an alarm type. The bits in the first octet
|
|
represent alarm types identified by the integer values 1
|
|
through 8, inclusive, The bits in the second octet represent
|
|
alarm types identified by the integer values 9 through 16,
|
|
inclusive, and so forth. The least significant bit of an
|
|
octet represents the alarm type identified by the lowest
|
|
integer value, and the most significant bit represents the
|
|
alarm type identified by the highest integer value. The
|
|
figure shown below illustrates the format of an alarm list.
|
|
|
|
Octet 1 Octet 32
|
|
|
|
7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0
|
|
+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+
|
|
| |...| |
|
|
+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+
|
|
| | | | | | | | | | | | | | | |
|
|
| | | | | | | | | | | | | | | +- Alarm 248
|
|
| | | | | | | | | | | | | | +--- Alarm 249
|
|
| | | | | | | | | | | | | +----- Alarm 250
|
|
| | | | | | | | | | | | +------- Alarm 251
|
|
| | | | | | | | | | | +--------- Alarm 252
|
|
| | | | | | | | | | +----------- Alarm 253
|
|
| | | | | | | | | +------------- Alarm 254
|
|
| | | | | | | | +--------------- Alarm 255
|
|
| | | | | | | | :
|
|
| | | | | | | | :
|
|
| | | | | | | +--------------------- Alarm 0
|
|
| | | | | | +----------------------- Alarm 1
|
|
| | | | | +------------------------- Alarm 2
|
|
| | | | +--------------------------- Alarm 3
|
|
| | | +----------------------------- Alarm 4
|
|
| | +------------------------------- Alarm 5
|
|
| +--------------------------------- Alarm 6
|
|
+----------------------------------- Alarm 7
|
|
|
|
An alarm list of length N, where N < 32, represents an alarm
|
|
list for which alarms N*8 through 255 have the value of '0'.
|
|
A special case is an alarm list having a length of '0', which
|
|
represents an alarm list of all zeros."
|
|
SYNTAX OCTET STRING (SIZE (0..32))
|
|
|
|
AlarmFilterProfileType ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An integer value that uniquely identifies an alarm filter
|
|
profile."
|
|
SYNTAX Unsigned32
|
|
|
|
-- MIB Object Definitions
|
|
|
|
ciscoEntityAlarmMIBObjects OBJECT IDENTIFIER ::= { ciscoEntityAlarmMIB 1 }
|
|
|
|
ceAlarmDescription OBJECT IDENTIFIER ::= { ciscoEntityAlarmMIBObjects 1 }
|
|
ceAlarmMonitoring OBJECT IDENTIFIER ::= { ciscoEntityAlarmMIBObjects 2 }
|
|
ceAlarmHistory OBJECT IDENTIFIER ::= { ciscoEntityAlarmMIBObjects 3 }
|
|
ceAlarmFiltering OBJECT IDENTIFIER ::= { ciscoEntityAlarmMIBObjects 4 }
|
|
|
|
-- Alarm Description Map Table
|
|
|
|
ceAlarmDescrMapTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CeAlarmDescrMapEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"For each type of entity (represented entPhysicalVendorType
|
|
OID), this table contains a mapping between a unique
|
|
ceAlarmDescrIndex and entPhysicalvendorType OID."
|
|
::= { ceAlarmDescription 1 }
|
|
|
|
ceAlarmDescrMapEntry OBJECT-TYPE
|
|
SYNTAX CeAlarmDescrMapEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A mapping between an alarm description and a vendor type."
|
|
INDEX { ceAlarmDescrIndex }
|
|
::= { ceAlarmDescrMapTable 1 }
|
|
|
|
CeAlarmDescrMapEntry ::= SEQUENCE {
|
|
ceAlarmDescrIndex Unsigned32,
|
|
ceAlarmDescrVendorType AutonomousType
|
|
}
|
|
|
|
ceAlarmDescrIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object uniquely identifies an alarm description."
|
|
::= { ceAlarmDescrMapEntry 1 }
|
|
|
|
ceAlarmDescrVendorType OBJECT-TYPE
|
|
SYNTAX AutonomousType
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies an object identifier (typically an
|
|
enterprise-specific OID) that uniquely identifies the vendor
|
|
type of those physical entities that this alarm description
|
|
applies to."
|
|
::= { ceAlarmDescrMapEntry 2 }
|
|
|
|
-- Alarm Description Table
|
|
|
|
ceAlarmDescrTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CeAlarmDescrEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table contains a description for each alarm type
|
|
defined by each vendor type employed by the system.
|
|
Observe that this table is sparse in nature, as it is
|
|
rarely the case that a physical entity type needs to
|
|
define every alarm in its alarm space."
|
|
::= { ceAlarmDescription 2 }
|
|
|
|
ceAlarmDescrEntry OBJECT-TYPE
|
|
SYNTAX CeAlarmDescrEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of attributes that describe an alarm type."
|
|
INDEX { ceAlarmDescrIndex, ceAlarmDescrAlarmType }
|
|
::= { ceAlarmDescrTable 1 }
|
|
|
|
CeAlarmDescrEntry ::= SEQUENCE {
|
|
ceAlarmDescrAlarmType AlarmType,
|
|
ceAlarmDescrSeverity AlarmSeverityOrZero,
|
|
ceAlarmDescrText SnmpAdminString
|
|
}
|
|
|
|
ceAlarmDescrAlarmType OBJECT-TYPE
|
|
SYNTAX AlarmType
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the alarm type being described."
|
|
::= { ceAlarmDescrEntry 1 }
|
|
|
|
ceAlarmDescrSeverity OBJECT-TYPE
|
|
SYNTAX AlarmSeverityOrZero
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the severity associated with the
|
|
alarm type.
|
|
|
|
An implementation may chose to not allow dynamic severity
|
|
assignment, in which case it would restrict access to this
|
|
object to be read-only.
|
|
|
|
If an implementation allows dynamic severity assignment, then
|
|
a management client can revert to the default severity by
|
|
writing the value '0' to this object.
|
|
|
|
There exists a class of systems that should implement dynamic
|
|
severity assignment. For example, consider a DSLAM (Digital
|
|
Subscriber Loop Access Multiplexor) designed for both the
|
|
central office and pedestal environments. A 'pedestal' is
|
|
typically a dark-green metal box mounted on a concrete or stone
|
|
foundation in which carrier-class companies house equipment.
|
|
The central office typically controls the temperature and
|
|
humidity of the environment, reducing reliance on a system's
|
|
fans. Thus, the customer probably has a desire to reduce the
|
|
severity of alarms indicating the failure of a fan. However, a
|
|
pedestal environment has a much greater reliance on a system's
|
|
fans. Thus, the customer probably has a desire to increase the
|
|
severity of alarms indicating the failure of a fan."
|
|
::= { ceAlarmDescrEntry 2 }
|
|
|
|
ceAlarmDescrText OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies a human-readable message describing
|
|
the alarm."
|
|
::= { ceAlarmDescrEntry 3 }
|
|
|
|
-- Alarm Monitoring
|
|
|
|
ceAlarmCriticalCount OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object specifies the number of alarms
|
|
currently asserted with a severity of 'critical'."
|
|
::= { ceAlarmMonitoring 1 }
|
|
|
|
ceAlarmMajorCount OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object specifies the number of alarms
|
|
currently asserted with a severity of 'major'."
|
|
::= { ceAlarmMonitoring 2 }
|
|
|
|
ceAlarmMinorCount OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object specifies the number of alarms
|
|
currently asserted with a severity of 'minor'."
|
|
::= { ceAlarmMonitoring 3 }
|
|
|
|
ceAlarmCutOff OBJECT-TYPE
|
|
SYNTAX TruthValue
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"If the management client writes a value of 'true' to this
|
|
object, the agent stops signalling all external audible alarms
|
|
under the control of the agent. Reading this object should
|
|
always result in a value of 'false'.
|
|
|
|
Observe that alarm cutoff does not have an effect on monitoring,
|
|
history logging, generation of notifications, or syslog message
|
|
generation. It also does not prevent the agent from signalling
|
|
external audible alarms for alarms asserted after alarm-cutoff.
|
|
|
|
This object emulates the 'alarm cut-off' mechanism typically
|
|
installed in a central office (e.g., a big red button). Observe
|
|
this object should neither affect external visual alarms under
|
|
the control of the agent, nor should it affect the current state
|
|
of alarms being asserted by the system."
|
|
::= { ceAlarmMonitoring 4 }
|
|
|
|
-- Alarm Table
|
|
|
|
ceAlarmTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CeAlarmEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table specifies alarm control and status information
|
|
related to each physical entity contained by the system,
|
|
including the alarms currently being asserted by each physical
|
|
entity capable of generating alarms."
|
|
::= { ceAlarmMonitoring 5 }
|
|
|
|
ceAlarmEntry OBJECT-TYPE
|
|
SYNTAX CeAlarmEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Alarm control and status information related to the
|
|
corresponding physical entity, including a list of those
|
|
alarms currently being asserted by that physical entity."
|
|
INDEX { entPhysicalIndex }
|
|
::= { ceAlarmTable 1 }
|
|
|
|
CeAlarmEntry ::= SEQUENCE {
|
|
ceAlarmFilterProfile AlarmFilterProfileType,
|
|
ceAlarmSeverity AlarmSeverityOrZero,
|
|
ceAlarmList AlarmList
|
|
}
|
|
|
|
ceAlarmFilterProfile OBJECT-TYPE
|
|
SYNTAX AlarmFilterProfileType
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the alarm filter profile associated
|
|
with the corresponding physical entity. An alarm filter
|
|
profile controls which alarm types the agent will monitor
|
|
and signal for the corresponding physical entity.
|
|
|
|
If the value of this object is '0', then the agent monitors
|
|
and signals all alarms associated with the corresponding
|
|
physical entity."
|
|
::= { ceAlarmEntry 1 }
|
|
|
|
ceAlarmSeverity OBJECT-TYPE
|
|
SYNTAX AlarmSeverityOrZero
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the highest severity alarm currently
|
|
being asserted by the corresponding physical entity. A value
|
|
of '0' indicates that there the corresponding physical entity
|
|
currently is not asserting any alarms."
|
|
::= { ceAlarmEntry 2 }
|
|
|
|
ceAlarmList OBJECT-TYPE
|
|
SYNTAX AlarmList
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies those alarms currently being asserted
|
|
by the corresponding physical entity. Note, an alarm indicates
|
|
a condition, not an event. An alarm has two states:
|
|
|
|
'asserted' Indicates that the condition described by the
|
|
alarm exists.
|
|
|
|
'cleared' Indicates that the condition described by the
|
|
alarm does not exist.
|
|
|
|
For example, a slot in a chassis may define an alarm that
|
|
specifies whether the slot contains a module. At the time of
|
|
module insertion, the physical entity corresponding to the slot
|
|
asserts this alarm, and the alarm remains asserted until the
|
|
slot becomes empty.
|
|
|
|
If an alarm is being asserted by the physical entity, then the
|
|
corresponding bit in the alarm list is set to a one. Observe
|
|
that if the physical entity is not currently asserting any
|
|
alarms, then the list will have a length of zero."
|
|
::= { ceAlarmEntry 3 }
|
|
|
|
-- Alarm History Table
|
|
|
|
ceAlarmHistTableSize OBJECT-TYPE
|
|
SYNTAX INTEGER (0..500)
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the number of entries that the
|
|
ceAlarmHistTable can contain. When a physical entity
|
|
generates an unfiltered alarm, and the capacity of the
|
|
ceAlarmHistTable has reached the value specified by
|
|
this object, then the agent deletes the oldest entity in
|
|
order to accommodate the new entry. A value of '0' prevents
|
|
any history from being retained. "
|
|
::= { ceAlarmHistory 1 }
|
|
|
|
ceAlarmHistLastIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the value of the ceAlarmHistIndex
|
|
object corresponding to the last entry added to the table by the
|
|
agent.
|
|
|
|
If the management client uses the notifications defined by this
|
|
module, then it can poll this object to determine whether it has
|
|
missed a notification sent by the agent."
|
|
::= { ceAlarmHistory 2 }
|
|
|
|
ceAlarmHistTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CeAlarmHistEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table contains a history of ceAlarmIndicate and
|
|
ceAlarmClear traps generated by the agent."
|
|
::= { ceAlarmHistory 3 }
|
|
|
|
ceAlarmHistEntry OBJECT-TYPE
|
|
SYNTAX CeAlarmHistEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The information conveyed by a ceAlarmIndicate or
|
|
ceAlarmClear trap."
|
|
INDEX { ceAlarmHistIndex }
|
|
::= { ceAlarmHistTable 1 }
|
|
|
|
CeAlarmHistEntry ::= SEQUENCE {
|
|
ceAlarmHistIndex Unsigned32,
|
|
ceAlarmHistType INTEGER,
|
|
ceAlarmHistEntPhysicalIndex PhysicalIndex,
|
|
ceAlarmHistAlarmType AlarmType,
|
|
ceAlarmHistSeverity AlarmSeverity,
|
|
ceAlarmHistTimeStamp TimeStamp
|
|
}
|
|
|
|
ceAlarmHistIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An integer value uniquely identifying the entry in the table.
|
|
The value of this object starts at '1' and monotonically
|
|
increases for each alarm condition transition monitored by the
|
|
agent. If the value of this object is '4294967295', the agent
|
|
will reset it to '1' upon monitoring the next alarm condition
|
|
transition."
|
|
::= { ceAlarmHistEntry 1 }
|
|
|
|
ceAlarmHistType OBJECT-TYPE
|
|
SYNTAX INTEGER { asserted(1), cleared(2) }
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies whether the agent created the entry as
|
|
the result of an alarm being asserted or cleared."
|
|
::= { ceAlarmHistEntry 2 }
|
|
|
|
ceAlarmHistEntPhysicalIndex OBJECT-TYPE
|
|
SYNTAX PhysicalIndex
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the physical entity that generated
|
|
the alarm."
|
|
::= { ceAlarmHistEntry 3 }
|
|
|
|
ceAlarmHistAlarmType OBJECT-TYPE
|
|
SYNTAX AlarmType
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the type of alarm generated."
|
|
::= { ceAlarmHistEntry 4 }
|
|
|
|
ceAlarmHistSeverity OBJECT-TYPE
|
|
SYNTAX AlarmSeverity
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the severity of the alarm generated."
|
|
::= { ceAlarmHistEntry 5 }
|
|
|
|
ceAlarmHistTimeStamp OBJECT-TYPE
|
|
SYNTAX TimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the value of the sysUpTime object at
|
|
the time the alarm was generated."
|
|
::= { ceAlarmHistEntry 6 }
|
|
|
|
-- Alarm Filter Profile Table
|
|
|
|
ceAlarmNotifiesEnable OBJECT-TYPE
|
|
SYNTAX AlarmSeverityOrZero
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies a severity threshold governing the
|
|
generation of ceAlarmAsserted and ceAlarmCleared
|
|
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 value of '0' disables the
|
|
generation of notifications.
|
|
|
|
Observe that this setting overrides the value of the
|
|
ceAlarmFilterNotifiesEnabled object.
|
|
|
|
This object affects notification generation only; that is, it
|
|
does not affect monitoring, history logging, and syslog message
|
|
generation."
|
|
::= { ceAlarmFiltering 1 }
|
|
|
|
ceAlarmSyslogEnable OBJECT-TYPE
|
|
SYNTAX AlarmSeverityOrZero
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies a severity threshold governing the
|
|
generation of syslog messages corresponding to alarms. For
|
|
example, if the value of this object is set to 'major', then
|
|
the agent generates these a syslog message if and only if the
|
|
severity of the alarm being indicated is 'major' or 'critical'.
|
|
The value of '0' disables the generation of syslog messages
|
|
corresponding to alarms.
|
|
|
|
Observe that this setting overrides the value of the
|
|
ceAlarmFilterSyslogEnabled object.
|
|
|
|
This object affects syslog message generation only; that is, it
|
|
does not have an effect on monitoring, history logging, and
|
|
generation of notifications."
|
|
::= { ceAlarmFiltering 2 }
|
|
|
|
ceAlarmFilterProfileIndexNext OBJECT-TYPE
|
|
SYNTAX AlarmFilterProfileType
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object contains an appropriate value to be used
|
|
for ceAlarmFilterIndex when creating entries in the
|
|
ceAlarmFilterProfileTable. The value '0' indicates
|
|
that no unassigned entries are available. To obtain
|
|
a ceAlarmFilterIndex, the management client issues
|
|
a get request. The agent has the responsibility of
|
|
modifying the value of this object following each
|
|
successful get request."
|
|
::= { ceAlarmFiltering 3 }
|
|
|
|
ceAlarmFilterProfileTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CeAlarmFilterProfileEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table contains a list of alarm filter profiles."
|
|
::= { ceAlarmFiltering 4 }
|
|
|
|
ceAlarmFilterProfileEntry OBJECT-TYPE
|
|
SYNTAX CeAlarmFilterProfileEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"When a physical entity asserts/clears an alarm AND the
|
|
ceAlarmFilterProfile object is not '0', the agent applies
|
|
the specified alarm filter profile in processing the alarm.
|
|
The agent uses the following procedure in processing the
|
|
transition of an alarm condition of a given type:
|
|
|
|
1) If the alarm list specified by the alarm filter profile's
|
|
ceAlarmFilterAlarmsEnabled object specifies that the alarm
|
|
type is disabled, then the agent performs no further
|
|
processing.
|
|
|
|
2) The agent creates an entry in the ceAlarmHistTable.
|
|
|
|
3) If the alarm list specified by the alarm filter profile's
|
|
ceAlarmFilterNotifiesEnabled object specifies that the alarm
|
|
type is enabled, then the agent generates the appropriate
|
|
notification.
|
|
|
|
4) If the alarm list specified by the alarm filter profile's
|
|
ceAlarmFilterSyslogEnabled object specifies that the alarm
|
|
type is enabled, then the agent generates the appropriate
|
|
syslog message."
|
|
INDEX { ceAlarmFilterIndex }
|
|
::= { ceAlarmFilterProfileTable 1 }
|
|
|
|
CeAlarmFilterProfileEntry ::= SEQUENCE {
|
|
ceAlarmFilterIndex AlarmFilterProfileType,
|
|
ceAlarmFilterStatus RowStatus,
|
|
ceAlarmFilterAlias DisplayString,
|
|
ceAlarmFilterAlarmsEnabled AlarmList,
|
|
ceAlarmFilterNotifiesEnabled AlarmList,
|
|
ceAlarmFilterSyslogEnabled AlarmList
|
|
}
|
|
|
|
ceAlarmFilterIndex OBJECT-TYPE
|
|
SYNTAX AlarmFilterProfileType
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object uniquely identifies the alarm filter profile."
|
|
::= { ceAlarmFilterProfileEntry 1 }
|
|
|
|
ceAlarmFilterStatus OBJECT-TYPE
|
|
SYNTAX RowStatus
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object facilitates the creation, modification, or
|
|
deletion of a conceptual row in this table.
|
|
|
|
A management client can create a conceptual row in this
|
|
table by setting this object to 'createAndWait' or
|
|
'createAndGo'. If a request to create a conceptual row
|
|
in this table fails, then the system is not capable of
|
|
supporting any more alarm filters.
|
|
|
|
Before modifying a conceptual row in this table, the
|
|
management client must set this object to 'notInService'.
|
|
After modifying a conceptual row in this table, the
|
|
management client must set this object to 'active'.
|
|
This operation causes the modifications made to an
|
|
alarm filter profile to take effect.
|
|
|
|
An implementation should not allow a conceptual row in
|
|
this table to be deleted if one or more physical entities
|
|
reference it."
|
|
::= { ceAlarmFilterProfileEntry 2 }
|
|
|
|
ceAlarmFilterAlias OBJECT-TYPE
|
|
SYNTAX DisplayString
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies an arbitrary name associated with the
|
|
alarm filter profile by the management client, and provides
|
|
a non-volatile 'handle' for the alarm filter profile.
|
|
|
|
On the first instantiation of an alarm filter profile, the
|
|
value of this object is a zero-length string. However, an
|
|
agent may choose to set the value to a locally unique default
|
|
value.
|
|
|
|
If an implementation supports write access to this object,
|
|
then the agent is responsible for ensuring the retention
|
|
of any value written to this object until a management client
|
|
deletes it. The level of retention must span reboots and
|
|
reinitializations of the network management system, including
|
|
those that result in different assignments to the value of
|
|
the entPhysicalIndex associated with the physical entity."
|
|
::= { ceAlarmFilterProfileEntry 3 }
|
|
|
|
ceAlarmFilterAlarmsEnabled OBJECT-TYPE
|
|
SYNTAX AlarmList
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies a list of alarms that are enabled."
|
|
::= { ceAlarmFilterProfileEntry 4 }
|
|
|
|
ceAlarmFilterNotifiesEnabled OBJECT-TYPE
|
|
SYNTAX AlarmList
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies a list of alarms for which notification
|
|
generation is enabled."
|
|
::= { ceAlarmFilterProfileEntry 5 }
|
|
|
|
ceAlarmFilterSyslogEnabled OBJECT-TYPE
|
|
SYNTAX AlarmList
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies a list of alarms for which syslog
|
|
message generation is enabled."
|
|
::= { ceAlarmFilterProfileEntry 6 }
|
|
|
|
-- MIB Notification Definitions
|
|
|
|
ciscoEntityAlarmMIBNotificationsPrefix OBJECT IDENTIFIER ::=
|
|
{ ciscoEntityAlarmMIB 2 }
|
|
|
|
ciscoEntityAlarmMIBNotifications OBJECT IDENTIFIER ::=
|
|
{ ciscoEntityAlarmMIBNotificationsPrefix 0 }
|
|
|
|
ceAlarmAsserted NOTIFICATION-TYPE
|
|
OBJECTS {
|
|
ceAlarmHistEntPhysicalIndex,
|
|
ceAlarmHistAlarmType,
|
|
ceAlarmHistSeverity,
|
|
ceAlarmHistTimeStamp
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The agent generates this trap when a physical entity
|
|
asserts an alarm."
|
|
::= { ciscoEntityAlarmMIBNotifications 1 }
|
|
|
|
ceAlarmCleared NOTIFICATION-TYPE
|
|
OBJECTS {
|
|
ceAlarmHistEntPhysicalIndex,
|
|
ceAlarmHistAlarmType,
|
|
ceAlarmHistSeverity,
|
|
ceAlarmHistTimeStamp
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The agent generates this trap when a physical entity
|
|
clears a previously asserted alarm."
|
|
::= { ciscoEntityAlarmMIBNotifications 2 }
|
|
|
|
-- MIB Conformance Statements
|
|
|
|
ciscoEntityAlarmMIBConformance OBJECT IDENTIFIER ::=
|
|
{ ciscoEntityAlarmMIB 3 }
|
|
|
|
ciscoEntityAlarmMIBCompliances OBJECT IDENTIFIER ::=
|
|
{ ciscoEntityAlarmMIBConformance 1 }
|
|
|
|
ciscoEntityAlarmMIBGroups OBJECT IDENTIFIER ::=
|
|
{ ciscoEntityAlarmMIBConformance 2 }
|
|
|
|
ceAlarmMIBCompliance MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The compliance statement for entities that implement the
|
|
CISCO-ALARM-MIB. Implementation of this MIB module is strongly
|
|
recommended for any platform targeted for a carrier-class
|
|
environment."
|
|
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS {
|
|
ceAlarmDescriptionGroup,
|
|
ceAlarmGroup,
|
|
ceAlarmHistGroup,
|
|
-- ceAlarmNotificationsGroup,
|
|
ceAlarmFilterGroup
|
|
}
|
|
|
|
GROUP ceAlarmFilterProfileGroup
|
|
DESCRIPTION
|
|
"This group is optional."
|
|
::= { ciscoEntityAlarmMIBCompliances 1 }
|
|
|
|
ceAlarmDescriptionGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
ceAlarmDescrVendorType,
|
|
ceAlarmDescrSeverity,
|
|
ceAlarmDescrText
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of managed objects defining the description
|
|
of alarms."
|
|
::= { ciscoEntityAlarmMIBGroups 1 }
|
|
|
|
ceAlarmGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
ceAlarmCriticalCount,
|
|
ceAlarmMajorCount,
|
|
ceAlarmMinorCount,
|
|
ceAlarmCutOff,
|
|
ceAlarmFilterProfile,
|
|
ceAlarmSeverity,
|
|
ceAlarmList
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of managed objects defining alarm reporting
|
|
by physical entity."
|
|
::= { ciscoEntityAlarmMIBGroups 2 }
|
|
|
|
ceAlarmHistGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
ceAlarmHistTableSize,
|
|
ceAlarmHistLastIndex,
|
|
ceAlarmHistType,
|
|
ceAlarmHistEntPhysicalIndex,
|
|
ceAlarmHistAlarmType,
|
|
ceAlarmHistSeverity,
|
|
ceAlarmHistTimeStamp
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of managed objects defining alarm logging."
|
|
::= { ciscoEntityAlarmMIBGroups 3 }
|
|
|
|
ceAlarmFilterGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
ceAlarmNotifiesEnable,
|
|
ceAlarmSyslogEnable
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of managed objects that control the generation
|
|
of all notifications and syslog messages."
|
|
::= { ciscoEntityAlarmMIBGroups 4 }
|
|
|
|
ceAlarmFilterProfileGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
ceAlarmFilterProfileIndexNext,
|
|
ceAlarmFilterStatus,
|
|
ceAlarmFilterAlias,
|
|
ceAlarmFilterAlarmsEnabled,
|
|
ceAlarmFilterNotifiesEnabled,
|
|
ceAlarmFilterSyslogEnabled
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of managed objects that support alarm filtering."
|
|
::= { ciscoEntityAlarmMIBGroups 5 }
|
|
|
|
--ceAlarmNotificationsGroup NOTIFICATION-GROUP
|
|
-- OBJECTS {
|
|
-- ceAlarmAsserted,
|
|
-- ceAlarmCleared
|
|
-- }
|
|
-- STATUS current
|
|
-- DESCRIPTION
|
|
-- "A collection of traps generated by the agent upon alarm
|
|
-- generation (whether an alarm is being asserted or cleared)."
|
|
-- ::= { ciscoEntityAlarmMIBGroups 7 }
|
|
--
|
|
END
|
|
|