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-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: 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-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. /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, 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.