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 supported by Cumulus Linux, as well as suggested uses for them. The overall Cumulus Linux MIB is defined in the /usr/share/snmp/mibs/Cumulus-Snmp-MIB.txt file.

MIB Name
Suggested Uses
BGP4-MIB
OSPFv2-MIB
OSPFv3-MIB
RIPv2-MIB
You can enable FRRouting SNMP support to provide support for OSPF-MIB (RFC-1850), OSPFV3-MIB (RFC-5643), and BGP4-MIB (RFC-1657). See the FRRouting section above.
CUMULUS-BGPUN-MIB Cumulus Linux also includes its own BGP unnumbered MIB for BGP unnumbered peers, defined in /usr/share/snmp/mibs/Cumulus-BGPUN-MIB.txt, which has the OID 1.3.6.1.4.1.40310.7.
CUMULUS-COUNTERS-MIB Discard 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-POE-MIB The custom Power over Ethernet PoE MIB defined in the /usr/share/snmp/mibs/Cumulus-POE-MIB.txt file. For devices that provide PoE, this provides users with the system wide power information in poeSystemValues as well as per interface PoeObjectsEntry values for the poeObjectsTable. Most of this information comes from the poectl command. To enable this MIB, uncomment the following line in /etc/snmp/snmpd.conf:
#pass_persist .1.3.6.1.4.1.40310.3 /usr/share/snmp/cl_poe_pp.py
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, nexthops, ECMP groups, and layer 2 MAC/BDPU entries. The MIB is defined in /usr/share/snmp/mibs/Cumulus-Resource-Query-MIB.txt and 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 From RFC 4133, the temperature sensors, fan sensors, power sensors, and ports are covered.

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.
<mib_link url=“mibs/HOST-RESOURCES-MIB.txt” text=“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
pass_persist .1.2.840.10006.300.43 /usr/share/snmp/ieee8023_lag_pp.py
IF-MIB Interface description, type, MTU, speed, MAC, admin, operation status, counters.

Note: The IF-MIB cache is disabled 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-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. This is deprecated since the ENTITY-SENSOR MIB has been added.
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, not all supported MIBs are installed in Cumulus Linux. The MIBs that are not installed require the “non-free” archive to be added to /etc/apt/sources.list. To see which MIBs are installed 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. This is described here.

Installed MIBs