Chat now with support
Chat with Support

Foglight for Integrations 5.9.4 - User and Reference Guide

Using Foglight for Integrations Reference

Receiving SNMP Traps

Foglight for Integrations provides the capability to load Management Information Base (MIB) files. These MIB files contain trap definitions. The trap definitions define the traps that can be received and their variables. In Foglight, the trap definitions are used to configure the subsequent alarms that are sent to Foglight.

Loading MIB Definitions

To upload a MIB, navigate to the MIB Trap Configuration dashboard found on the navigation panel under Dashboards, and click Integration > SNMP Trap Administration > Configuration.

This page lists all loaded MIBs in the upper view. It contains all traps in the lower view. The MIB view identifies the MIB name and the timestamp when the MIB was loaded.

Click the Upload MIB button to begin the upload process. You are prompted for the location of the MIB file. Once supplied, click the Apply button to load the MIB. The results of the load are displayed in the upper view of the Configuration dashboard.

When a MIB is loaded that contains a trap definition, the trap shows up in the lower view and is disabled by default.

1
On the navigation panel, under Dashboards, click Integration > SNMP Trap Administration > Configuration.
3
Click Enable.

Configuring Alarms from SNMP Trap Definitions

Trap Definition configuration is used to format the alarm that is sent into Foglight.

1
On the navigation panel, under Dashboards, click Integration > SNMP Trap Administration > Configuration.
2
On the Configure Traps view, select Format for a Trap you want to configure.

 

Trap Variable

Trap variables are defined in the trap definition and passed in when a trap is received. These are sent as properties on the alarm. They can also be included in the message for the alarm.

Description

The Description is defined in the trap definition and passed in when a trap is received. This is sent as a property on the alarm. It can also be included in the message for the alarm.

OID

The Object Identifier (OID) of the trap as defined in the MIB file.

Message Format

The message format that is provided on the alarm sent into Foglight based on the trap information. Trap variables can be specified in the message. For example, if the trap variable ifIndex is included in the message, it would be written ${ifIndex}. Likewise, the description from the trap definition can be included in the message by using ${description}. You can use the variables ${host} ${trapname} and ${technologyMonitor} in the message format. The ${host} is where the trap came from.

Status

The status of a trap. The status can be either Enabled or Disabled.

Trap Duration

Forces an end time on the event sent into Foglight. The end time would be the start time of the trap with the duration added to it. Setting the Trap Duration to zero would keep the trap alarm open until it clears.

Grouping SNMP Traps

You can group SNMP traps together when they are monitoring the state on the same object. In this case, one trap may indicate an impact on an object, and another trap may indicate the correction of an issue on that object. These traps need to work together to portray the correct state of an object.

1
On the navigation panel, under Dashboards, click Integration > SNMP Trap Administration > SNMP Trap Groups.
2
Click Create.
1
On the navigation panel, under Dashboards, click Integration > SNMP Trap Administration > SNMP Trap Group.
The upper view lists all traps in the trap group and the variables associated with each trap. Variables can be selected to make the trap apply to a unique component on the device. For example, for Link Up and Link Down traps, if the ifIndex variable is not selected, a Link Up alarm on interface may close a Link Down alarm on interface. By selecting the ifIndex, the index would have to be the same for the alarms to clear one another.
1
On the navigation panel, under Dashboards, click Integration > SNMP Trap Administration > SNMP Trap Groups.
Related Documents