Cisco IOS Software Releases 11.3

Table Of Contents

Health Monitor

Description

Benefits

List of Terms

Prerequisites

Configuration Tasks

Monitor Shelf Attributes

Configuration Examples

Command Reference

show syscon mibpoll

show syscon monitor

syscon monitor

syscon monitor traps

Supported MIBs and RFCs

Health Monitor

---

Description

The Health Monitor feature monitors key performance attributes of the shelves managed by the system controller.

The Health Monitor feature continually polls its managed shelves to obtain the information stored in the Health Monitor MIB. Management stations collect information for all the shelves from the system controller rather than by polling each shelf individually.

In addition, you can configure specific performance thresholds for all managed shelves through simple commands on the system controller. The system controller uses SNMP to automatically configure the following on each managed shelf:

•Expressions in the EXPRESSION-MIB to calculate the attributes

•RMON alarms to poll the attributes at specific intervals

•RMON events to send traps to the system controller when an attribute exceeds its specified threshold

When threshold traps are received by the system controller, they are converted to Health Monitor traps and sent to trap destinations configured in the system controller.

Benefits

The Health Monitor feature provides the following benefits:

•Simplified configuration of SNMP-based monitoring functions. Entering a few commands on the system controller configures all of the managed shelves to send traps.

•Management systems poll only the system controller to get Health Monitor MIB data. The management systems do not have to poll the individual shelves. Thus, this feature reduces network traffic and system resources used by management systems.

List of Terms

shelf—An access server or router managed by the system controller.

system controller—A Cisco IOS-based device that aids in the monitoring and management of a number of access servers and routers.

Prerequisites

In order to use this feature, you must first configure the Shelf Discovery and Autoconfiguration feature. Refer to the "Shelf Discovery and Configuration" feature documentation for these tasks.

In addition, the SNMP Manager feature should be configured on the system controller. Use the snmp-server manager command to enable this feature. Refer to the "SNMP Manager" feature documentation from 11.3(1)T for details.

Configuration Tasks

When the Shelf Discovery and Autoconfiguration feature is enabled, the system controller automatically polls its managed shelves for Health Monitor MIB data. The system controller polls all the discovered shelves once a minute to obtain this data. Use the show syscon mibpoll EXEC command to display the current Health Monitor MIB data.

Optionally, you can configure the managed shelves to monitor certain attributes and notify the system controller when the attribute thresholds are exceeded, as described in the following section.

Monitor Shelf Attributes

To configure monitored attributes for the managed shelves, perform the following tasks in global configuration mode on the system controller:

Task	Command
Specify attributes for the system controller to monitor.	syscon monitor {io-mem percent | modem percent | trunk percent}
Enable Health Monitor MIB trap forwarding on the system controller.	syscon monitor traps
Specify where the system controller sends the traps.	snmp-server host host [version {1 | 2c}] community-string [udp-port port]
Enable trap generation on the system controller.	snmp-server enable traps

The Health Monitor MIB traps sent by the system controller are more readable than the traps sent to the system controller from the managed shelves. In order to send Health Monitor MIB traps to a management station, you should configure the syscon monitor traps command, the snmp-server enable traps command, and the appropriate snmp-server host command.

To view the status of the monitoring process, use the show syscon monitor EXEC command.

Configuration Examples

The following system controller sample configuration monitors three attributes and forwards traps to myhost.cisco.com.

! The following commands are configured as part of the Shelf Discovery and 

! Autoconfiguration feature.

!

syscon password syspassword

syscon community syscommunity

!

! The following lines configure the shelves to monitor IO memory on all the shelves and 

! total modem and trunk utilization.

! If IO memory utilization exceeds 10%, the shelf sends a trap to the system controller.

! If the total utilization of all modems or trunk on all shelves exceeds 5%, the system

! controller generates a trap.

!

syscon monitor modem 5

syscon monitor trunk 5

syscon monitor io-mem 10

!

! The following commands enable forwarding of traps. When the system controller receives

! a trap from a managed shelf or generates one itself, it forwards the trap to the host 

! called myhost using the community string public.

!

syscon monitor traps

snmp-server host myhost.cisco.com public

snmp-server enable traps

!

! The following line enables the SNMP manager process.

!

snmp-server manager

You can view the current configuration of Health Monitor on the system controller with the show syscon monitor command.

nnm3640-2# show syscon monitor

Health Monitor setup status on the shel(f,ves):

Shelf#  Shelf IP Address        Monitoring Type Threshold Value Status

    3   172.23.66.109           IO-Mem            10            Active

Health Monitor setup status on the system controller:

Monitoring Type Threshold Value Status

 Trunk            5             Active

 Modem            5             Active

The system will automatically configure each shelf to monitor its IO memory utilization. You can check the RMON configuration using the show rmon alarms and show rmon events commands on a managed shelf.

nnm7206-6# show rmon alarms

Alarm 596 is active, owned by IOMem

 Monitors ciscoExperiment.22.1.4.1.1.2.1.0.0.0 every 120 second(s)

 Taking absolute samples, last value was 66

 Rising threshold is 10, assigned to event 514

 Falling threshold is 0, assigned to event 0

 On startup enable rising or falling alarm

nnm7206-6# show rmon events

Event 514 is active, owned by IOMem

 Description is Send snmp trap to health_monitor

 Event firing causes trap to community syscommunity, last fired 00:04:02

Command Reference

This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 11.3 command references.

•show syscon mibpoll

•show syscon monitor

•syscon monitor

•syscon monitor traps

show syscon mibpoll

To display information about managed shelves contained in the Health Monitor MIB, use the show syscon mibpoll EXEC command.

show syscon mibpoll

Syntax Description

This command has no arguments or keywords.

Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 11.3 AA.

This command displays the shelf statistics contained in the Health Monitor MIB on the system controller. The system controller collects this information from its managed shelves.

Sample Display

The following is sample output from the show syscon mibpoll command:

Router# show syscon mibpoll

Healthmon MIB count entry status:

Shelf ID 1 MIB entries last update 18:22:06 EDT Jan 12 1998. 

T1E1 Lines      DS0s            Modems

Up      Down    Active  Total   Total   Inuse   Unavailable

1       1       23      46      24      0       0

IO Mem          CPU     EgressPort      EgressPort

Used    Free    Busy1   InOctetUtil     OutOctetUtil

1378476 7010132 20      0               0

Healthmon MIB summary of count entry status:

Total   Total           Total           Total

Shelves T1E1 Lines      DS0s            Modems

        Up      Down    Active  Total   Total   Inuse   Unavailable

1       1       1       23      46      24      0       0

describes the fields shown in this display.

Table 1 Show Syscon Mibpoll Output Field Descriptions 

Field	Description
Shelf ID	Shelf ID of the managed shelf.
last update	Last time the system controller polled these MIB variables on the managed shelf.
T1E1 Lines
Up	Number of TI/EI lines up.
Down	Number of TI/EI lines with operational status down and administrative status up.
DSOs
Active	Number of active DSO's.
Total	Number of DSO's.
Modems
Total	Number of installed modems.
Inuse	Number of modems being used.
Unavailable	Number of modems that are not being used but cannot accept calls.
IO Mem
Used	Number of bytes of IO memory that are currently in use by applications on the managed device.
Free	Number of bytes of IO memory that are currently available to use on the managed device.
CPU Busy1	Exponentially decayed moving average of the CPU busy percentage.
EgressPort InOctetUtil	Percent utilization of total number of octets received on all the active egress interfaces, including framing characters. A port is considered to be an egress port if the port speed is greater than 1544000 bps.
EgressPort OutOctetUtil	Percent utilization of the total number of octets transmitted out on all the active egress interfaces, including framing characters. A port is considered to be an egress port if the port speed is greater than 1544000 bps.
Total Shelves	Number of shelves polled.
Total T1E1 Lines
Up	Total number of TI/EI lines up in all managed shelves.
Down	Total number of TI/EI lines with operational status down and administrative status up in all managed shelves.
Total DSOs
Active	Total number of active DSO's in all managed shelves.
Total	Total number of DSO's in all managed shelves.
Total Modems
Total	Total number of installed modems in all managed shelves.
Inuse	Total number of modems being used in all managed shelves.
Unavailable	Total number of modems unavailable for use.

Related Commands

show syscon monitor
syscon monitor
syscon monitor traps

show syscon monitor

To display information about monitored shelf attributes, use the show syscon monitor EXEC command.

show syscon monitor

Syntax Description

This command has no arguments or keywords.

Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 11.3 AA.

This command is useful in determining the current status of monitored shelves.

Sample Display

The following example is sample output from the show syscon monitor command. The first group of lines show attributes being monitored separately on each shelf. The second group of lines show monitored attributes for all shelves combined.

Router# show syscon monitor 

Health Monitor setup status on the shel(f,ves):

Shelf#  Shelf IP Address        Monitoring Type Threshold Value Status

    1   172.27.32.173           IO-Mem            11             Active

Health Monitor setup status on the system controller:

Monitoring Type Threshold Value Status

 Trunk            12             Active

 Modem            50             Active

describes the fields shown in this display.

Table 2 Show Syscon Monitor Output Field Descriptions

Field	Description
Shelf#	Shelf ID of the managed shelf.
Shelf IP Address	IP address of the managed shelf.
Monitoring Type	Attribute being monitored, as set by the syscon monitor command.
Threshold Value	Threshold value for the attribute. If the attribute exceeds this value, the shelf will send a trap to the system controller for individually monitored attributes, or the system controller will generate a trap for combined attributes.
Status	Current status of threshold monitoring on the managed shelf.

Related Commands

show syscon mibpoll
syscon monitor
syscon monitor traps

syscon monitor

To specify attributes for the Health Monitor on the system controller to monitor, use the syscon monitor global configuration command. The no form of this command disables monitoring for the specified attribute.

syscon monitor {io-mem percent | modem percent | trunk percent}
no syscon monitor [io-mem | modem | trunk]

Syntax Description

io-mem	Monitors shelf IO memory utilization.
modem	Monitors total modem utilization for all shelves combined.
trunk	Monitors total DS0 utilization for all shelves combined.
percent	Percent utilization value for triggering traps.

Default

The system controller does not monitor any attributes.

Command Mode

Global configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 11.3 AA.

When you configure the syscon monitor command on the system controller, the system controller automatically configures each managed shelf to generate traps. The system controller will use SNMP to configure the following:

•Expressions in the CISCO-EXPRESSION-MIB to calculate the attributes

•RMON alarms to poll the attributes at specific intervals

•RMON events to send traps to the system controller when an attribute exceeds its specified threshold

For attributes that are total percentages for all shelves combined, the system controller uses the information in the Health Monitor MIB to calculate the current total percentage. For example, the system controller calculates the total modem usage percentage from the individual usage values in the Health Monitor MIB.

Enter this command once for each attribute you wish to monitor.

Example

The following example configures the managed shelves to monitor IO memory and shelf utilization. If IO memory utilization exceeds 80 percent or modem utilization exceeds 70 percent, the shelf sends a trap to the system controller.

syscon password blue

syscon community public

syscon monitor io-mem 80

syscon monitor modem 70

snmp-server manager

Related Commands

show syscon mibpoll
show syscon monitor
syscon monitor traps

syscon monitor traps

To enable Health Monitor MIB traps on the system controller, use the syscon monitor traps global configuration command. The no form of this command disables Health Monitor MIB traps.

syscon monitor traps
no syscon monitor traps

Syntax Description

This command has no arguments or keywords.

Default

The system controller does not send traps.

Command Mode

Global configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 11.3 AA.

This command enables the system controller to send Health Monitor MIB traps to network management stations. When the system controller receives a threshold trap from one of its managed shelves or generates a Health Monitor trap itself, it will forward the trap on to the management stations.

The traps are sent to the SNMP managers as specified by the snmp-server hosts command. You must configure this command in order to send traps from the system controller. In addition, enable trap generation using the snmp-server enable traps command.

Use the syscon monitor command to specify which threshold traps to configure on the shelves. If you do not specify enabled traps through the syscon monitor command, the system controller will not receive any traps from its managed shelves.

Example

The following example configures the router to send traps to the host myhost.cisco.com using the community string public. The system controller will generate modem utilization traps if the total modem utilization exceeds 70 percent.

syscon password blue

syscon community public

syscon monitor modem 70

syscon monitor traps

snmp-server host myhost.cisco.com public

snmp-server enable traps

snmp-server manager

Related Commands

show syscon mibpoll
show syscon monitor
snmp-server enable traps
snmp-server host
syscon monitor

Supported MIBs and RFCs

This feature implements the Health Monitor MIB and utilizes MIB2 and POP-MGMT-MIB on the managed shelves.