If you are using the current version of Cumulus Linux, the content on this page may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

Supported MIBs

Below are the MIBs that Cumulus Linux supports, as well as suggested uses for them. The /usr/share/snmp/mibs/Cumulus-Snmp-MIB.txt file defines the overall Cumulus Linux MIB.

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-MIBProvides 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-MIBDiscard counters: Cumulus Linux also includes its own counters MIB, defined in /usr/share/snmp/mibs/Cumulus-Counters-MIB.txt. It has the OID .1.3.6.1.4.1.40310.2.
CUMULUS-RESOURCE-QUERY-MIBCumulus Linux includes its own resource utilization MIB, which is similar to using cl-resource-query. This MIB monitors layer 3 entries by host, route, nexthops, ECMP groups, and layer 2 MAC/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-MIBSNMP counters. For information on exposing CPU and memory information with SNMP, see this knowledge base article.
DISMAN-EVENT-MIBTrap monitoring.
ENTITY-MIBCumulus 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-MIBPhysical sensor information (temperature, fan, and power supply) from RFC 3433.
HOST-RESOURCES-MIBUsers, 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-MIBImplementation 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
pass_persist .1.2.840.10006.300.43 /usr/share/snmp/ieee8023_lag_pp.py
IF-MIBInterface 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
# SNMPDOPTS='-y -LS 0-4 d -Lf /dev/null -u snmp -g snmp -I -smux -p /run/snmpd.pid'
SNMPDOPTS='-LS 0-4 d -Lf /dev/null -u snmp -g snmp -I -smux -p /run/snmpd.pid
IP-FORWARD-MIBIP routing table.
IP-MIB (includes ICMP)IPv4, IPv4 addresses counters, netmasks.
IPv6-MIBIPv6 counters.
LLDP-MIBLayer 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 MIBFan speed, temperature sensor values, voltages. The ENTITY-SENSOR MIB replaces this MIB.
NET-SNMP-AGENT-MIBAgent timers, user, group config.
NET-SNMP-VACM-MIBAgent timers, user, group config.
NOTIFICATION-LOG-MIBLocal logging.
SNMP-FRAMEWORK-MIBUsers, access.
SNMP-MPD-MIBUsers, access.
SNMP-TARGET-MIBSNMP-TARGET-MIB.
SNMP-USER-BASED-SM-MIBSUsers, access.
SNMP-VIEW-BASED-ACM-MIBUsers, access.
TCP-MIBTCP-related information.
UCD-SNMP-MIBSystem memory, load, CPU, disk IO.
UDP-MIBUDP-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, you need to install snmp-mibs-downloader and then either remove or comment out the “non-free” repository in /etc/apt/sources.list. Refer to Enable MIB-to-OID Translation.

Installed MIBs