3.6 SNMPTrap_Async

Use this Knowledge Script to check for SNMP traps forwarded from NetIQ SNMP Trap Receiver. This script raises an event when an SNMP trap is received and when Trap Receiver is unavailable or subsequently becomes available. In addition, this script generates data streams for Trap Receiver availability.

This script checks for SNMP traps in the MIB tree. You can add MIBs (management information bases) to the MIB tree. For more information, see the AddMIBs Knowledge Script.

In general, a trap receiver is an application that receives traps from SNMP agents. NetIQ SNMP Trap Receiver (Trap Receiver) receives SNMP traps, filters them, and then forwards the traps to AppManager.

To run this Knowledge Script, you must configure SNMP permissions in Security Manager. For more information, see Section 2.5, Configuring SNMP Permissions.

To run this Knowledge Script, you must configure SNMP permissions in Security Manager. For more information, see Configuring SNMP Permissions section in the Management Guide.

3.6.1 Resource Object

SNMP_TrapReceiver

3.6.2 Default Schedule

By default, this script runs on an asynchronous schedule.

3.6.3 Setting Parameter Values

Set the following parameters as needed:

Parameter

How to Set It

Trap Filters

List of trap OIDs

Type the OIDs (object identifiers) of the traps you want to monitor. You can type one OID or a list of OIDs. Separate multiple OIDs with a comma, for example: 1.3.6.1.2.1.2.2.1.1.1,1.3.6.1.2.1.2.2.1.7.1

Full path to file with list of trap OIDs

If you have many OIDs to monitor, provide the full path to a file that contains a list of the OIDs. Each OID in the file should be on a separate line, for example:

1.3.6.1.2.1.2.2.1.1.1 1.3.6.1.2.1.2.2.1.7.1

Because the file must be accessible from the AppManager agent, the path must be a local directory on the agent computer or a UNC path.

Important If you type a UNC path, then the netiqmc service must be running as a user that has access to the path.

Event Notification

Raise trap events?

Set to Yes to raise an event when a trap message is received from Trap Receiver. The default is Yes.

Event severity when trap is received

Set the severity level, from 1 and 40, to indicate the importance of an event in which a trap is received. The default is 15.

Format trap data according to SNMP version

Select the version of SNMP whose formatting should be used for trap event messages. The data provided by each format is the same; only the layout is different.

An event message in SNMP v1 format looks like this:

An event message in SMMP v2 format looks like this:

Raise Trap Receiver availability events?

Set to Yes to raise an event when Trap Receiver becomes unavailable and when Trap Receiver becomes available once again. The default is Yes.

Event severity when Trap Receiver is unavailable

Set the severity level, from 1 to 40, to indicate the importance of an event in which Trap Receiver becomes unavailable. The default is 5.

Event severity when Trap Receiver becomes available

Set the severity level, from 1 to 40, to indicate the importance of an event in which Trap Receiver becomes available after being unavailable. The default is 25.

Data Collection

Collect data for Trap Receiver availability?

Set to Yes to collect data for charts and reports. If enabled, data collection returns a “1” if Trap Receiver is available and a “0” if Trap Receiver is unavailable. The default is unchecked.

Interval for collecting Trap Receiver availability data

Specify the frequency with which the script collects Trap Receiver availability data. The default is every 5 minutes.