ENTITY-STATE-MIB

All MIBs › ENTITY-STATE-MIB

Organization: IETF Entity MIB Working Group

Last Updated: 2005-11-22

Category: Hardware and Environment, MPLS and Traffic Engineering

Description: Defines managed objects extending the Entity MIB to provide administrative, operational, and standby state information for physical entities.

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

What Is ENTITY-STATE-MIB?

This is a vendor-neutral IETF standards-track MIB (RFC 4268) that extends the Entity MIB with detailed administrative, operational, and standby/usage state information for each physical entity (e.g., card, power supply, fan, module) in a managed device's physical inventory. It exposes per-entity state objects such as administrative state (e.g., locked/unlocked), operational state, and standby/redundancy state (active, standby, hot-standby, etc.), enabling detection of failed or degraded hardware components. This is directly a hardware status monitoring MIB: it lets an operator determine whether a specific physical component such as a line card or power supply is enabled, functioning, or has failed over to a standby unit, which is central to detecting hardware faults and redundancy switchover events. It explicitly depends on and extends the ENTITY-MIB (RFC 4133), using its entPhysicalIndex as the indexing key for its state tables. It is broadly deployed across enterprise routers, switches, and chassis-based systems from many vendors that support ENTITY-MIB-based physical inventory with state extensions, and entity-state-mib remains a common reference for engineers implementing that support.

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

vendor-neutral, standards-based MIB, not tied to a specific manufacturer
chassis-based routers and switches with modular/redundant hardware components

Monitoring Examples

An NMS polling entStateAdmin and entStateStandby for each entPhysicalIndex-indexed physical entity (e.g., a redundant power supply or supervisor module) can detect if a component has been administratively locked, has failed, or has switched into standby/hot-standby mode following a fault. A power supply reporting a disabled operational state alongside a standby state change would indicate a power failure that triggered failover to a backup unit.

What Can Be Monitored

administrative state of physical entities
operational state of physical entities
standby/redundancy state (active/standby/hot-standby)
hardware component failover events

Imported Objects

From ENTITY-MIB

entPhysicalIndex

OBJECT-TYPE

From ENTITY-STATE-TC-MIB

EntityAdminState
EntityAlarmStatus
EntityOperState
EntityStandbyStatus
EntityUsageState

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
mib-2

From SNMPv2-TC

DateAndTime

OIDs

OID symbolic	OID numeric	Type	Access	Description
entityStateMIB	1.3.6.1.2.1.131			This MIB defines a state extension to the Entity MIB. Copyright (C) The Internet Society 2005. This version of this MIB module is part of RFC 4268; see the RFC itself for full legal notices.
entStateNotifications	1.3.6.1.2.1.131.0
NTF entStateOperEnabled	1.3.6.1.2.1.131.0.1			An entStateOperEnabled notification signifies that the SNMP entity, acting in an agent role, has detected that the entStateOper object for one of its entities has transitioned into the 'enabled' state. The entity this notification refers can be identified by extracting the entPhysicalIndex from one of the variable bindings. The entStateAdmin and entStateAlarm varbinds may be examined to find out additional information on the administrative state at the time of the operation state change as well as to find out whether there were any known alarms against the entity at that time that may explain why the physical entity has become operationally disabled.
NTF entStateOperDisabled	1.3.6.1.2.1.131.0.2			An entStateOperDisabled notification signifies that the SNMP entity, acting in an agent role, has detected that the entStateOper object for one of its entities has transitioned into the 'disabled' state. The entity this notification refers can be identified by extracting the entPhysicalIndex from one of the variable bindings. The entStateAdmin and entStateAlarm varbinds may be examined to find out additional information on the administrative state at the time of the operation state change as well as to find out whether there were any known alarms against the entity at that time that may affect the physical entity's ability to stay operationally enabled.
entStateObjects	1.3.6.1.2.1.131.1
entStateTable	1.3.6.1.2.1.131.1.1		not-accessible	A table of information about state/status of entities. This is a sparse augment of the entPhysicalTable. Entries appear in this table for values of entPhysicalClass [RFC4133] that in this implementation are able to report any of the state or status stored in this table.
entStateEntry	1.3.6.1.2.1.131.1.1.1		not-accessible	State information about this physical entity.
DAT entStateLastChanged	1.3.6.1.2.1.131.1.1.1.1	DateAndTime	read-only	The value of this object is the date and time when the value of any of entStateAdmin, entStateOper, entStateUsage, entStateAlarm, or entStateStandby changed for this entity. If there has been no change since the last re-initialization of the local system, this object contains the date and time of local system initialization. If there has been no change since the entity was added to the local system, this object contains the date and time of the insertion.
ENT entStateAdmin	1.3.6.1.2.1.131.1.1.1.2	EntityAdminState	read-write	The administrative state for this entity. This object refers to an entities administrative permission to service both other entities within its containment hierarchy as well other users of its services defined by means outside the scope of this MIB. Setting this object to 'notSupported' will result in an 'inconsistentValue' error. For entities that do not support administrative state, all set operations will result in an 'inconsistentValue' error. Some physical entities exhibit only a subset of the remaining administrative state values. Some entities cannot be locked, and hence this object exhibits only the 'unlocked' state. Other entities cannot be shutdown gracefully, and hence this object does not exhibit the 'shuttingDown' state. A value of 'inconsistentValue' will be returned if attempts are made to set this object to values not supported by its administrative model.
ENT entStateOper	1.3.6.1.2.1.131.1.1.1.3	EntityOperState	read-only	The operational state for this entity. Note that unlike the state model used within the Interfaces MIB [RFC2863], this object does not follow the administrative state. An administrative state of down does not predict an operational state of disabled. A value of 'testing' means that entity currently being tested and cannot therefore report whether it is operational or not. A value of 'disabled' means that an entity is totally inoperable and unable to provide service both to entities within its containment hierarchy, or to other receivers of its service as defined in ways outside the scope of this MIB. A value of 'enabled' means that an entity is fully or partially operable and able to provide service both to entities within its containment hierarchy, or to other receivers of its service as defined in ways outside the scope of this MIB. Note that some implementations may not be able to accurately report entStateOper while the entStateAdmin object has a value other than 'unlocked'. In these cases, this object MUST have a value of 'unknown'.
ENT entStateUsage	1.3.6.1.2.1.131.1.1.1.4	EntityUsageState	read-only	The usage state for this entity. This object refers to an entity's ability to service more physical entities in a containment hierarchy. A value of 'idle' means this entity is able to contain other entities but that no other entity is currently contained within this entity. A value of 'active' means that at least one entity is contained within this entity, but that it could handle more. A value of 'busy' means that the entity is unable to handle any additional entities being contained in it. Some entities will exhibit only a subset of the usage state values. Entities that are unable to ever service any entities within a containment hierarchy will always have a usage state of 'busy'. Some entities will only ever be able to support one entity within its containment hierarchy and will therefore only exhibit values of 'idle' and 'busy'.
ENT entStateAlarm	1.3.6.1.2.1.131.1.1.1.5	EntityAlarmStatus	read-only	The alarm status for this entity. It does not include the alarms raised on child components within its containment hierarchy. A value of 'unknown' means that this entity is unable to report alarm state. Note that this differs from 'indeterminate', which means that alarm state is supported and there are alarms against this entity, but the severity of some of the alarms is not known. If no bits are set, then this entity supports reporting of alarms, but there are currently no active alarms against this entity.
ENT entStateStandby	1.3.6.1.2.1.131.1.1.1.6	EntityStandbyStatus	read-only	The standby status for this entity. Some entities will exhibit only a subset of the remaining standby state values. If this entity cannot operate in a standby role, the value of this object will always be 'providingService'.
entStateConformance	1.3.6.1.2.1.131.2
entStateCompliances	1.3.6.1.2.1.131.2.1
entStateCompliance	1.3.6.1.2.1.131.2.1.1			The compliance statement for systems supporting the Entity State MIB.
entStateGroups	1.3.6.1.2.1.131.2.2
entStateGroup	1.3.6.1.2.1.131.2.2.1			Standard Entity State group.
entStateNotificationsGroup	1.3.6.1.2.1.131.2.2.2			Standard Entity State Notification group.

RFC description

RFC 4268-defined MIB that extends Entity MIB with state information for physical components, including operational, administrative, usage, alarm, and standby states. Provides textual conventions for standardized entity state reporting.

Start monitoring Chassis-based router/switch with modular/redundant hardware (entity state extension, vendor-neutral IETF standard RFC 4268) 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 ENTITY-STATE-MIB

What Is ENTITY-STATE-MIB?

Supported Devices

Monitoring Examples

What Can Be Monitored

This MIB depends on

Related MIBs

RFC description