CISCO-ENVMON-MIB

All MIBs › CISCO-ENVMON-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2003-12-01

Category: Cisco Devices, Hardware and Environment

Description: Monitors environmental conditions on Cisco devices including temperature, voltage, fan, and power supply status.

IPNetwork Monitor uses several OIDs from this MIB in network discovery and polling the applicable devices. Start monitoring CISCO-ENVMON-MIB with a free 30-day trial of IPNetwork Monitor.

What Is CISCO-ENVMON-MIB?

CISCO-ENVMON-MIB is a foundational Cisco hardware-health MIB that reports on the environmental monitor subsystem present on many Cisco routers and switches, covering voltage, temperature, fan, and power supply conditions. It exposes status tables for each monitored domain, such as ciscoEnvMonVoltageStatusTable and a parallel temperature status table, each carrying a description, current measured value, configured thresholds, and a state indicating normal, warning, critical, or shutdown conditions. This MIB is one of the most direct hardware health monitoring tools in Cisco's portfolio: ciscoEnvMonVoltageState and the temperature equivalent reveal whether a device is at risk of thermal or electrical failure, ciscoEnvMonVoltageLastShutdown records whether the device has previously shut down due to an out-of-range condition, and ciscoEnvMonPresent confirms whether environmental monitoring hardware exists at all on that chassis. It is a self-contained Cisco-specific MIB with no dependency on other standard MIBs, though it is commonly deployed alongside the newer CISCO-ENTITY-SENSOR-MIB for finer-grained sensor data. It is used across essentially the entire range of Cisco routers, switches, and other chassis-based hardware with environmental sensors. This is one of the most frequently searched Cisco hardware-health MIBs, since ciscoEnvMonSupplyState and ciscoEnvMonTemperatureState are the standard objects NMS tools poll to alert on power-supply and temperature faults across the Cisco install base.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-ENVMON-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 routers and switches with environmental monitoring hardware

Monitoring Examples

An operator would poll ciscoEnvMonTemperatureStatusTable and ciscoEnvMonVoltageStatusTable (via their respective Entry objects, keyed by index) to check ciscoEnvMonVoltageStatusValue against ciscoEnvMonVoltageThresholdLow/ciscoEnvMonVoltageThresholdHigh for each monitored point. A ciscoEnvMonVoltageState or temperature state reporting warning or critical, especially combined with a non-zero ciscoEnvMonVoltageLastShutdown, would indicate the chassis has experienced or is approaching a power or thermal fault requiring immediate hardware attention. Notifications configured under ciscoEnvMonMIBNotificationEnables would alert the NMS the moment any monitored value crosses its threshold.

What Can Be Monitored

chassis temperature
voltage levels and thresholds
fan status
power supply status
environmental shutdown history
environmental monitor presence

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Gauge32
Integer32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE

From SNMPv2-TC

DisplayString
TEXTUAL-CONVENTION
TruthValue

How to Use in IPNetwork Monitor

Example using ciscoEnvMonTemperatureStatusValue OID:

Select a Cisco routers and switches with environmental monitoring hardware 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 ciscoEnvMonTemperatureStatusValue 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. The current measurement of the testpoint being instrumented. 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 a Gauge32-type OID, Value bounds is the most useful condition here — trigger an alert if the reported value exceeds the level expected for healthy operation, since sustained high temperature often precedes thermal shutdown or hardware degradation. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoEnvMonMIB	1.3.6.1.4.1.9.9.13			The MIB module to describe the status of the Environmental Monitor on those devices which support one.
ciscoEnvMonObjects	1.3.6.1.4.1.9.9.13.1
INT ciscoEnvMonPresent	1.3.6.1.4.1.9.9.13.1.1	INTEGER	read-only	The type of environmental monitor located in the chassis. An oldAgs environmental monitor card is identical to an ags environmental card except that it is not capable of supplying data, and hence no instance of the remaining objects in this MIB will be returned in response to an SNMP query. Note that only a firmware upgrade is required to convert an oldAgs into an ags card.
ciscoEnvMonVoltageStatusTable	1.3.6.1.4.1.9.9.13.1.2		not-accessible	The table of voltage status maintained by the environmental monitor.
ciscoEnvMonVoltageStatusEntry	1.3.6.1.4.1.9.9.13.1.2.1		not-accessible	An entry in the voltage status table, representing the status of the associated testpoint maintained by the environmental monitor.
I32 ciscoEnvMonVoltageStatusIndex	1.3.6.1.4.1.9.9.13.1.2.1.1	Integer32	not-accessible	Unique index for the testpoint being instrumented. This index is for SNMP purposes only, and has no intrinsic meaning.
STR ciscoEnvMonVoltageStatusDescr	1.3.6.1.4.1.9.9.13.1.2.1.2	DisplayString	read-only	Textual description of the testpoint being instrumented. This description is a short textual label, suitable as a human-sensible identification for the rest of the information in the entry.
NUM ciscoEnvMonVoltageStatusValue	1.3.6.1.4.1.9.9.13.1.2.1.3	CiscoSignedGauge	read-only	The current measurement of the testpoint being instrumented.
I32 ciscoEnvMonVoltageThresholdLow	1.3.6.1.4.1.9.9.13.1.2.1.4	Integer32	read-only	The lowest value that the associated instance of the object ciscoEnvMonVoltageStatusValue may obtain before an emergency shutdown of the managed device is initiated.
I32 ciscoEnvMonVoltageThresholdHigh	1.3.6.1.4.1.9.9.13.1.2.1.5	Integer32	read-only	The highest value that the associated instance of the object ciscoEnvMonVoltageStatusValue may obtain before an emergency shutdown of the managed device is initiated.
I32 ciscoEnvMonVoltageLastShutdown	1.3.6.1.4.1.9.9.13.1.2.1.6	Integer32	read-only	The value of the associated instance of the object ciscoEnvMonVoltageStatusValue at the time an emergency shutdown of the managed device was last initiated. This value is stored in non-volatile RAM and hence is able to survive the shutdown.
CIS ciscoEnvMonVoltageState	1.3.6.1.4.1.9.9.13.1.2.1.7	CiscoEnvMonState	read-only	The current state of the testpoint being instrumented.
ciscoEnvMonTemperatureStatusTable	1.3.6.1.4.1.9.9.13.1.3		not-accessible	The table of ambient temperature status maintained by the environmental monitor.
ciscoEnvMonTemperatureStatusEntry	1.3.6.1.4.1.9.9.13.1.3.1		not-accessible	An entry in the ambient temperature status table, representing the status of the associated testpoint maintained by the environmental monitor.
I32 ciscoEnvMonTemperatureStatusIndex	1.3.6.1.4.1.9.9.13.1.3.1.1	Integer32	not-accessible	Unique index for the testpoint being instrumented. This index is for SNMP purposes only, and has no intrinsic meaning.
STR ciscoEnvMonTemperatureStatusDescr	1.3.6.1.4.1.9.9.13.1.3.1.2	DisplayString	read-only	Textual description of the testpoint being instrumented. This description is a short textual label, suitable as a human-sensible identification for the rest of the information in the entry.
G32 ciscoEnvMonTemperatureStatusValueEx	1.3.6.1.4.1.9.9.13.1.3.1.3	Gauge32	read-only	The current measurement of the testpoint being instrumented.
I32 ciscoEnvMonTemperatureThreshold	1.3.6.1.4.1.9.9.13.1.3.1.4	Integer32	read-only	The highest value that the associated instance of the object ciscoEnvMonTemperatureStatusValue may obtain before an emergency shutdown of the managed device is initiated.
I32 ciscoEnvMonTemperatureLastShutdown	1.3.6.1.4.1.9.9.13.1.3.1.5	Integer32	read-only	The value of the associated instance of the object ciscoEnvMonTemperatureStatusValue at the time an emergency shutdown of the managed device was last initiated. This value is stored in non-volatile RAM and hence is able to survive the shutdown.
CIS ciscoEnvMonTemperatureState	1.3.6.1.4.1.9.9.13.1.3.1.6	CiscoEnvMonState	read-only	The current state of the testpoint being instrumented.
ciscoEnvMonFanStatusTable	1.3.6.1.4.1.9.9.13.1.4		not-accessible	The table of fan status maintained by the environmental monitor.
ciscoEnvMonFanStatusEntry	1.3.6.1.4.1.9.9.13.1.4.1		not-accessible	An entry in the fan status table, representing the status of the associated fan maintained by the environmental monitor.
I32 ciscoEnvMonFanStatusIndex	1.3.6.1.4.1.9.9.13.1.4.1.1	Integer32	not-accessible	Unique index for the fan being instrumented. This index is for SNMP purposes only, and has no intrinsic meaning.
STR ciscoEnvMonFanStatusDescr	1.3.6.1.4.1.9.9.13.1.4.1.2	DisplayString	read-only	Textual description of the fan being instrumented. This description is a short textual label, suitable as a human-sensible identification for the rest of the information in the entry.
CIS ciscoEnvMonFanState	1.3.6.1.4.1.9.9.13.1.4.1.3	CiscoEnvMonState	read-only	The current state of the fan being instrumented.
ciscoEnvMonSupplyStatusTable	1.3.6.1.4.1.9.9.13.1.5		not-accessible	The table of power supply status maintained by the environmental monitor card.
ciscoEnvMonSupplyStatusEntry	1.3.6.1.4.1.9.9.13.1.5.1		not-accessible	An entry in the power supply status table, representing the status of the associated power supply maintained by the environmental monitor card.
I32 ciscoEnvMonSupplyStatusIndex	1.3.6.1.4.1.9.9.13.1.5.1.1	Integer32	not-accessible	Unique index for the power supply being instrumented. This index is for SNMP purposes only, and has no intrinsic meaning.
STR ciscoEnvMonSupplyStatusDescr	1.3.6.1.4.1.9.9.13.1.5.1.2	DisplayString	read-only	Textual description of the power supply being instrumented. This description is a short textual label, suitable as a human-sensible identification for the rest of the information in the entry.
CIS ciscoEnvMonSupplyState	1.3.6.1.4.1.9.9.13.1.5.1.3	CiscoEnvMonState	read-only	The current state of the power supply being instrumented.
INT ciscoEnvMonSupplySource	1.3.6.1.4.1.9.9.13.1.5.1.4	INTEGER	read-only	The power supply source. unknown - Power supply source unknown ac - AC power supply dc - DC power supply externalPowerSupply - External power supply internalRedundant - Internal redundant power supply
BIT ciscoEnvMonAlarmContacts	1.3.6.1.4.1.9.9.13.1.6	Bits	read-only	Each bit is set to reflect the respective alarm being set. The bit will be cleared when the respective alarm is cleared.
ciscoEnvMonMIBNotificationEnables	1.3.6.1.4.1.9.9.13.2
T/F ciscoEnvMonEnableShutdownNotification	1.3.6.1.4.1.9.9.13.2.1	TruthValue	read-write	This variable indicates whether the system produces the ciscoEnvMonShutdownNotification. A false value will prevent shutdown notifications from being generated by this system.
T/F ciscoEnvMonEnableVoltageNotification	1.3.6.1.4.1.9.9.13.2.2	TruthValue	read-write	This variable indicates whether the system produces the ciscoEnvMonVoltageNotification. A false value will prevent voltage notifications from being generated by this system. This object is deprecated in favour of ciscoEnvMonEnableStatChangeNotif.
T/F ciscoEnvMonEnableTemperatureNotification	1.3.6.1.4.1.9.9.13.2.3	TruthValue	read-write	This variable indicates whether the system produces the ciscoEnvMonTemperatureNotification. A false value prevents temperature notifications from being sent by this entity. This object is deprecated in favour of ciscoEnvMonEnableStatChangeNotif.
T/F ciscoEnvMonEnableFanNotification	1.3.6.1.4.1.9.9.13.2.4	TruthValue	read-write	This variable indicates whether the system produces the ciscoEnvMonFanNotification. A false value prevents fan notifications from being sent by this entity. This object is deprecated in favour of ciscoEnvMonEnableStatChangeNotif.
T/F ciscoEnvMonEnableRedundantSupplyNotification	1.3.6.1.4.1.9.9.13.2.5	TruthValue	read-write	This variable indicates whether the system produces the ciscoEnvMonRedundantSupplyNotification. A false value prevents redundant supply notifications from being generated by this system. This object is deprecated in favour of ciscoEnvMonEnableStatChangeNotif.
T/F ciscoEnvMonEnableStatChangeNotif	1.3.6.1.4.1.9.9.13.2.6	TruthValue	read-write	This variable indicates whether the system produces the ciscoEnvMonVoltStatusChangeNotif, ciscoEnvMonTempStatusChangeNotif, ciscoEnvMonFanStatusChangeNotif and ciscoEnvMonSuppStatusChangeNotif. A false value will prevent these notifications from being generated by this system.
ciscoEnvMonMIBNotificationPrefix	1.3.6.1.4.1.9.9.13.3
ciscoEnvMonMIBNotifications	1.3.6.1.4.1.9.9.13.3.0
NTF ciscoEnvMonShutdownNotification	1.3.6.1.4.1.9.9.13.3.0.1			A ciscoEnvMonShutdownNotification is sent if the environmental monitor detects a testpoint reaching a critical state and is about to initiate a shutdown. This notification contains no objects so that it may be encoded and sent in the shortest amount of time possible. Even so, management applications should not rely on receiving such a notification as it may not be sent before the shutdown completes.
NTF ciscoEnvMonVoltageNotification	1.3.6.1.4.1.9.9.13.3.0.2			A ciscoEnvMonVoltageNotification is sent if the voltage measured at a given testpoint is outside the normal range for the testpoint (i.e. is at the warning, critical, or shutdown stage). Since such a notification is usually generated before the shutdown state is reached, it can convey more data and has a better chance of being sent than does the ciscoEnvMonShutdownNotification. This notification is deprecated in favour of ciscoEnvMonVoltStatusChangeNotif.
NTF ciscoEnvMonTemperatureNotification	1.3.6.1.4.1.9.9.13.3.0.3			A ciscoEnvMonTemperatureNotification is sent if the temperature measured at a given testpoint is outside the normal range for the testpoint (i.e. is at the warning, critical, or shutdown stage). Since such a Notification is usually generated before the shutdown state is reached, it can convey more data and has a better chance of being sent than does the ciscoEnvMonShutdownNotification. This notification is deprecated in favour of ciscoEnvMonTempStatusChangeNotif.
NTF ciscoEnvMonFanNotification	1.3.6.1.4.1.9.9.13.3.0.4			A ciscoEnvMonFanNotification is sent if any one of the fans in the fan array (where extant) fails. Since such a notification is usually generated before the shutdown state is reached, it can convey more data and has a better chance of being sent than does the ciscoEnvMonShutdownNotification. This notification is deprecated in favour of ciscoEnvMonFanStatusChangeNotif.
NTF ciscoEnvMonRedundantSupplyNotification	1.3.6.1.4.1.9.9.13.3.0.5			A ciscoEnvMonRedundantSupplyNotification is sent if the redundant power supply (where extant) fails. Since such a notification is usually generated before the shutdown state is reached, it can convey more data and has a better chance of being sent than does the ciscoEnvMonShutdownNotification. This notification is deprecated in favour of ciscoEnvMonSuppStatusChangeNotif.
NTF ciscoEnvMonVoltStatusChangeNotif	1.3.6.1.4.1.9.9.13.3.0.6			A ciscoEnvMonVoltStatusChangeNotif is sent if there is change in the state of a device being monitored by ciscoEnvMonVoltageState.
NTF ciscoEnvMonTempStatusChangeNotif	1.3.6.1.4.1.9.9.13.3.0.7			A ciscoEnvMonTempStatusChangeNotif is sent if there is change in the state of a device being monitored by ciscoEnvMonTemperatureState.
NTF ciscoEnvMonFanStatusChangeNotif	1.3.6.1.4.1.9.9.13.3.0.8			A ciscoEnvMonFanStatusChangeNotif is sent if there is change in the state of a device being monitored by ciscoEnvMonFanState.
NTF ciscoEnvMonSuppStatusChangeNotif	1.3.6.1.4.1.9.9.13.3.0.9			A ciscoEnvMonSupplyStatChangeNotif is sent if there is change in the state of a device being monitored by ciscoEnvMonSupplyState.
ciscoEnvMonMIBConformance	1.3.6.1.4.1.9.9.13.4
ciscoEnvMonMIBCompliances	1.3.6.1.4.1.9.9.13.4.1
ciscoEnvMonMIBCompliance	1.3.6.1.4.1.9.9.13.4.1.1			The compliance statement for entities which implement the Cisco Environmental Monitor MIB. This is deprecated and new compliance ciscoEnvMonMIBComplianceRev1 is added.
ciscoEnvMonMIBComplianceRev1	1.3.6.1.4.1.9.9.13.4.1.2			The compliance statement for entities which implement the Cisco Environmental Monitor MIB.
ciscoEnvMonMIBGroups	1.3.6.1.4.1.9.9.13.4.2
ciscoEnvMonMIBGroup	1.3.6.1.4.1.9.9.13.4.2.1			A collection of objects providing environmental monitoring capability to a cisco chassis. This group is deprecated in favour of ciscoEnvMonMIBGroupRev.
ciscoEnvMonMIBGroupRev	1.3.6.1.4.1.9.9.13.4.2.2			A collection of objects providing environmental monitoring capability to a cisco chassis.
ciscoEnvMonEnableStatChangeGroup	1.3.6.1.4.1.9.9.13.4.2.3			A collection of objects providing enabling/disabling of the status change notifications for environmental monitoring.
ciscoEnvMonMIBNotifGroup	1.3.6.1.4.1.9.9.13.4.2.4			A notification group providing shutdown notification for environmental monitoring.
ciscoEnvMonStatChangeNotifGroup	1.3.6.1.4.1.9.9.13.4.2.5			A collection of notifications providing the status change for environmental monitoring.
ciscoEnvMonMIBMiscNotifGroup	1.3.6.1.4.1.9.9.13.4.2.6			A collection of various notifications for the enviromental monitoring mib module. The notifications the group and the group are both in deprecated state. The notifications in the group were deprecated in favour of notifications in ciscoEnvMonStatChangeNotifGroup.

RFC description

Describes environmental monitoring status on Cisco devices, including sensor data and alarm conditions.

Start monitoring Cisco routers and switches with environmental monitoring hardware 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-ENVMON-MIB