Supported MIBs
The following table lists the relevant Cumulus Linux network monitoring MIBs:
MIB Name | Suggested Uses |
---|---|
BGP4-MIB OSPFv2-MIB OSPFv3-MIB RIPv2-MIB | You can enable FRR SNMP support to provide support for OSPF-MIB (RFC-1850), OSPFV3-MIB (RFC-5643), and BGP4-MIB (RFC-1657). |
CUMULUS-BGPVRF-MIB | Provides monitoring for all BGP peer types (unnumbered, IPv4, and IPv6) in all VRFs. /usr/share/snmp/mibs/CUMULUS-BGPVRF-MIB.txt defines this MIB. |
CUMULUS-COUNTERS-MIB | Discard counters and interface counters. /usr/share/snmp/mibs/Cumulus-Counters-MIB.txt defines this MIB, which has the OID .1.3.6.1.4.1.40310.2 . |
CUMULUS-RESOURCE-QUERY-MIB | Cumulus Linux includes its own resource utilization MIB, which is similar to using cl-resource-query . This MIB monitors layer 3 entries by host, route (such as the total number of IPv4 routes in the FIB), nexthops, ECMP groups, and layer 2 MAC and BDPU entries. /usr/share/snmp/mibs/Cumulus-Resource-Query-MIB.txt defines this MIB, which has the OID .1.3.6.1.4.1.40310.1 . |
CUMULUS-SNMP-MIB | SNMP counters. For information on exposing CPU and memory information with SNMP, see this knowledge base article. |
DISMAN-EVENT-MIB | Trap monitoring. |
ENTITY-MIB | Cumulus Linux supports the temperature sensors, fan sensors, power sensors, and ports from RFC 4133. Note: The ENTITY-MIB does not show the chassis information in Cumulus Linux. |
ENTITY-SENSOR-MIB | Physical sensor information (temperature, fan, and power supply) from RFC 3433. |
HOST-RESOURCES-MIB | Users, storage, interfaces, process info, run parameters. |
BRIDGE-MIB Q-BRIDGE-MIB | The dot1dBasePortEntry and dot1dBasePortIfIndex tables in the BRIDGE-MIB and dot1qBase , dot1qFdbEntry , dot1qTpFdbEntry , dot1qTpFdbStatus , and dot1qVlanStaticName tables in the Q-BRIDGE-MIB tables. You must uncomment the bridge_pp.py pass_persist script in /etc/snmp/snmpd.conf . |
IEEE8023-LAG-MIB | Implementation of the IEEE 8023-LAG-MIB includes the dot3adAggTable and dot3adAggPortListTable tables. To enable this, edit /etc/snmp/snmpd.conf and uncomment or add the following lines:view systemonly included .1.2.840.10006.300.43 |
IF-MIB | Interface description, type, MTU, speed, MAC, admin, operation status, counters. Note: Cumulus Linux disables the IF-MIB cache by default. The non-caching code path in the IF-MIB treats 64-bit counters like 32-bit counters (a 64-bit counter rolls over after the value increments to a value that extends beyond 32 bits). To enable the counter to reflect traffic statistics using 64-bit counters, remove the -y option from the SNMPDOPTS line in the /etc/default/snmpd file. The example below first shows the original line, commented out, then the modified line without the -y option:cumulus@switch:~$ cat /etc/default/snmpd |
IP-FORWARD-MIB | IP routing table. |
IP-MIB (includes ICMP) | IPv4, IPv4 addresses counters, netmasks. |
IPv6-MIB | IPv6 counters. |
LLDP-MIB | Layer 2 neighbor information from lldpd (you need to enable the SNMP subagent in LLDP). You need to start lldpd with the -x option to enable connectivity to snmpd (AgentX). |
LM-SENSORS MIB | Fan speed, temperature sensor values, voltages. The ENTITY-SENSOR MIB replaces this MIB. |
NET-SNMP-AGENT-MIB | Agent timers, user, group config. |
NET-SNMP-VACM-MIB | Agent timers, user, group config. |
NOTIFICATION-LOG-MIB | Local logging. |
SNMP-FRAMEWORK-MIB | Users, access. |
SNMP-MPD-MIB | Users, access. |
SNMP-TARGET-MIB | SNMP-TARGET-MIB. |
SNMP-USER-BASED-SM-MIBS | Users, access. |
SNMP-VIEW-BASED-ACM-MIB | Users, access. |
TCP-MIB | TCP-related information. |
UCD-SNMP-MIB | System memory, load, CPU, disk IO. |
UDP-MIB | UDP-related information. |
List All Installed MIBs
Due to licensing restrictions, Cumulus Linux does not install all MIBs. For the MIBs that Cumulus Linux does not install, you must add the “non-free” archive to /etc/apt/sources.list
. To see which MIBs are on your switch, run ls /usr/share/snmp/mibs/
.
To install more MIBs, install snmp-mibs-downloader
, then either remove or comment out the “non-free” repository in /etc/apt/sources.list
. Refer to Enable MIB-to-OID Translation.
Considerations
The snmpd
service might cache SNMP MIB object values for performance reasons and update the values periodically. When you poll SNMP objects, the values returned might not reflect real time status changes for some period of time.