VMWARE-ENV-MIB

All MIBs › VMWARE-ENV-MIB

Organization: VMware, Inc

Last Updated: 2010-05-12

Category: Hardware and Environment

Description: Defines variables and trap types for reporting the state of physical hardware components on ESXi hosts, using CIM indications or IPMI sensors for environmental monitoring.

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

What Is VMWARE-ENV-MIB?

VMWARE-ENV-MIB is VMware's vendor-private MIB (under vmwProductSpecific) for ESXi/ESX host physical hardware environmental monitoring, sourced from IPMI sensors and the ESX CIM (Common Information Model) subsystem. It exposes the legacy vmwEnvTable (vmwSubsystemType, vmwHardwareStatus, vmwEventDescription) alongside newer CIM-alert objects (vmwEnvPerceivedSeverity, vmwEnvAlertType, vmwEnvSysCreationClassName, vmwEnvAlertingElement) and counters tracking the CIM-to-SNMP translation pipeline (vmwEnvInIndications, vmwEnvOutNotifications, vmwEnvInErrs, vmwEnvIndOidErrs, vmwEnvCvtValueErrs). A family of ESX-specific notifications (vmwESXEnvBatteryAlert, vmwESXEnvChassisAlert, vmwESXEnvThermalAlert, vmwESXEnvDiskAlert, vmwESXEnvPowerAlert, vmwESXEnvProcessorAlert, vmwESXEnvMemoryAlert, vmwESXEnvBIOSAlert) reports specific hardware subsystem faults. This is useful for monitoring physical server health beneath the hypervisor layer, catching hardware failures before they cause VM outages, and it depends on the underlying ESX CIM providers/IPMI sensors being correctly enumerated; it is deployed on VMware ESX/ESXi hosts, and administrators can download the VMWARE-ENV-MIB file to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in VMWARE-ENV-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

VMware ESX/ESXi hosts

Monitoring Examples

An operator polls vmwEnvSource to confirm the ESX host is deriving hardware status from CIM indications rather than sensors, and watches for vmwEnvInErrs or vmwEnvCvtValueErrs incrementing, which would indicate the CIM-to-SNMP translation pipeline is failing to report real battery, thermal, or power alerts represented by the vmwESXEnvBatteryAlert and vmwESXEnvPowerAlert traps.

What Can Be Monitored

CIM-to-SNMP indication translation counters
hardware subsystem alert traps (battery, chassis, thermal, disk, power, CPU, memory, BIOS)
legacy vmwEnvTable hardware status entries
CIM indication source configuration (sensors vs. indications)
alert severity and alerting-element identification

Imported Objects

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-IDENTITY
OBJECT-TYPE
TimeTicks

From SNMPv2-TC

DateAndTime
DisplayString

From VMWARE-PRODUCTS-MIB

vmwESX

OBJECT-IDENTITY

From VMWARE-ROOT-MIB

vmwNotifications	OBJECT-IDENTITY
vmwProductSpecific	OBJECT-IDENTITY

From VMWARE-TC-MIB

VmwCIMAlertFormat
VmwCIMAlertTypes
VmwCIMSeverity
VmwCimName
VmwLongSnmpAdminString
VmwSubsystemStatus
VmwSubsystemTypes

How to Use in IPNetwork Monitor

Example using vmwEnvInIndications OID:

Select a VMware ESX/ESXi host (IPMI/CIM hardware-subsystem alert status) 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 vmwEnvInIndications into the Find box to locate it in the OID tree, then select it and click OK. It reports the number of HTTP POST msgs containing CIM Indications in XML as received by agent. 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 Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
NTF vmwEnvHardwareEvent	1.3.6.1.4.1.6876.0.301			This notification, if the agent is so configured, may be sent when the system has detected a material change in physical condition of the hardware
vmwESXNotifications	1.3.6.1.4.1.6876.4.1.0			Parent of all ESX specific notifications (traps, informs).
NTF vmwESXEnvHardwareEvent	1.3.6.1.4.1.6876.4.1.0.301			ESX Specific version of this notification, if the agent is so configured, may be sent when the ESX Operating System has detected a material change in physical condition of the hardware
NTF vmwESXEnvHardwareAlert	1.3.6.1.4.1.6876.4.1.0.302			A hardware alert as received from the Common Infrastructure Management (CIM) subsystem on this system.
NTF vmwESXEnvBatteryAlert	1.3.6.1.4.1.6876.4.1.0.303			A battery alert as received from the Common Infrastructure Management (CIM) subsystem on this system.
NTF vmwESXEnvChassisAlert	1.3.6.1.4.1.6876.4.1.0.304			A chassis alert as received from the Common Infrastructure Management (CIM) subsystem on this system.
NTF vmwESXEnvThermalAlert	1.3.6.1.4.1.6876.4.1.0.305			A cooling/thermal alert as received from the Common Infrastructure Management (CIM) subsystem on this system.
NTF vmwESXEnvDiskAlert	1.3.6.1.4.1.6876.4.1.0.306			A disk drive alert as received from the Common Infrastructure Management (CIM) subsystem on this system.
NTF vmwESXEnvPowerAlert	1.3.6.1.4.1.6876.4.1.0.307			A power suppply alert as received from the Common Infrastructure Management (CIM) subsystem on this system.
NTF vmwESXEnvProcessorAlert	1.3.6.1.4.1.6876.4.1.0.308			A IPMI processor alert as received from the Common Infrastructure Management (CIM) subsystem on this system.
NTF vmwESXEnvMemoryAlert	1.3.6.1.4.1.6876.4.1.0.309			A IPMI memory alert as received from the Common Infrastructure Management (CIM) subsystem on this system.
NTF vmwESXEnvBIOSAlert	1.3.6.1.4.1.6876.4.1.0.310			BIOS System Event Log alert as received from the Common Infrastructure Management (CIM) subsystem on this system.
vmwEnv	1.3.6.1.4.1.6876.4.20
I32 vmwEnvNumber	1.3.6.1.4.1.6876.4.20.1	Integer32	read-only	Count of number of conceptual rows in vmwEnvTable
TIK vmwEnvLastChange	1.3.6.1.4.1.6876.4.20.2	TimeTicks	read-only	The value of sysUptime when a conceptual row was added or deleted from this table
vmwEnvTable	1.3.6.1.4.1.6876.4.20.3		not-accessible	This table is populated from monitoring subsystems such as IPMI One conceptual row is maintained for each reporting component. Conceptual rows are not persistent across device resets
vmwEnvEntry	1.3.6.1.4.1.6876.4.20.3.1		not-accessible	One entry for each physical component reporting its status to ESX Operating System
I32 vmwEnvIndex	1.3.6.1.4.1.6876.4.20.3.1.1	Integer32	not-accessible	A unique identifier that does not persist across management restarts
VMW vmwSubsystemType	1.3.6.1.4.1.6876.4.20.3.1.2	VmwSubsystemTypes	read-only	Hardware component reporting environmental state
VMW vmwHardwareStatus	1.3.6.1.4.1.6876.4.20.3.1.3	VmwSubsystemStatus	read-only	Last reported state of this component
STR vmwEventDescription	1.3.6.1.4.1.6876.4.20.3.1.4	DisplayString	read-only	Human readable description of this event
TIK vmwEnvHardwareTime	1.3.6.1.4.1.6876.4.20.3.1.5	TimeTicks	read-only	Value of sysUptime when vmwHardwareStatus was obtained
vmwEnvironmentalMIB	1.3.6.1.4.1.6876.4.20.10			This MIB module identifies hardware components of a machine as provided by IPMI.
vmwEnvironmentalMIBConformance	1.3.6.1.4.1.6876.4.20.10.2
vmwEnvironmentMIBCompliances	1.3.6.1.4.1.6876.4.20.10.2.1
vmwEnvMIBBasicCompliance	1.3.6.1.4.1.6876.4.20.10.2.1.2			The compliance statement for entities which implement the VMWARE-ENV-MIB.
vmwEnvMIBBasicCompliance2	1.3.6.1.4.1.6876.4.20.10.2.1.3			The compliance statement for entities which implement the VMWARE-ENV-MIB.
vmwEnvMIBBasicCompliance3	1.3.6.1.4.1.6876.4.20.10.2.1.4			The compliance statement for entities which implement the VMWARE-ENV-MIB.
vmwEnvMIBGroups	1.3.6.1.4.1.6876.4.20.10.2.2
vmwEnvironmentGroup	1.3.6.1.4.1.6876.4.20.10.2.2.1			These objects provide physical hardware environmental details.
vmwEnvNotificationGroup	1.3.6.1.4.1.6876.4.20.10.2.2.2			Notifications related to physical subsystems.
vmwESXEnvNotificationGroup	1.3.6.1.4.1.6876.4.20.10.2.2.3			ESX System specific notifications about physical subsystems.
vmwESXEnvNotificationGroup2	1.3.6.1.4.1.6876.4.20.10.2.2.4			ESX System specific notifications about physical subsystems.
vmwEnvAlertGroup	1.3.6.1.4.1.6876.4.20.10.2.2.5			These objects provide physical hardware environmental details as reported by CIM subsystem.
INT vmwEnvSource	1.3.6.1.4.1.6876.4.20.100	INTEGER	read-only	The source being used to obtain hardware state.
C32 vmwEnvInIndicationsEx	1.3.6.1.4.1.6876.4.20.101	Counter32	read-only	Number of HTTP POST msgs containing CIM Indications in XML as received by agent.
TIK vmwEnvLastIn	1.3.6.1.4.1.6876.4.20.102	TimeTicks	read-only	sysUptime when agent last received an indication.
C32 vmwEnvOutNotifications	1.3.6.1.4.1.6876.4.20.103	Counter32	read-only	Number of notifications (traps\|informs) sent that originated as CIM indication.
C32 vmwEnvInErrs	1.3.6.1.4.1.6876.4.20.104	Counter32	read-only	Number of CIM Indications that agent did not complete receipt of.
C32 vmwEnvIndOidErrs	1.3.6.1.4.1.6876.4.20.105	Counter32	read-only	Number of CIM Indications having a MappingString qualifier for which the value was not a valid oid.
C32 vmwEnvCvtValueErrs	1.3.6.1.4.1.6876.4.20.106	Counter32	read-only	Number of CIM Indication properties having a MappingString qualifier for which the cim value for the given cim type could not be converted.
C32 vmwEnvCvtSyntaxErrs	1.3.6.1.4.1.6876.4.20.107	Counter32	read-only	Number of CIM Indication properties having a MappingString qualifier for which the cim type could not be converted to smi syntax.
C32 vmwEnvCvtOidErrs	1.3.6.1.4.1.6876.4.20.108	Counter32	read-only	Number of CIM Indication properties having a MappingString qualifier for which the the oid was not valid.
C32 vmwEnvGetClassErrs	1.3.6.1.4.1.6876.4.20.109	Counter32	read-only	Number of CIM GetClass operations over a given cim indication class and namespace could not be completed (timeout) or returned error.
C32 vmwEnvPropertySkips	1.3.6.1.4.1.6876.4.20.110	Counter32	read-only	Number of CIM indications having properties which do not have MappingString qualifier in the class definition and were not converted, sent along with the notification.
C32 vmwEnvIndicationSkips	1.3.6.1.4.1.6876.4.20.111	Counter32	read-only	Number of CIM indications recieved for which GetClass reported no MappingStrings qualifier and were not converted to a notification.
vmwEnvCIM	1.3.6.1.4.1.6876.4.30
STR vmwEnvDescription	1.3.6.1.4.1.6876.4.30.1	VmwLongSnmpAdminString	accessible-for-notify	A short description of the Indication.
DAT vmwEnvEventTime	1.3.6.1.4.1.6876.4.30.2	DateAndTime	accessible-for-notify	The time and date the underlying event was first detected. May be set to the time the SNMP agent recieved the notification if in the incoming CIM indication the value is NULL due to the creating entity not being capable of providing this information. This value is based on the notion of local date and time of the Managed System Element generating the Indication.
DAT vmwEnvIndicationTime	1.3.6.1.4.1.6876.4.30.3	DateAndTime	accessible-for-notify	The time and date of creation of the underlying Indication received by the snmp agent. The property may be set to the time SNMP agent received the notification if the entity creating the Indication is not capable of determining this information and delivers a null IndicationTime property. Note that IndicationTime may be the same for two Indications that are generated in rapid succession.
VMW vmwEnvPerceivedSeverity	1.3.6.1.4.1.6876.4.30.4	VmwCIMSeverity	accessible-for-notify	An enumerated value that describes the severity of the Alert Indication from the notifier's point of view.
VMW vmwEnvAlertType	1.3.6.1.4.1.6876.4.30.5	VmwCIMAlertTypes	accessible-for-notify	Primary classification of the Indication.
VMW vmwEnvSysCreationClassName	1.3.6.1.4.1.6876.4.30.6	VmwCimName	accessible-for-notify	The scoping System's CreationClassName for the Provider generating this Indication.
VMW vmwEnvAlertingElement	1.3.6.1.4.1.6876.4.30.7	VmwCimName	accessible-for-notify	The identifying information of the entity (ie, the instance) for which this notification is generated. The property contains the CIM path of an CIM object instance, encoded as a string parameter - if the instance is modeled in the CIM Schema. If not a CIM instance, the property contains some identifying string that names the entity for which the Alert is generated. The path or identifying string is formatted per the AlertingElementFormat property.
VMW vmwEnvAlertingFormat	1.3.6.1.4.1.6876.4.30.8	VmwCIMAlertFormat	accessible-for-notify	The format of the AlertingManagedElement property is interpretable based upon the value of this property.
VMW vmwEnvSystemName	1.3.6.1.4.1.6876.4.30.9	VmwCimName	accessible-for-notify	The scoping System's Name for the Provider generating this message.
VMW vmwEnvProviderName	1.3.6.1.4.1.6876.4.30.10	VmwCimName	accessible-for-notify	The name of the CIM provider, a software module loaded into the CIM subsystem, generating this message.

RFC description

Monitors VMware ESX server environmental hardware components including IPMI sensors, temperature, and power.

Start monitoring VMware ESX/ESXi hosts (IPMI/CIM hardware-subsystem alert status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download VMWARE-ENV-MIB