CISCO-HEALTH-MONITOR-MIB

All MIBs › CISCO-HEALTH-MONITOR-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2003-09-12

Category: Cisco Devices, Device Management

Description: Provides management objects for monitoring the health of server processes and applications on Cisco IOS platforms with embedded server functions.

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 CISCO-HEALTH-MONITOR-MIB?

CISCO-HEALTH-MONITOR-MIB is a Cisco proprietary MIB implementing an event-driven health-scoring model for IOS platforms with embedded server/application functions, aggregating internally generated hardware and software fault events into a per-subsystem health metric. It exposes a table of subsystems each with a computed health value, configurable high/low notification thresholds, and separate counters for catastrophic, critical, high, medium, and low severity faults. This MIB is directly and explicitly about monitoring hardware and software status: it summarizes detrimental or correctional changes in hardware or software state into an at-a-glance health score per subsystem, with severity-bucketed fault counts letting an admin quickly gauge how serious any detected problems are. It is a self-contained Cisco proprietary model without a strong dependency on external IETF MIBs, though it conceptually parallels entity/fault-management MIB approaches. It is deployed on Cisco IOS/IOS-XE platforms running embedded server or application subsystems where operators want a consolidated health signal rather than parsing raw fault logs. Network engineers evaluating or troubleshooting this functionality can download the CISCO-HEALTH-MONITOR-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-HEALTH-MONITOR-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 IOS/IOS-XE platforms with embedded server/application subsystems

Monitoring Examples

An admin can poll ciscoHealthMonitorTable/ciscoHealthMonitorEntry to read ciscoHealthMonitorHealth per ciscoHealthMonitorSubsysName, and set ciscoHealthMonitorHealthNotifyLowThreshold so an SNMP trap fires when a subsystem's health score drops below an acceptable level. Rising ciscoHealthMonitorCatastrophicFaults or ciscoHealthMonitorCriticalFaults counts on a specific subsystem would immediately flag which internal component is failing before overall device health visibly degrades.

What Can Be Monitored

per-subsystem health score
catastrophic fault count
critical fault count
high/medium/low severity fault counts
health notification thresholds

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From ENTITY-MIB

entPhysicalIndex

OBJECT-TYPE

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Gauge32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE

From SNMPv2-TC

TEXTUAL-CONVENTION
TruthValue

How to Use in IPNetwork Monitor

Example using ciscoHealthMonitorCatastrophicFaults OID:

Select a Cisco IOS/IOS-XE platforms with embedded server/application subsystem 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 ciscoHealthMonitorCatastrophicFaults 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 number of catastrophic faults that have occurred in this subsystem on the specified entity since the system was initialized. 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
ciscoHealthMonitorMIB	1.3.6.1.4.1.9.9.243			Health Monitor MIB module. The Health Monitor uses a model based on events of varying severity and frequency, and predefined rules, to generate a metric that represents a system's (and its subsystems') level of health. The events are typically internally generated notifications in response to detrimental or correctional changes in the state of the hardware or software of the system. Detrimental events are classified under one of the following severity levels: Catastrophic - Causes or leads to system failure Critical - Major subsystem or functionality failure High - Potential for major impact to important functions Medium - Potential for minor impact to functionality Low - Negligible impact to functionality Whilst correctional events fall under the following classification: Positive - Not a fault event. May cause or lead to the return of functionality This MIB module provides information for tracking occurrences of the above events, and presents the associated health metric for the system and its component subsystems.
ciscoHealthMonitorMIBNotifs	1.3.6.1.4.1.9.9.243.0
NTF ciscoHealthMonitorHealthLevel	1.3.6.1.4.1.9.9.243.0.1			A ciscoHealthMonitorHealthLevel notification is sent when the health of a subsystem reaches either the ciscoHealthMonitorHealthNotifyLowThreshold or ciscoHealthMonitorHealthNotifyHighThreshold threshold as described above.
ciscoHealthMonitorMIBObjects	1.3.6.1.4.1.9.9.243.1
ciscoHealthMonitorTable	1.3.6.1.4.1.9.9.243.1.1		not-accessible	This table contains Health Monitor statistics for physical entities and their constituent hardware and/or software subsystems. The Health Monitor statistics present in each row provide information such as the computed health of the indicated subsystem and the number of faults it has experienced.
ciscoHealthMonitorEntry	1.3.6.1.4.1.9.9.243.1.1.1		not-accessible	A Health Monitor statistics entry. The entPhysicalIndex identifies the physical entity (chassis or container), while the ciscoHealthMonitorSubsysName identifies by name the appropriate subsystem for which these statistics apply. If there are other entities such as peer routers or line cards then, in the context of this MIB, these are also defined to be in the same system. If these entities also run an instance of the Health Monitor then the summary information from the distributed Health Monitors is obtained here.
STR ciscoHealthMonitorSubsysName	1.3.6.1.4.1.9.9.243.1.1.1.1	SnmpAdminString	not-accessible	A textual string containing the name of the hardware or software subsystem. A management station wishing to obtain summary statistics for a physical entity should use a value of 'system' for this object.
HEA ciscoHealthMonitorHealth	1.3.6.1.4.1.9.9.243.1.1.1.2	HealthLevel	read-only	The computed current health of this subsystem on the specified entity. This health metric is based on predefined rules that specify how the health should be adjusted in response to certain events of varying severity and frequency. As these events are encountered by each subsystem or physical entity, the appropriate rules are applied and the health is modified accordingly.
T/F ciscoHealthMonitorHealthNotifyEnable	1.3.6.1.4.1.9.9.243.1.1.1.3	TruthValue	read-write	Enables or disables health level notifications. When set to true(1), the ciscoHealthMonitorHealthLevel notification is enabled. When set to false(0), the ciscoHealthMonitorHealthLevel notification is disabled. If such a notification is desired, it is the responsibility of the management entity to ensure that the SNMP administrative model is configured in such a way as to allow the notification to be delivered.
HEA ciscoHealthMonitorHealthNotifyHighThreshold	1.3.6.1.4.1.9.9.243.1.1.1.4	HealthLevel	read-write	Specifies the health level at which a ciscoHealthMonitorHealthLevel notification will be generated for the specified subsystem and entity. A notification will only be generated if the health level had previously reached the low threshold level prior to reaching this high threshold level. Health levels oscillating within the high and the low threshold levels do not generate notifications. A health level going from low threshold (or below) to high threshold (or above) represents a return to normal health for the specified subsystem. Set your optimal health level to this threshold.
HEA ciscoHealthMonitorHealthNotifyLowThreshold	1.3.6.1.4.1.9.9.243.1.1.1.5	HealthLevel	read-write	Specifies the health level at which a ciscoHealthMonitorHealthLevel notification will be generated for the specified subsystem and entity. A notification will only be generated if the health level had previously reached the high threshold level prior to reaching this low threshold level. Health levels oscillating within the high and the low threshold levels do not generate notifications. A health level going from high threshold (or above) to low threshold (or below) represents a deterioration of the health for the specified subsystem. Set your unacceptable health level to this threshold.
C32 ciscoHealthMonitorCatastrophicFaultsEx	1.3.6.1.4.1.9.9.243.1.1.1.6	Counter32	read-only	The number of catastrophic faults that have occurred in this subsystem on the specified entity since the system was initialized.
C32 ciscoHealthMonitorCriticalFaults	1.3.6.1.4.1.9.9.243.1.1.1.7	Counter32	read-only	The number of critical faults that have occurred in this subsystem on the specified entity since the system was initialized.
C32 ciscoHealthMonitorHighSeverityFaults	1.3.6.1.4.1.9.9.243.1.1.1.8	Counter32	read-only	The number of high severity faults that have occurred in this subsystem on the specified entity since the system was initialized.
C32 ciscoHealthMonitorMediumSeverityFaults	1.3.6.1.4.1.9.9.243.1.1.1.9	Counter32	read-only	The number of medium severity faults that have occurred in this subsystem on the specified entity since the system was initialized.
C32 ciscoHealthMonitorLowSeverityFaults	1.3.6.1.4.1.9.9.243.1.1.1.10	Counter32	read-only	The number of low severity faults that have occurred in this subsystem on the specified entity since the system was initialized.
C32 ciscoHealthMonitorPositiveEvents	1.3.6.1.4.1.9.9.243.1.1.1.11	Counter32	read-only	The number of positive events that have occurred in this subsystem on the specified entity since the system was initialized.
ciscoHealthMonitorMIBConform	1.3.6.1.4.1.9.9.243.2
ciscoHealthMonitorMIBCompliances	1.3.6.1.4.1.9.9.243.2.1
ciscoHealthMonitorMIBCompliance	1.3.6.1.4.1.9.9.243.2.1.1			The compliance statement for entities which implement the Cisco Health Monitor MIB
ciscoHealthMonitorMIBGroups	1.3.6.1.4.1.9.9.243.2.2
ciscoHealthMonitorGroup	1.3.6.1.4.1.9.9.243.2.2.1			The collection of objects providing health information.
ciscoHealthMonitorMIBNotificationGroup	1.3.6.1.4.1.9.9.243.2.2.2			Set of notifications implemented in this module.

RFC description

Health monitoring MIB for Cisco systems that uses event-based metrics to assess hardware and software health status. Tracks system-level health indicators through severity levels from catastrophic to positive corrective events.

Start monitoring Cisco IOS/IOS-XE platforms with embedded server/application subsystems 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-HEALTH-MONITOR-MIB