Trap Responder

The Notifications Trap Responder Screen displays all configured trap responders, and is used to create, edit, or delete Trap Responders. A Trap Responder enables you to specify a response (if any) that you want OmniVista to take when specified traps are received by OmniVista. You can specify the traps to which OmniVista will respond by IP address range, trap type, and severity level. OmniVista can make the following responses to receipt of a specified trap:

• OmniVista can send an e-mail to any address you specify. You can specify the information you want included in the e-mail through the use of variables. Variables exist for information such as the trap name, synopsis, description, etc.
• Forward traps to a specific IP address.

Creating a Trap Responder

Click on the Create icon to open the Trap Responder Wizard. Complete the configuration as described below to configure the Agent, Trap Type, and Response. Only traps originating from the specified Agent and Trap Type will trigger the configured response. After completing all of the screens in the Wizard, click on the Create button.

Agent

The Agent is the IP address range or AP Group of the Responder. The Responder will only respond to traps received from this IP address range or AP Group(s).

• Agent Type
  • Device - Enter an Agent Start IP and Agent End IP to specify the range.
  • AP Group - Select AP Group(s).

Note: If you have two devices with the same IP address in the configured IP range, you can use a filter (e.g., Agent Name) when configuring the responder to differentiate between the devices.

When you are finished, click the Next button to go the Trap Type window.

Trap Type

The Trap Type fields enable you to specify the traps to which OmniVista will respond by severity level; or, you can specify the traps to which OmniVista will respond using filters. Note that you can specify traps by severity level or filters, but you cannot specify traps using both severity levels and filters. (In other words, you cannot "AND" specified severity levels and specified filters to create an expression.) If you create a trap responder that specifies both severity level and filters, the trap responder will respond to all traps with the specified severity (even if they do not match the filter), and all traps that match the specified filters (even if they do not have the specified severity).

Severity Level

To select a severity level(s), move the corresponding slider to "Respond". OmniVista will send a response for any trap matching the selected severity level(s).

Filter

To use a filter, select "Any selected filter" (default) from the Must Match drop-down menu, then click on the Filter button to bring up the Filter Selection window and select a filter(s). OmniVista will send a response for any trap that matches any selected filter. If you select "All selected filters" from the Must Match drop-down menu, OmniVista will send a response for any trap that matches all of the selected filters.

To create a new filter, click on the Filter button to bring up the Filter Selection window, then click on the Add icon. Enter a Filter Name and optional Filter Description, then click on the "Add new condition" link to add a filter condition. Click on the "Add new condition" link to add additional conditions, if necessary. When you are finished, click on the Add button to add the new filter, then click on the Apply button. The following conditions can be configured for filters:

• Name
• Synopsis
• Agent
• Agent Name
• Date/Time
• Severity
• SNMP Variable.

When you are finished configuring the Trap Type, click the Next button to go the Response window.

Response

Complete the fields as described below to configure the Response action to any traps matching the configured criteria.

• Enable Responder - Enable (On)/Disable (Off) the Responder.
• Description - Enter a description for the Responder.
• Action - Select the action that the Responder will take if the configured criteria is met, then configure the applicable fields as described below.
  • Send an E-Mail - Responder will send an e-mail as configured below. Be sure to configure the configure the E-Mail settings in the Preferences application (Preferences - System Settings - Email). OmniVista will not send an E-Mail Responder unless these settings have been configured.
    • E-Mail To - Enter an e-mail address(es). Multiple e-mail addresses must be separated by a semi-colon (e.g., john.smith@al-enterprise.com; jane.sullivan@al-enterprise.com).
    • E-Mail Subject - By default, the following is included in the E-Mail Subject Line: "OmniVista: Trap(s) Received $TrapSeverityCount$" (explained in the Trap Variables section below). You can also enter any additional information you want to include in the subject line.
    • E-Mail Body - By default the variable $Details$ (explained in the Trap Variables section below) is included in the body of the e-mail. The variable automatically includes trap details in the body of the e-mail. You can also enter any additional information you want to include in the e-mail.
  • Forward Traps -Responder will forward traps to the specified IP address .
    • Destination IP - The destination IP address. Only one IP address can be entered per Responder. However, you can create multiple Responders to forward the trap to multiple recipients.
    • Destination Port - The destination UDP port number (Default = 162).

When you are finished, click the Next button to go the Summary window.

Trap Variables

You can use the following variables when you configure an automatic trap responder. There are two types of variables: generic variables (which currently apply only to traps) and trap-specific variables.

Generic Variables

$Details$
For traps, this variable is equivalent to the following combination of text and trap-specific variables (trap-specific variables are described in the following section):

Trap Received: $TrapName$
Severity: $TrapSeverity$
Synopsis: $TrapSynopsis$
Agent: $TrapAgent$
Variables: $TrapVariables$

Output Example:
Trap Received: portPartitioned
Severity: Minor
Synopsis: Port jabber on slot 7 frtrunking port 1 instance 156 (port state alternated between enabled and disabled more than 50 times in 200 ms)
Agent: 128.251.30.27

$Synopsis$
For traps, this variable is equivalent to the trap-specific variable $TrapSynopsis$, which is a brief description of the trap.

Output Example: Port jabber on slot 7 frtrunking port 1 instance 156 (port state alternated between enabled and disabled more than 50 times in 200 ms)

Trap Specific Variables

$TrapName$
The name of the trap (as defined in the MIB)

Output Example: portPartitioned

$TrapSynopsis$
A brief description of the trap.

Output Example: Port jabber on slot 7 frtrunking port 1 instance 156 (port state alternated between enabled and disabled more than 50 times in 200 ms)

$TrapDescription$
A detailed description of the trap (as it appears in the MIB)

Output Example: A portPartitioned trap occurs when the physical port has transitioned through enable/disable states faster than 10 times in the past second...indicative of a flaky cable.

$TrapSeverity$
The severity level assigned to the trap in the Notifications application's Trap Definitions pane. The severity level can be Normal, Warning, Minor, Major, or Critical.

Output Example: Minor

$TrapSeverityCount$
A summary of the trap severity counts.

Output Example: (2 Critical)

$TrapSeverityInt$
The severity level assigned to the trap in the Notifications application's Trap Definitions pane, expressed as an integer. The severity level integer can be 1 (Normal), 2 (Warning), 3 (Minor), 4 (Major), or 5 (Critical).

Output Example: 3

$TrapSnmpVersion$
The version of the trap request, either 1 (version 1) or 2 (version 2).

All traps sent with SNMP version 1 protocol are "version 1" trap requests. All traps sent with SNMP versions 2, 2c, or 3 protocol are "version 2" trap requests. There are actually two different types of trap requests (not three). The message packet in which trap requests are sent can be one of four different versions: 1, 2, 2c, or 3. When you use the AOS CLI to create a version 1 trap station, version 1 traps in version 1 protocol are sent to that station. When you use the AOS CLI to create a version 2 trap station, version 2 traps in version 2c protocol are sent to that station. When you use the AOS CLI to create a version 3 trap station, version 2 traps in version 3 protocol are sent to that station. The version 2 trap request itself is identical whether wrapped in a version 2 or version 3 packet.

Output Example: 1

$TrapSource$
The IP address of the switch that generated the trap.

Output Example: 127.0.0.1

$TrapUpTime$
The length of time the switch that sent the trap has been up (or the amount of time since the last reset).

Output Example: 21 hours, 35 minutes, 49 seconds

$TrapAgent$
The IP address of the SNMP agent.

Output Example: 128.251.30.27

$TrapAgentName$
The name of the switch that generated the trap.

Output Example: NMS-6450

$TrapV1Enterprise$
The enterprise name. This only applies to SNMP Version 1 traps.

Output Example: .1.3.6.1.4.1.800.3.1.1

$TrapV1GenericID$
The generic trap number. This only applies to SNMP Version 1 traps.

Output Example: 6

$TrapV1SpecificID$
The enterprise trap number. This only applies to SNMP Version 1 traps.

Output Example: 10

$TrapVariables$
Describes all of the variables in the trap.

$TrapVariable[1]$, $TrapVariable[2]$...
Accesses the first (second, etc.) variable in the trap.

$TrapVariable[someVariableName]$
Accesses the trap variable by its name.

Summary

The Summary window displays the Responder configuration. Click on the Create button to create the Responder. If necessary, click on the Back button to make any changes before creating the Responder.

Editing a Trap Responder

Select the Responder in the Trap Responder List and click on the Edit icon. Edit the Agent and Trap Type as described above, then click on the Apply button.

Deleting a Trap Responder

Select the Responder(s) in the Trap Responder List, click on the Delete icon, then click OK at the confirmation prompt.

Viewing Trap Responders

The Trap Responder List displays basic trap responder information (e.g., trap type, response description). Click on a trap responder to display more detailed formation. By default, all of the columns below are displayed. However, you can click on the Settings icon at the top of the screen to add/remove columns to/from the display.

• Agent - The network region or IP address range configured for the Responder. The Responder will only respond to traps received from this region or IP address range.
• Trap Type - The severity level(s) or filter(s) configured for the Responder. The Responder will only respond to traps with this (these) severity level(s) or filter(s). You can also create filters for any or all of the Responder
• Response Description - The user-configured Response Description.
• Enable Responder - Indicates whether or not the Responder is enabled (True) or disabled (False).