Cisco Stack Traps Test

This test intercepts the traps sent out by the Cisco Catalyst Switch, searches the traps for user-configured events, and reports the number of trap messages related to the configured events. Using the detailed diagnostics provided by this test, you can view the complete description of the trap messages that match your configuration, and thus capture critical errors/warnings thrown by the switch.

Target of the test : A CISCO Catalyst Switch

Agent deploying the test : An external agent

Outputs of the test : One set of results for each trap in the target switch being monitored.

Configurable parameters for the test

Parameter

Description

Test Period

How often should the test be executed.

Host

The host for which the test is to be configured.

Port

The port at which the application listens.

SourceAddress

Specify a comma-separated list of IP addresses or address patterns of the hosts sending the traps. For example, 10.0.0.1,192.168.10.*. A leading '*' signifies any number of leading characters, while a trailing '*' signifies any number of trailing characters.

OIDValue

Provide a comma-separated list of OID and value pairs returned by the traps. The values are to be expressed in the form, DisplayName:OID-OIDValue. For example, assume that the following OIDs are to be considered by this test: .1.3.6.1.4.1.9156.1.1.2 and .1.3.6.1.4.1.9156.1.1.3. The values of these OIDs are as given hereunder:

OID	Value
.1.3.6.1.4.1.9156.1.1.2	Host_system
.1.3.6.1.4.1.9156.1.1.3	NETWORK

In this case the OIDValue parameter can be configured as Trap1:.1.3.6.1.4.1.9156.1.1.2-Host_system,Trap2:.1.3.6.1.4.1.9156.1.1.3-Network, where Trap1 and Trap2 are the display names that appear as descriptors of this test in the monitor interface.

The test considers a configured OID for monitoring only when the actual value of the OID matches with its configured value. For instance, in the example above, if the value of OID .1.3.6.1.4.1.9156.1.1.2 is found to be Host and not Host_system, then the test ignores OID .1.3.6.1.4.1.9156.1.1.2 while monitoring.

An * can be used in the OID/value patterns to denote any number of leading or trailing characters (as the case may be). For example, to monitor all the OIDs that return values which begin with the letter 'F', set this parameter to Failed:*-F*.

TrapOIDs

By default, this parameter is set to all, indicating that the eG agent considers all the traps received from the specified source addresses. To make sure that the agent considers only specific traps received from the SourceAddress, then provide a comma-separated list of OIDs in the TrapOIDs text box. A series of OID patterns can also be specified here, so that the test considers only those OIDs that match the specified pattern(s). For instance, *94.2*,*.1.3.6.1.4.25*, where * indicates leading and/or trailing spaces.

ShowOID

Selecting the True option against ShowOID will ensure that the detailed diagnosis of this test shows the OID strings along with their corresponding values. If you select False, then the values alone will appear in the detailed diagnosis page, and not the OIDs.

DD Frequency

Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD frequency.

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

The eG manager license should allow the detailed diagnosis capability
Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.

Measurements made by the test
Measurement	Description	Measurement Unit	Interpretation
Total events	Indicates the number of trap messages of this event that were sent from this switch.	Number	The detailed diagnosis of this measure, if enabled, provides the host from which an SNMP trap originated, the time at which the trap was sent, and the details of the trap.