Chat now with support
Chat with Support

Foglight for Integrations 5.9.6 - 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.

Related topics:
•
Loading MIB Definitions
•
Configuring Alarms from SNMP Trap Definitions
•
Grouping SNMP Traps
•
Configuring Agent Properties for the SNMP Trap Agent
•
Troubleshooting

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.

Figure 6. Configuration view

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.

* 
NOTE: Certain MIBs rely on other MIBs for additional definitions. Prerequisite MIBs must be loaded first, then subsequent MIBs, otherwise an error occurs. When removing MIBs, Foglight for Integrations detects if a MIB is a prerequisite to another MIB, and disables the Unload MIB button.

MIBs for many vendors can be found on the navigation panel, under Dashboards, and by choosing Administration > Cartridges > Components for Download. Click the Other MIBs link to download a compressed file. Once uncompressed, notice under each vendor directory the corresponding MIB files and an order.txt file that indicates the order in which the MIBs need to be loaded.

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

To enable trap definitions:
1
On the navigation panel, under Dashboards, click Integration > SNMP Trap Administration > Configuration.
A list of trap definitions associated with the loaded MIBs appears in the lower view.
2
On the Configure Traps view, select the check boxes for each trap you want to load.
Optional — to quickly select all configuration traps, click Select All.
3
Click Enable.
The Status icon updates.
* 
NOTE: Once the trap is enabled, configure it for creating an alarm in Foglight. By default, the severity is set to Normal. Alarms with a normal severity do not show up in the event browser.
Related topics:
•
What happens to traps that I do not have a MIB loaded for?
•
What happens if I load a MIB more than once?
•
Can I load a file that contains more than one MIB?

Configuring Alarms from SNMP Trap Definitions

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

To format traps:
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.
The Edit Trap view appears.
3
Set any of the following options:

 

Table 4. Format options and descriptions
Format Option
Description

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.

To create an SNMP Group:
1
On the navigation panel, under Dashboards, click Integration > SNMP Trap Administration > SNMP Trap Groups.
All trap groups are listed.
2
Click Create.
3
Type an SNMP Trap Group Name and then click Save.
To edit an SNMP Trap Group:
1
On the navigation panel, under Dashboards, click Integration > SNMP Trap Administration > SNMP Trap Group.
This presents two views. The first view lists all the traps that have currently been assigned to the group. The lower view contains a list of all the traps that are available.
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.
In the lower view, checking the option button next to a trap assigns the trap to the group. When checked, the trap moves to the upper view.
2
In the Ungrouped Trap view, click the option button for each trap you want to add to the Trap Group.
To remove a trap from an SNMP Trap group:
1
On the navigation panel, under Dashboards, click Integration > SNMP Trap Administration > SNMP Trap Groups.
2
Click Edit for the appropriate SNMP Trap Group.
3
On the Traps In Groups view, in the upper right portion of the display area, click Ungroup.
After removing SNMP Traps, the metadata and variable information is removed from their associated Alarms and the SNMP Configuration listing.
The Ungrouped Traps view updates to include the removed trap groups.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating