472 lines
16 KiB
Plaintext
472 lines
16 KiB
Plaintext
-- *****************************************************************
|
|
-- CISCO-ENTITY-SENSOR-HISTORY-MIB.my
|
|
--
|
|
-- February 2011, Padmanaban Venkatesan
|
|
--
|
|
-- Copyright (c) 2011 by Cisco Systems Inc.
|
|
-- All rights reserved.
|
|
--
|
|
-- *****************************************************************
|
|
|
|
CISCO-ENTITY-SENSOR-HISTORY-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY,
|
|
OBJECT-TYPE,
|
|
Gauge32,
|
|
Unsigned32
|
|
FROM SNMPv2-SMI
|
|
MODULE-COMPLIANCE,
|
|
OBJECT-GROUP
|
|
FROM SNMPv2-CONF
|
|
TimeStamp,
|
|
TEXTUAL-CONVENTION
|
|
FROM SNMPv2-TC
|
|
entPhysicalIndex
|
|
FROM ENTITY-MIB
|
|
EntitySensorValue
|
|
FROM ENTITY-SENSOR-MIB
|
|
ciscoMgmt
|
|
FROM CISCO-SMI;
|
|
|
|
|
|
ciscoEntitySensorHistoryMIB MODULE-IDENTITY
|
|
LAST-UPDATED "201103040000Z"
|
|
ORGANIZATION "Cisco Systems, Inc."
|
|
CONTACT-INFO
|
|
"Cisco Systems
|
|
Customer Service
|
|
|
|
Postal: 170 W Tasman Drive
|
|
San Jose, CA 95134
|
|
USA
|
|
|
|
Tel: +1 800 553-NETS
|
|
|
|
E-mail: cs-snmp@cisco.com"
|
|
DESCRIPTION
|
|
"This MIB module defines objects that describe collections and
|
|
measurement information for each sensor supporting historical
|
|
data collection. The sensor measurement either represents a
|
|
measured value or a SMA (Simple Moving Average) value for a
|
|
specified interval rate over a period of time.
|
|
|
|
This MIB module defines two tables relating to sensor measured
|
|
value, including:
|
|
|
|
o ceshCollectionTable - contains data describing a
|
|
collection of historic data for a sensor.
|
|
|
|
o ceshCollectionIntervalTable - contains zero or more rows
|
|
containing historic data for a sensor
|
|
|
|
The figure below illustrates the relationship between these two
|
|
tables.
|
|
|
|
+----------------------------------------------+
|
|
| ceshCollectionTable |
|
|
| +------------------------------------------+ |
|
|
| | ceshCollectionEntry | |
|
|
| | entPhysicalIndex = 3 | |
|
|
| | ceshCollectionIntervalTime = 60 | |
|
|
| | ceshCollectionIntervals = 60 | |
|
|
| | ceshCollectionInvalidIntervals = 0 |-----+
|
|
| | ceshCollectionMaxIntervals = 60 | | |
|
|
| | ceshCollectionElapsedTime = 20 | | |
|
|
| | ceshCollectionAlgorithm = 3 | | |
|
|
| +------------------------------------------+ | |
|
|
| +------------------------------------------+ | |
|
|
| | ceshCollectionEntry | | |
|
|
| | entPhysicalIndex = 3 | | |
|
|
| | ceshCollectionIntervalTime = 3660 | | |
|
|
| | ceshCollectionIntervals = 2 |------------+
|
|
| | ceshCollectionInvalidIntervals = 0 | | | |
|
|
| | ceshCollectionMaxIntervals = 60 | | | |
|
|
| | ceshCollectionElapsedTime = 20 | | | |
|
|
| | ceshCollectionAlgorithm = 4 | | | |
|
|
| +------------------------------------------+ | | |
|
|
+----------------------------------------------+ | |
|
|
| |
|
|
+----------------------------------------------+ | |
|
|
| ceshCollectionIntervalTable | | |
|
|
| +------------------------------------------+ | | |
|
|
| | ceshCollectionIntervalEntry | | | |
|
|
| | entPhysicalIndex = 3 |<----+ |
|
|
| | ceshCollectionIntervalTime = 60 | | | |
|
|
| | ceshCollectionIntervalNumber = 1 | | | |
|
|
| | ceshCollectionIntervalSensorValue = 54 | | | |
|
|
| | ceshCollectionIntervalTimeStamp = 1 | | | |
|
|
| +------------------------------------------+ | | |
|
|
| .................... <----+ |
|
|
| skipped 58 entries <----+ |
|
|
| .................... <----+ |
|
|
| | | |
|
|
| +------------------------------------------+ | | |
|
|
| | ceshCollectionIntervalEntry | | | |
|
|
| | entPhysicalIndex = 3 |<----+ |
|
|
| | ceshCollectionIntervalTime = 60 | | |
|
|
| | ceshCollectionIntervalNumber = 60 | | |
|
|
| | ceshCollectionIntervalSensorValue = 54 | | |
|
|
| | ceshCollectionIntervalTimeStamp = 60 | | |
|
|
| +------------------------------------------+ | |
|
|
| | |
|
|
| +------------------------------------------+ | |
|
|
| | ceshCollectionIntervalEntry | | |
|
|
| | entPhysicalIndex = 3 |<-----------+
|
|
| | ceshCollectionIntervalTime = 3660 | |
|
|
| | ceshCollectionIntervalNumber = 1 | |
|
|
| | ceshCollectionIntervalSensorValue = 54 | |
|
|
| | ceshCollectionIntervalTimeStamp = 60 | |
|
|
| +------------------------------------------+ |
|
|
+----------------------------------------------+
|
|
|
|
If the system samples a sensor every minute for one collection
|
|
and every hour for another, then the ceshCollectionTable
|
|
contains two entries describing the two collections."
|
|
REVISION "201103040000Z"
|
|
DESCRIPTION
|
|
"Initial version of this MIB module."
|
|
::= { ciscoMgmt 768 }
|
|
|
|
|
|
|
|
SensorHistoryCollectionAlgorithm ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This textual convention denotes an enumerated integer-value
|
|
that describing the method used to collect historic data for a
|
|
sensor.
|
|
|
|
'other' - The implementation of the MIB module using
|
|
this textual convention does not recognize
|
|
the historic data collection algorithm.
|
|
'unknown' - The system is not able to ascertain the
|
|
historic data collection algorithm.
|
|
'measured' - A raw value.
|
|
'simpleAverage' - The system collects a simple moving average
|
|
of the values sampled from the sensor."
|
|
SYNTAX INTEGER {
|
|
other(1),
|
|
unknown(2),
|
|
measured(3),
|
|
algoSMA(4)
|
|
}
|
|
ciscoEntitySensorHistoryMIBObjects OBJECT IDENTIFIER
|
|
::= { ciscoEntitySensorHistoryMIB 0 }
|
|
|
|
ciscoEntitySensorHistoryMIBConform OBJECT IDENTIFIER
|
|
::= { ciscoEntitySensorHistoryMIB 1 }
|
|
|
|
|
|
ceshCollectionTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CeshCollectionEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table lists each collection of historic data maintained
|
|
by the system for each supported sensor.
|
|
|
|
This table has an expansion dependent relationship on the
|
|
ceshCollectionIntervalTable, containing zero or more rows for
|
|
each corresponding collection."
|
|
::= { ciscoEntitySensorHistoryMIBObjects 1 }
|
|
|
|
ceshCollectionEntry OBJECT-TYPE
|
|
SYNTAX CeshCollectionEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Each entry in the ceshCollectionTable contains collection
|
|
attributes describing the collection.
|
|
|
|
For each supported sensor, the system creates a row
|
|
for each prescribed collection. This creation process happens
|
|
at startup and following the insertion of a FRU containing
|
|
sensors.
|
|
|
|
The system destroys a row when it destroys the corresponding row
|
|
in the entPhysicalTable, which can happen as the result of the
|
|
removal of the FRU containing the sensor."
|
|
INDEX {
|
|
entPhysicalIndex,
|
|
ceshCollectionIntervalTime
|
|
}
|
|
::= { ceshCollectionTable 1 }
|
|
|
|
CeshCollectionEntry ::= SEQUENCE {
|
|
ceshCollectionIntervalTime Unsigned32,
|
|
ceshCollectionIntervals Gauge32,
|
|
ceshCollectionInvalidIntervals Gauge32,
|
|
ceshCollectionMaxIntervals Unsigned32,
|
|
ceshCollectionElapsedTime Gauge32,
|
|
ceshCollectionAlgorithm SensorHistoryCollectionAlgorithm
|
|
}
|
|
|
|
ceshCollectionIntervalTime OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..4294967295)
|
|
UNITS "seconds"
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the length of the sampling interval for
|
|
the collection."
|
|
::= { ceshCollectionEntry 1 }
|
|
|
|
ceshCollectionIntervals OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "intervals"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the number of intervals for which data
|
|
has been collected."
|
|
::= { ceshCollectionEntry 2 }
|
|
|
|
ceshCollectionInvalidIntervals OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "intervals"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the number of intervals in the range of
|
|
'0' to the value of the corresponding instance of
|
|
ceshCollectionIntervals, for which no data is available.
|
|
|
|
The value of this column will typically be '0', except in
|
|
certain circumstances when some intervals are not available."
|
|
::= { ceshCollectionEntry 3 }
|
|
|
|
ceshCollectionMaxIntervals OBJECT-TYPE
|
|
SYNTAX Unsigned32 (0..4294967295)
|
|
UNITS "intervals"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the maximum number of intervals
|
|
maintained for the collection."
|
|
::= { ceshCollectionEntry 4 }
|
|
|
|
ceshCollectionElapsedTime OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "seconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the time that has elapsed since the
|
|
beginning of the current interval."
|
|
::= { ceshCollectionEntry 5 }
|
|
|
|
ceshCollectionAlgorithm OBJECT-TYPE
|
|
SYNTAX SensorHistoryCollectionAlgorithm
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the algorithm used in collecting historic
|
|
data from the corresponding sensor."
|
|
::= { ceshCollectionEntry 6 }
|
|
|
|
|
|
|
|
ceshCollectionIntervalTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CeshCollectionIntervalEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table contains the historic data for each collection
|
|
maintained by the system.
|
|
|
|
This table has an expansion dependent relationship on the
|
|
ceshCollectionTable, containing zero or more rows for each
|
|
corresponding collection."
|
|
::= { ciscoEntitySensorHistoryMIBObjects 2 }
|
|
|
|
ceshCollectionIntervalEntry OBJECT-TYPE
|
|
SYNTAX CeshCollectionIntervalEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry describes the data collected for an interval.
|
|
|
|
The system creates a row in the ceshCollectionIntervalTable
|
|
after it has sampled a sample for a given collection.
|
|
|
|
The maximum allowable entries for a collection should be less
|
|
than or equal to the value specified by
|
|
ceshCollectionMaxIntervals instance. Once number of entries is
|
|
equal to ceshCollectionMaxIntervals, then the system destroys
|
|
the lease recent row from the collection before creating a new
|
|
one.
|
|
|
|
An agent destroys all conceptual entries corresponding to a
|
|
physical entity upon removal of the physical entity."
|
|
INDEX {
|
|
entPhysicalIndex,
|
|
ceshCollectionIntervalTime,
|
|
ceshCollectionIntervalNumber
|
|
}
|
|
::= { ceshCollectionIntervalTable 1 }
|
|
|
|
CeshCollectionIntervalEntry ::= SEQUENCE {
|
|
ceshCollectionIntervalNumber Unsigned32,
|
|
ceshCollectionIntervalSensorValue EntitySensorValue,
|
|
ceshCollectionIntervalTimeStamp TimeStamp
|
|
}
|
|
|
|
ceshCollectionIntervalNumber OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..4294967295)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the interval number identifying the
|
|
interval. The interval identified by the value '1' represents
|
|
the most recent interval, and the interval identified by the
|
|
value (n) represents the interval immediately preceding the
|
|
interval identified by the value (n-1)."
|
|
::= { ceshCollectionIntervalEntry 1 }
|
|
|
|
ceshCollectionIntervalSensorValue OBJECT-TYPE
|
|
SYNTAX EntitySensorValue
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the sensor value for the corresponding
|
|
physical entity during the interval.
|
|
|
|
To correctly display or interpret this variable's value, you
|
|
must also know the sensor's type, scale, and precision
|
|
indicated by the corresponding entry in the entPhySensorTable
|
|
(defined by the ENTITY-SENSOR-MIB) or entSensorValueTable
|
|
(defined by the CISCO-ENTITY-SENSOR-MIB)."
|
|
REFERENCE "RFC3433"
|
|
::= { ceshCollectionIntervalEntry 2 }
|
|
|
|
ceshCollectionIntervalTimeStamp OBJECT-TYPE
|
|
SYNTAX TimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the value of sysUpTime when the system
|
|
sampled the corresponding sensor."
|
|
::= { ceshCollectionIntervalEntry 3 }
|
|
|
|
|
|
ciscoEntitySensorHistoryMIBCompliances OBJECT IDENTIFIER
|
|
::= { ciscoEntitySensorHistoryMIBConform 1 }
|
|
|
|
ciscoEntitySensorHistoryMIBGroups OBJECT IDENTIFIER
|
|
::= { ciscoEntitySensorHistoryMIBConform 2 }
|
|
|
|
|
|
ciscoEntitySensorHistoryCompliance MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Describes the requirements for conformance to the Entity
|
|
Sensor History Collection MIB module."
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS {
|
|
ceshCollectionGroup,
|
|
ceshCollectionIntervalGroup
|
|
}
|
|
::= { ciscoEntitySensorHistoryMIBCompliances 1 }
|
|
|
|
-- Units of Conformance
|
|
|
|
ceshCollectionGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
ceshCollectionElapsedTime,
|
|
ceshCollectionIntervals,
|
|
ceshCollectionInvalidIntervals,
|
|
ceshCollectionAlgorithm,
|
|
ceshCollectionMaxIntervals
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This group contains collection of attribute objects related
|
|
to entity sensor history collection"
|
|
::= { ciscoEntitySensorHistoryMIBGroups 1 }
|
|
|
|
ceshCollectionIntervalGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
ceshCollectionIntervalTimeStamp,
|
|
ceshCollectionIntervalSensorValue
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This group contains collection of interval objects related to
|
|
entity sensor history collection"
|
|
::= { ciscoEntitySensorHistoryMIBGroups 2 }
|
|
|
|
END
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|