|
|
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:
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.
The Health Monitor feature provides the following benefits:
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.
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.
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.
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.
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
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.
To display information about managed shelves contained in the Health Monitor MIB, use the show syscon mibpoll EXEC command.
show syscon mibpollThis command has no arguments or keywords.
EXEC
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.
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
Table 1 describes the fields shown in this display.
| 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. |
show syscon monitor
syscon monitor
syscon monitor traps
To display information about monitored shelf attributes, use the show syscon monitor EXEC command.
show syscon monitorThis command has no arguments or keywords.
EXEC
This command first appeared in Cisco IOS Release 11.3 AA.
This command is useful in determining the current status of monitored shelves.
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
Table 2 describes the fields shown in this display.
| 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. |
show syscon mibpoll
syscon monitor
syscon monitor traps
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}
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. |
The system controller does not monitor any attributes.
Global configuration
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:
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.
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
show syscon mibpoll
show syscon monitor
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 trapsThis command has no arguments or keywords.
The system controller does not send traps.
Global configuration
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.
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
show syscon mibpoll
show syscon monitor
snmp-server enable traps
snmp-server host
syscon monitor
This feature implements the Health Monitor MIB and utilizes MIB2 and POP-MGMT-MIB on the managed shelves.
Posted: Fri Mar 5 20:35:39 PST 1999
Copyright 1989-1999©Cisco Systems Inc.