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 |
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 |
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.