CUMULUS-RESOURCES-MIB

All MIBs › CUMULUS-RESOURCES-MIB

Category: Hardware and Environment, Net-SNMP and Linux, Vendor: Cumulus Networks

Description: Monitors Cumulus Linux ASIC resource utilization including ACL, route, MAC, and forwarding table usage.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is CUMULUS-RESOURCES-MIB?

CUMULUS-RESOURCES-MIB is a vendor MIB from Cumulus Networks (now part of Nvidia) for Cumulus Linux, the Linux-based network operating system used on white-box and OEM switches; it monitors utilization of the switching ASIC's finite hardware resource tables. It exposes current-versus-maximum entry counts for key ASIC tables: Layer 3 host entries, Layer 3 routing table entries, next-hop entries, ECMP group entries, ECMP next-hop entries, and Layer 2 MAC table entries. This MIB is fundamentally a hardware-resource-exhaustion early-warning tool: because switching ASICs have fixed-size hardware tables, an operator monitors these current/max pairs to detect when the device is approaching a hard limit on routes, hosts, MAC addresses, or ECMP paths, after which new entries would silently fail to be programmed into hardware, causing traffic blackholing even though the software control plane appears healthy. It is specific to Cumulus Linux's own resource-reporting layer and is typically used alongside standard IF-MIB and vendor-neutral routing MIBs rather than replacing them. It is deployed on Cumulus Linux-powered data center switches (white-box/bare-metal switches from vendors like Dell, Mellanox/Nvidia, and Edgecore) especially in leaf-spine ECMP fabric designs. Network engineers evaluating or troubleshooting this functionality can download the CUMULUS-RESOURCES-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CUMULUS-RESOURCES-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Cumulus Linux-based data center switch (white-box/bare-metal, e.g. Dell, Nvidia/Mellanox, Edgecore)

Monitoring Examples

An administrator would poll l3RoutingTableCurrentEntries against l3RoutingTableMaxEntries to see how close the switch's hardware routing table is to full, since exceeding it means new routes can't be programmed into the ASIC. Comparing l3EcmpGroupTableCurrentEntries/l3EcmpNextHopTableCurrentEntries to their max counterparts reveals whether a leaf-spine fabric's ECMP path scale is approaching the hardware ceiling, a common failure mode in large fabrics. A sustained l2MacTableCurrentEntries value near its maximum would indicate the MAC table is nearly full, risking flooding once it overflows; the module description confirms these objects represent counts such as "the number of L3 Host table entries currently in use," consistent with this resource-exhaustion monitoring pattern.

What Can Be Monitored

L3 host table usage
L3 routing table usage
next-hop table usage
ECMP group table usage
ECMP next-hop table usage
L2 MAC table usage

Imported Objects

From CUMULUS-SNMP-MIB

DateAndTime
DisplayString
cumulusMib	MODULE-IDENTITY

From IF-MIB

InterfaceIndex
ifIndex	OBJECT-TYPE

From SNMPv2-SMI

Integer32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
enterprises

From SNMPv2-TC

TEXTUAL-CONVENTION

How to Use in IPNetwork Monitor

Example using l3HostTableCurrentEntries OID:

Select a Cumulus Linux data center switch (ASIC resource table utilization) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type l3HostTableCurrentEntries into the Find box to locate it in the OID tree, then select it and click OK. The number of L3 Host table entries currently in use. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is an INTEGER-type OID, Value bounds is the most useful condition here — trigger an alert if the count changes from its expected baseline, since that would indicate the underlying set of items changed unexpectedly. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
resourceUtilization	1.3.6.1.4.1.40310.1
l3Tables	1.3.6.1.4.1.40310.1.1
INT l3HostTableCurrentEntriesEx	1.3.6.1.4.1.40310.1.1.1	INTEGER	read-only	The number of L3 Host table entries currently in use
INT l3HostTableMaxEntries	1.3.6.1.4.1.40310.1.1.2	INTEGER	read-only	The maximum possible entries in the L3 Host table. The Host table is defined as the table holding the ARP/ND cache.
INT l3RoutingTableCurrentEntries	1.3.6.1.4.1.40310.1.1.3	INTEGER	read-only	The number of L3 Routing table entries currently in use.
INT l3RoutingTableMaxEntries	1.3.6.1.4.1.40310.1.1.4	INTEGER	read-only	The maximum possible entries in the L3 Routing table. L3 Routing table is defined as the table holding the longest prefix match (LPM) entries.
INT l3NextHopTableCurrentEntries	1.3.6.1.4.1.40310.1.1.5	INTEGER	read-only	The number of L3 Next Hop table entries currently in use.
INT l3NextHopTableMaxEntries	1.3.6.1.4.1.40310.1.1.6	INTEGER	read-only	The maximum possible entries in the L3 Next Hop table. The L3 Next Hop table holds information about the next hop(s) associated with a routing table entry.
INT l3EcmpGroupTableCurrentEntries	1.3.6.1.4.1.40310.1.1.7	INTEGER	read-only	Number of ECMP Group table entries currently in use.
INT l3EcmpGroupTableMaxEntries	1.3.6.1.4.1.40310.1.1.8	INTEGER	read-only	The maximum possible entries in the ECMP Group table. The ECMP Group table holds information about
INT l3EcmpNextHopTableCurrentEntries	1.3.6.1.4.1.40310.1.1.9	INTEGER	read-only	The number of ECMP Next Hop table entries currently in use.
INT l3EcmpNextHopTableMaxEntries	1.3.6.1.4.1.40310.1.1.10	INTEGER	read-only	The maximum possible entries in the ECMP Next Hop table. ECMP Next Hop table stores information about the next hop associated with a routing table entry that has multiple equal cost next hop neighbors.
l2Tables	1.3.6.1.4.1.40310.1.2
INT l2MacTableCurrentEntries	1.3.6.1.4.1.40310.1.2.1	INTEGER	read-only	The number of L2 Mac table entries currently in use.
INT l2MacTableMaxEntries	1.3.6.1.4.1.40310.1.2.2	INTEGER	read-only	The maximum possible entries in the L2 Mac table.
INT l2CacheTableCurrentEntries	1.3.6.1.4.1.40310.1.2.3	INTEGER	read-only	The number of Cache table currently entries in use
INT l2CacheTableMaxEntries	1.3.6.1.4.1.40310.1.2.4	INTEGER	read-only	The maximum possible entries in the Cache table. The Cache table holds entries that are to be redirected to the CPU because they are control packets, specifically L2 protocol control packets. Examples are STP BPDUs, LLDP BPDUs etc.
bufferUtilizn	1.3.6.1.4.1.40310.1.3
STR bufUtiliznComputeTime	1.3.6.1.4.1.40310.1.3.1	DisplayString	read-only	The time when the buffer utilization statistic was computed.
INT bufUtiliznPollInterval	1.3.6.1.4.1.40310.1.3.2	INTEGER	read-only	The periodicity at which the buffer utilization data is pulled from the hardware. This is specified in milliseconds.
INT bufUtiliznMeasureInterval	1.3.6.1.4.1.40310.1.3.3	INTEGER	read-only	The time interval over which the buffer utilization statistics is computed. This is specified in minutes.
bufUtiliznTable	1.3.6.1.4.1.40310.1.3.4		not-accessible	Table describes the ingress buffer utilization per service pool
bufUtiliznEntry	1.3.6.1.4.1.40310.1.3.4.1		not-accessible
INT bufServicePoolID	1.3.6.1.4.1.40310.1.3.4.1.1	INTEGER	read-only	The service pool number.
INT bufMin	1.3.6.1.4.1.40310.1.3.4.1.2	INTEGER	read-only	The minimum number of cells used in this service pool.
INT bufMax	1.3.6.1.4.1.40310.1.3.4.1.3	INTEGER	read-only	The maximum number of cells used in this service pool
STR bufAvg	1.3.6.1.4.1.40310.1.3.4.1.4	DisplayString	read-only	The average number of cells used in this service pool
STR bufVariance	1.3.6.1.4.1.40310.1.3.4.1.5	DisplayString	read-only	The variance of the buffer pool utilization for this service pool over the last measured interval.
STR bufStdDev	1.3.6.1.4.1.40310.1.3.4.1.6	DisplayString	read-only	The Standard Deviation of the buffer pool utilization for this service pool over the last measured interval.

RFC description

Resource utilization tracking for L3 tables, routing entries, and buffer usage in Cumulus Linux.

Start monitoring Cumulus Linux data center switch (ASIC resource table utilization) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download CUMULUS-RESOURCES-MIB