CUMULUS-BGPUN-MIB

All MIBs › CUMULUS-BGPUN-MIB

Organization: Cumulus Networks/Nvidia

Last Updated: 2020-10-12

Category: Net-SNMP and Linux, Routing Protocols, Vendor: Cumulus Networks

Description: Monitors BGP unnumbered session state, prefix counts, and peer status on Cumulus Linux networking OS.

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-BGPUN-MIB?

CUMULUS-BGPUN-MIB is a Cumulus Networks/Nvidia proprietary MIB reporting BGP Unnumbered peering status (a Cumulus Linux feature establishing BGP sessions over IPv6 link-local addresses without numbered IP interfaces, common in data-center Clos fabrics). Its objects cover BGP version and local AS, and a peer table (identifier, state, admin status, negotiated version, local/remote address and port, remote AS, inbound/outbound update and total-message counts, last error, FSM-established transition count and time, connect-retry interval, hold time and keepalive, both negotiated and configured). As a protocol-status MIB it lets an administrator confirm a BGP Unnumbered peer's session state and watch its FSM transition count for flapping. It is deployed on Cumulus Networks/Nvidia switches running Cumulus Linux. Engineers can download the CUMULUS-BGPUN-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CUMULUS-BGPUN-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 Networks/Nvidia switches (Cumulus Linux)

Monitoring Examples

An administrator checks bgpPeerFsmEstablishedTransitions to catch a flapping BGP Unnumbered peer on a Cumulus Linux switch in a data-center fabric.

What Can Be Monitored

BGP Unnumbered peer session state and stability

Imported Objects

From CUMULUS-SNMP-MIB

cumulusMib

MODULE-IDENTITY

From IF-MIB

ifIndex

OBJECT-TYPE

From INET-ADDRESS-MIB

InetAddress
InetAddressIPv6

From SNMPv2-SMI

Counter32
Gauge32
Integer32
IpAddress
MODULE-IDENTITY
OBJECT-TYPE

From SNMPv2-TC

DisplayString
TEXTUAL-CONVENTION
TimeStamp

How to Use in IPNetwork Monitor

Example using bgpPeerInUpdates OID:

Select a Cumulus Networks/Nvidia switch (Cumulus Linux, BGP Unnumbered) 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 bgpPeerInUpdates into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. The number of BGP UPDATE messages received on this connection. 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 a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
bgp	1.3.6.1.4.1.40310.4
OCT bgpVersion	1.3.6.1.4.1.40310.4.1	OCTET STRING	read-only	Vector of supported BGP protocol version numbers. Each peer negotiates the version from this vector. Versions are identified via the string of bits contained within this object. The first octet contains bits 0 to 7, the second octet contains bits 8 to 15, and so on, with the most significant bit referring to the lowest bit number in the octet (e.g., the MSB of the first octet refers to bit 0). If a bit, i, is present and set, then the version (i+1) of the BGP is supported.
INT bgpLocalAs	1.3.6.1.4.1.40310.4.2	INTEGER	read-only	The local autonomous system number.
bgpOuterTable	1.3.6.1.4.1.40310.4.3
bgpPeerTable	1.3.6.1.4.1.40310.4.3.1		not-accessible	BGP peer table. This table contains, one entry per BGP peer, information about the connections with BGP peers.
bgpPeerEntry	1.3.6.1.4.1.40310.4.3.1.1		not-accessible	Entry containing information about the connection with a BGP peer.
IP bgpPeerIdentifier	1.3.6.1.4.1.40310.4.3.1.1.1	IpAddress	read-only	The BGP Identifier of this entry's BGP peer.
INT bgpPeerState	1.3.6.1.4.1.40310.4.3.1.1.2	INTEGER	read-only	The BGP peer connection state.
INT bgpPeerAdminStatus	1.3.6.1.4.1.40310.4.3.1.1.3	INTEGER	read-write	The desired state of the BGP connection. A transition from 'stop' to 'start' will cause the BGP Start Event to be generated. A transition from 'start' to 'stop' will cause the BGP Stop Event to be generated. This parameter can be used to restart BGP peer connections. Care should be used in providing write access to this object without adequate authentication.
I32 bgpPeerNegotiatedVersion	1.3.6.1.4.1.40310.4.3.1.1.4	Integer32	read-only	The negotiated version of BGP running between the two peers.
IP bgpPeerLocalAddr	1.3.6.1.4.1.40310.4.3.1.1.5	InetAddress	read-only	The local IP address of this entry's BGP connection.
INT bgpPeerLocalPort	1.3.6.1.4.1.40310.4.3.1.1.6	INTEGER	read-only	The local port for the TCP connection between the BGP peers.
IP bgpPeerRemoteAddr	1.3.6.1.4.1.40310.4.3.1.1.7	IpAddress	read-only	The remote IP address of this entry's BGP peer.
INT bgpPeerRemotePort	1.3.6.1.4.1.40310.4.3.1.1.8	INTEGER	read-only	The remote port for the TCP connection between the BGP peers. Note that the objects bgpPeerLocalAddr, bgpPeerLocalPort, bgpPeerRemoteAddr and bgpPeerRemotePort provide the appropriate reference to the standard MIB TCP connection table.
INT bgpPeerRemoteAs	1.3.6.1.4.1.40310.4.3.1.1.9	INTEGER	read-only	The remote autonomous system number.
C32 bgpPeerInUpdatesEx	1.3.6.1.4.1.40310.4.3.1.1.10	Counter32	read-only	The number of BGP UPDATE messages received on this connection. This object should be initialized to zero (0) when the connection is established.
C32 bgpPeerOutUpdates	1.3.6.1.4.1.40310.4.3.1.1.11	Counter32	read-only	The number of BGP UPDATE messages transmitted on this connection. This object should be initialized to zero (0) when the connection is established.
C32 bgpPeerInTotalMessages	1.3.6.1.4.1.40310.4.3.1.1.12	Counter32	read-only	The total number of messages received from the remote peer on this connection. This object should be initialized to zero when the connection is established.
C32 bgpPeerOutTotalMessages	1.3.6.1.4.1.40310.4.3.1.1.13	Counter32	read-only	The total number of messages transmitted to the remote peer on this connection. This object should be initialized to zero when the connection is established.
OCT bgpPeerLastError	1.3.6.1.4.1.40310.4.3.1.1.14	OCTET STRING	read-only	The last error code and subcode seen by this peer on this connection. If no error has occurred, this field is zero. Otherwise, the first byte of this two byte OCTET STRING contains the error code, and the second byte contains the subcode.
C32 bgpPeerFsmEstablishedTransitions	1.3.6.1.4.1.40310.4.3.1.1.15	Counter32	read-only	The total number of times the BGP FSM transitioned into the established state.
G32 bgpPeerFsmEstablishedTime	1.3.6.1.4.1.40310.4.3.1.1.16	Gauge32	read-only	This timer indicates how long (in seconds) this peer has been in the Established state or how long since this peer was last in the Established state. It is set to zero when a new peer is configured or the router is booted.
INT bgpPeerConnectRetryInterval	1.3.6.1.4.1.40310.4.3.1.1.17	INTEGER	read-write	Time interval in seconds for the ConnectRetry timer. The suggested value for this timer is 120 seconds.
INT bgpPeerHoldTime	1.3.6.1.4.1.40310.4.3.1.1.18	INTEGER	read-only	Time interval in seconds for the Hold Timer established with the peer. The value of this object is calculated by this BGP speaker by using the smaller of the value in bgpPeerHoldTimeConfigured and the Hold Time received in the OPEN message. This value must be at lease three seconds if it is not zero (0) in which case the Hold Timer has not been established with the peer, or, the value of bgpPeerHoldTimeConfigured is zero (0).
INT bgpPeerKeepAlive	1.3.6.1.4.1.40310.4.3.1.1.19	INTEGER	read-only	Time interval in seconds for the KeepAlive timer established with the peer. The value of this object is calculated by this BGP speaker such that, when compared with bgpPeerHoldTime, it has the same proportion as what bgpPeerKeepAliveConfigured has when compared with bgpPeerHoldTimeConfigured. If the value of this object is zero (0), it indicates that the KeepAlive timer has not been established with the peer, or, the value of bgpPeerKeepAliveConfigured is zero (0).
INT bgpPeerHoldTimeConfigured	1.3.6.1.4.1.40310.4.3.1.1.20	INTEGER	read-write	Time interval in seconds for the Hold Time configured for this BGP speaker with this peer. This value is placed in an OPEN message sent to this peer by this BGP speaker, and is compared with the Hold Time field in an OPEN message received from the peer when determining the Hold Time (bgpPeerHoldTime) with the peer. This value must not be less than three seconds if it is not zero (0) in which case the Hold Time is NOT to be established with the peer. The suggested value for this timer is 90 seconds.
INT bgpPeerKeepAliveConfigured	1.3.6.1.4.1.40310.4.3.1.1.21	INTEGER	read-write	Time interval in seconds for the KeepAlive timer configured for this BGP speaker with this peer. The value of this object will only determine the KEEPALIVE messages' frequency relative to the value specified in bgpPeerHoldTimeConfigured; the actual time interval for the KEEPALIVE messages is indicated by bgpPeerKeepAlive. A reasonable maximum value for this timer would be configured to be one third of that of bgpPeerHoldTimeConfigured. If the value of this object is zero (0), no periodical KEEPALIVE messages are sent to the peer after the BGP connection has been established. The suggested value for this timer is 30 seconds.
INT bgpPeerMinASOriginationInterval	1.3.6.1.4.1.40310.4.3.1.1.22	INTEGER	read-write	Time interval in seconds for the MinASOriginationInterval timer. The suggested value for this timer is 15 seconds.
INT bgpPeerMinRouteAdvertisementInterval	1.3.6.1.4.1.40310.4.3.1.1.23	INTEGER	read-write	Time interval in seconds for the MinRouteAdvertisementInterval timer. The suggested value for this timer is 30 seconds.
G32 bgpPeerInUpdateElapsedTime	1.3.6.1.4.1.40310.4.3.1.1.24	Gauge32	read-only	Elapsed time in seconds since the last BGP UPDATE message was received from the peer. Each time bgpPeerInUpdates is incremented, the value of this object is set to zero (0).
OCT bgpPeerIface	1.3.6.1.4.1.40310.4.3.1.1.25	OCTET STRING	read-only	For BGP unnumbered neighbors routes are using interfaces as nexthop interfaces. This is the inteface from which nexthop route
OCT bgpPeerDesc	1.3.6.1.4.1.40310.4.3.1.1.26	OCTET STRING	read-only	This is neighbour or peer description field. It provides human readable info about neighbour or peer
IP bgpIdentifier	1.3.6.1.4.1.40310.4.4	IpAddress	read-only	The BGP Identifier of local system.
bgp4PathAttrTable	1.3.6.1.4.1.40310.4.5		not-accessible	The BGP-4 Received Path Attribute Table contains information about paths to destination networks received from all BGP4 peers.
bgp4PathAttrEntry	1.3.6.1.4.1.40310.4.5.1		not-accessible	Information about a path to a network.
IP bgp4PathAttrPeer	1.3.6.1.4.1.40310.4.5.1.1	InetAddress	read-only	The IP address of the peer where the path information was learned.
INT bgp4PathAttrIpAddrPrefixLen	1.3.6.1.4.1.40310.4.5.1.2	INTEGER	read-only	Length in bits of the IP address prefix in the Network Layer Reachability Information field.
IP bgp4PathAttrIpAddrPrefix	1.3.6.1.4.1.40310.4.5.1.3	IpAddress	read-only	An IP address prefix in the Network Layer Reachability Information field. This object is an IP address containing the prefix with length specified by bgp4PathAttrIpAddrPrefixLen. Any bits beyond the length specified by bgp4PathAttrIpAddrPrefixLen are zeroed.
INT bgp4PathAttrOrigin	1.3.6.1.4.1.40310.4.5.1.4	INTEGER	read-only	The ultimate origin of the path information.
OCT bgp4PathAttrASPathSegment	1.3.6.1.4.1.40310.4.5.1.5	OCTET STRING	read-only	The sequence of AS path segments. Each AS path segment is represented by a triple . The type is a 1-octet field which has two possible values: 1 AS_SET: unordered set of ASs a route in the UPDATE message has traversed 2 AS_SEQUENCE: ordered set of ASs a route in the UPDATE message has traversed. The length is a 1-octet field containing the number of ASs in the value field. The value field contains one or more AS numbers, each AS is represented in the octet string as a pair of octets according to the following algorithm: first-byte-of-pair = ASNumber / 256; second-byte-of-pair = ASNumber & 255;
IP bgp4PathAttrNextHop	1.3.6.1.4.1.40310.4.5.1.6	InetAddress	read-only	The address of the border router that should be used for the destination network.
INT bgp4PathAttrMultiExitDisc	1.3.6.1.4.1.40310.4.5.1.7	INTEGER	read-only	This metric is used to discriminate between multiple exit points to an adjacent autonomous system. A value of -1 indicates the absence of this attribute.
INT bgp4PathAttrLocalPref	1.3.6.1.4.1.40310.4.5.1.8	INTEGER	read-only	The originating BGP4 speaker's degree of preference for an advertised route. A value of -1 indicates the absence of this attribute.
INT bgp4PathAttrAtomicAggregate	1.3.6.1.4.1.40310.4.5.1.9	INTEGER	read-only	Whether or not the local system has selected a less specific route without selecting a more specific route.
INT bgp4PathAttrAggregatorAS	1.3.6.1.4.1.40310.4.5.1.10	INTEGER	read-only	The AS number of the last BGP4 speaker that performed route aggregation. A value of zero (0) indicates the absence of this attribute.
IP bgp4PathAttrAggregatorAddr	1.3.6.1.4.1.40310.4.5.1.11	IpAddress	read-only	The IP address of the last BGP4 speaker that performed route aggregation. A value of 0.0.0.0 indicates the absence of this attribute.
INT bgp4PathAttrCalcLocalPref	1.3.6.1.4.1.40310.4.5.1.12	INTEGER	read-only	The degree of preference calculated by the receiving BGP4 speaker for an advertised route. A value of -1 indicates the absence of this attribute.
INT bgp4PathAttrBest	1.3.6.1.4.1.40310.4.5.1.13	INTEGER	read-only	An indication of whether or not this route was chosen as the best BGP4 route.
OCT bgp4PathAttrUnknown	1.3.6.1.4.1.40310.4.5.1.14	OCTET STRING	read-only	One or more path attributes not understood by this BGP4 speaker. Size zero (0) indicates the absence of such attribute(s). Octets beyond the maximum size, if any, are not recorded by this object.
bgpTraps	1.3.6.1.4.1.40310.4.7
NTF bgpEstablished	1.3.6.1.4.1.40310.4.7.1			The BGP Established event is generated when the BGP FSM enters the ESTABLISHED state.
NTF bgpBackwardTransition	1.3.6.1.4.1.40310.4.7.2			The BGPBackwardTransition Event is generated when the BGP FSM moves from a higher numbered state to a lower numbered state.

RFC description

Cumulus BGP unnumbered peer and neighbor information for routing protocol management.

Start monitoring Cumulus Networks/Nvidia switch (Cumulus Linux, BGP Unnumbered) 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-BGPUN-MIB