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.