CISCO-IETF-BFD-MIB

All MIBs › CISCO-IETF-BFD-MIB

Organization: IETF

Last Updated: 2011-04-16

Category: Cisco Devices, Routing Protocols

Description: Provides Cisco-specific extensions to the IETF BFD MIB for configuring and monitoring Bidirectional Forwarding Detection sessions.

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 CISCO-IETF-BFD-MIB?

CISCO-IETF-BFD-MIB is a Cisco-specific implementation of the IETF Bidirectional Forwarding Detection (BFD) protocol MIB, used across Cisco routers and switches to manage fast failure-detection sessions between forwarding engines. It exposes data on BFD session state, discriminators, timers, and diagnostic codes for each monitored path between neighboring devices. The MIB is central to monitoring hardware/software fault status in real time, since a BFD session going down (session state transitioning from Up to Down, with a diagnostic code populated) signals a link, interface, or peer-forwarding-engine failure well before routing protocol timers would detect it. It is closely tied to the IETF BFD base draft standard and is typically paired with routing protocol MIBs (OSPF, BGP, EIGRP) that use BFD for rapid convergence. Deployment is common in service provider and enterprise core/edge routers where sub-second failure detection is required for high-availability links, and network engineers often load the CISCO-IETF-BFD-MIB MIB Browser definitions to inspect these session objects during troubleshooting.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-IETF-BFD-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

Cisco routers
Cisco switches
Cisco service provider edge/core equipment

Monitoring Examples

An administrator polls ciscoBfdSessTable (via ciscoBfdSessEntry rows indexed by ciscoBfdSessIndex) to check ciscoBfdSessState and ciscoBfdSessDiag for each session; a session stuck in a non-Up state combined with ciscoBfdSessRemoteHeardFlag set to false indicates the remote peer has stopped responding. Comparing ciscoBfdSessDiscriminator and ciscoBfdSessRemoteDiscr confirms both ends have correctly negotiated the session, while ciscoBfdSessUdpPort and ciscoBfdAdminStatus help verify configuration consistency. Rising ciscoBfdNotifications trap counts alongside session state flaps point to an unstable physical link or intermittent forwarding-plane fault.

What Can Be Monitored

BFD session state
session diagnostic code
local/remote discriminators
remote peer responsiveness
session admin status
BFD protocol version

Imported Objects

From CISCO-SMI

ciscoExperiment

OBJECT-IDENTITY

From IF-MIB

InterfaceIndex

From INET-ADDRESS-MIB

InetAddress
InetAddressType
InetPortNumber

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Counter64
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

RowStatus
StorageType
TEXTUAL-CONVENTION
TimeStamp
TruthValue

How to Use in IPNetwork Monitor

Example using ciscoBfdSessPerfPktIn OID:

Select a Cisco router or switch (BFD fast failure detection) 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 ciscoBfdSessPerfPktIn 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 total number of BFD messages received for this BFD session. 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
ciscoIetfBfdMIB	1.3.6.1.4.1.9.10.137			This document contains the Management information base for Bidirectional Forwarding Detection(BFD) Protocol as defined in draft-ietf-bfd-base-06.txt. BFD is a protocol intended to detect faults in the bidirectional path between two forwarding engines, including interfaces, data link(s), and to the extent possible the forwarding engines themselves, with potentially very low latency. It operates independently of media, data protocols, and routing protocols. This MIB module is based on the Internet Draft draft-ietf-bfd-mib-03.txt and draft-ietf-bfd-mib-04.txt
ciscoBfdNotifications	1.3.6.1.4.1.9.10.137.0
NTF ciscoBfdSessUp	1.3.6.1.4.1.9.10.137.0.1			This notification is generated when the ciscoBfdSessState object for one or more contiguous entries in ciscoBfdSessTable are about to enter the up(4) state from some other state. The included values of ciscoBfdSessDiag MUST both be set equal to this new state (i.e: up(4)). The two instances of ciscoBfdSessDiag in this notification indicate the range of indexes that are affected. Note that all the indexes of the two ends of the range can be derived from the instance identifiers of these two objects. For the cases where a contiguous range of sessions have transitioned into the up(4) state at roughly the same time, the device SHOULD issue a single notification for each range of contiguous indexes in an effort to minimize the emission of a large number of notifications. If a notification has to be issued for just a single ciscoBfdSessEntry, then the instance identifier (and values) of the two ciscoBfdSessDiag objects MUST be the identical.
NTF ciscoBfdSessDown	1.3.6.1.4.1.9.10.137.0.2			This notification is generated when the ciscoBfdSessState object for one or more contiguous entries in ciscoBfdSessTable are about to enter the down(2) or adminDown(1) states from some other state. The included values of ciscoBfdSessDiag MUST both be set equal to this new state (i.e: down(2) or adminDown(1)). The two instances of ciscoBfdSessDiag in this notification indicate the range of indexes that are affected. Note that all the indexes of the two ends of the range can be derived from the instance identifiers of these two objects. For cases where a contiguous range of sessions have transitioned into the down(2) or adminDown(1) states at roughly the same time, the device SHOULD issue a single notification for each range of contiguous indexes in an effort to minimize the emission of a large number of notifications. If a notification has to be issued for just a single ciscoBfdSessEntry, then the instance identifier (and values) of the two ciscoBfdSessDiag objects MUST be the identical.
ciscoBfdObjects	1.3.6.1.4.1.9.10.137.1
ciscoBfdScalarObjects	1.3.6.1.4.1.9.10.137.1.1
INT ciscoBfdAdminStatus	1.3.6.1.4.1.9.10.137.1.1.1	INTEGER	read-write	The global administrative status of BFD in this router. The value 'enabled' denotes that the BFD Process is active on at least one interface; 'disabled' disables it on all interfaces.
U32 ciscoBfdVersionNumber	1.3.6.1.4.1.9.10.137.1.1.3	Unsigned32	read-only	The current version number of the BFD protocol.
T/F ciscoBfdSessNotificationsEnable	1.3.6.1.4.1.9.10.137.1.1.4	TruthValue	read-write	If this object is set to true(1), then it enables the emission of ciscoBfdSessUp and ciscoBfdSessDown notifications; otherwise these notifications are not emitted.
ciscoBfdSessTable	1.3.6.1.4.1.9.10.137.1.2		not-accessible	The BFD Session Table describes the BFD sessions.
ciscoBfdSessEntry	1.3.6.1.4.1.9.10.137.1.2.1		not-accessible	The BFD Session Entry describes BFD session.
CIS ciscoBfdSessIndex	1.3.6.1.4.1.9.10.137.1.2.1.1	CiscoBfdSessIndexTC	not-accessible	This object contains an index used to represent a unique BFD session on this device.
U32 ciscoBfdSessApplicationId	1.3.6.1.4.1.9.10.137.1.2.1.2	Unsigned32	read-only	This object contains an index used to indicate a local application which owns or maintains this BFD session. For instance, the MPLS VPN process may maintain a subset of the total number of BFD sessions. This application ID provides a convenient way to segregate sessions by the applications which maintain them.
U32 ciscoBfdSessDiscriminator	1.3.6.1.4.1.9.10.137.1.2.1.3	Unsigned32	read-only	This object specifies the local discriminator for this BFD session, used to uniquely identify it.
U32 ciscoBfdSessRemoteDiscr	1.3.6.1.4.1.9.10.137.1.2.1.4	Unsigned32	read-only	This object specifies the session discriminator chosen by the remote system for this BFD session.
INE ciscoBfdSessUdpPort	1.3.6.1.4.1.9.10.137.1.2.1.5	InetPortNumber	read-create	The destination UDP Port for BFD. The default value is the well-known value for this port. BFD State failing(5) is only applicable if this BFD session is running version 0
INT ciscoBfdSessState	1.3.6.1.4.1.9.10.137.1.2.1.6	INTEGER	read-only	The perceived state of the BFD session.
T/F ciscoBfdSessRemoteHeardFlag	1.3.6.1.4.1.9.10.137.1.2.1.7	TruthValue	read-only	This object specifies status of BFD packet reception from the remote system. Specifically, it is set to true(1) if the local system is actively receiving BFD packets from the remote system, and is set to false(0) if the local system has not received BFD packets recently (within the detection time) or if the local system is attempting to tear down the BFD session.
CIS ciscoBfdSessDiag	1.3.6.1.4.1.9.10.137.1.2.1.8	CiscoBfdDiag	read-only	A diagnostic code specifying the local system's reason for the last transition of the session from up(1) to some other state.
INT ciscoBfdSessOperMode	1.3.6.1.4.1.9.10.137.1.2.1.9	INTEGER	read-only	This object specifies current operating mode that BFD session is operating in.
T/F ciscoBfdSessDemandModeDesiredFlag	1.3.6.1.4.1.9.10.137.1.2.1.10	TruthValue	read-create	This object indicates that the local system's desire to use Demand mode. Specifically, it is set to true(1) if the local system wishes to use Demand mode or false(0) if not
T/F ciscoBfdSessEchoFuncModeDesiredFlag	1.3.6.1.4.1.9.10.137.1.2.1.11	TruthValue	read-create	This object indicates that the local system's desire to use Echo mode. Specifically, it is set to true(1) if the local system wishes to use Echo mode or false(0) if not
T/F ciscoBfdSessControlPlanIndepFlag	1.3.6.1.4.1.9.10.137.1.2.1.12	TruthValue	read-create	This object indicates that the local system's ability to continue to function through a disruption of the control plane. Specifically, it is set to true(1) if the local system BFD implementation is independent of the control plane. Otherwise, the value is set to false(0)
IPt ciscoBfdSessAddrType	1.3.6.1.4.1.9.10.137.1.2.1.13	InetAddressType	read-create	This object specifies IP address type of the neighboring IP address which is being monitored with this BFD session. Only values unknown(0), ipv4(1) or ipv6(2) have to be supported. A value of unknown(0) is allowed only when the outgoing interface is of type point-to-point, or when the BFD session is not associated with a specific interface. If any other unsupported values are attempted in a set operation, the agent MUST return an inconsistentValue error.
IP ciscoBfdSessAddr	1.3.6.1.4.1.9.10.137.1.2.1.14	InetAddress	read-create	This object specifies the neighboring IP address which is being monitored with this BFD session. It can also be used to enabled BFD on a specific interface. The value is set to zero when BFD session is not associated with a specific interface.
NUM ciscoBfdSessDesiredMinTxInterval	1.3.6.1.4.1.9.10.137.1.2.1.15	CiscoBfdInterval	read-create	This object specifies the minimum interval, in microseconds, that the local system would like to use when transmitting BFD Control packets.
NUM ciscoBfdSessReqMinRxInterval	1.3.6.1.4.1.9.10.137.1.2.1.16	CiscoBfdInterval	read-create	This object specifies the minimum interval, in microseconds, between received BFD Control packets the local system is capable of supporting.
NUM ciscoBfdSessReqMinEchoRxInterval	1.3.6.1.4.1.9.10.137.1.2.1.17	CiscoBfdInterval	read-create	This object specifies the minimum interval, in microseconds, between received BFD Echo packets that this system is capable of supporting.
U32 ciscoBfdSessDetectMult	1.3.6.1.4.1.9.10.137.1.2.1.18	Unsigned32	read-create	This object specifies the Detect time multiplier.
STO ciscoBfdSessStorType	1.3.6.1.4.1.9.10.137.1.2.1.19	StorageType	read-create	This variable indicates the storage type for this object. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row.
ROW ciscoBfdSessRowStatus	1.3.6.1.4.1.9.10.137.1.2.1.20	RowStatus	read-create	This variable is used to create, modify, and/or delete a row in this table. When a row in this table has a row in the active(1) state, no objects in this row can be modified except the ciscoBfdSessRowStatus and ciscoBfdSessStorageType.
T/F ciscoBfdSessAuthPresFlag	1.3.6.1.4.1.9.10.137.1.2.1.21	TruthValue	read-create	This object indicates that the local system's desire to use Authentication. Specifically, it is set to true(1) if the local system wishes the session to be authenticated or false(0) if not
INT ciscoBfdSessAuthenticationType	1.3.6.1.4.1.9.10.137.1.2.1.22	INTEGER	read-create	The Authentication Type used for this BFD session. This field is valid only when the Authentication Present bit is set
U32 ciscoBfdSessVersionNumber	1.3.6.1.4.1.9.10.137.1.2.1.23	Unsigned32	read-only	The version number of the BFD protocol that this session is running in.
INT ciscoBfdSessType	1.3.6.1.4.1.9.10.137.1.2.1.24	INTEGER	read-only	The type of this BFD session.
NUM ciscoBfdSessInterface	1.3.6.1.4.1.9.10.137.1.2.1.25	InterfaceIndex	read-only	This object contains an interface index used to indicate the interface which this BFD session is running on.
ciscoBfdSessPerfTable	1.3.6.1.4.1.9.10.137.1.3		not-accessible	This table specifies BFD Session performance counters.
ciscoBfdSessPerfEntry	1.3.6.1.4.1.9.10.137.1.3.1		not-accessible	An entry in this table is created by a BFD-enabled node for every BFD Session. ciscoBfdCounterDiscontinuityTime is used to indicate potential discontinuity for all counter objects in this table.
C32 ciscoBfdSessPerfPktInEx	1.3.6.1.4.1.9.10.137.1.3.1.1	Counter32	read-only	The total number of BFD messages received for this BFD session.
C32 ciscoBfdSessPerfPktOut	1.3.6.1.4.1.9.10.137.1.3.1.2	Counter32	read-only	The total number of BFD messages sent for this BFD session.
TIM ciscoBfdSessUpTime	1.3.6.1.4.1.9.10.137.1.3.1.3	TimeStamp	read-only	The value of sysUpTime on the most recent occasion at which the session came up. If no such up event exists this object contains a zero value.
TIM ciscoBfdSessPerfLastSessDownTime	1.3.6.1.4.1.9.10.137.1.3.1.4	TimeStamp	read-only	The value of sysUpTime on the most recent occasion at which the last time communication was lost with the neighbor. If no such down event exist this object contains a zero value.
CIS ciscoBfdSessPerfLastCommLostDiag	1.3.6.1.4.1.9.10.137.1.3.1.5	CiscoBfdDiag	read-only	The BFD diag code for the last time communication was lost with the neighbor. If no such down event exists this object contains a zero value.
C32 ciscoBfdSessPerfSessUpCount	1.3.6.1.4.1.9.10.137.1.3.1.6	Counter32	read-only	The number of times this session has gone into the Up state since the router last rebooted.
TIM ciscoBfdSessPerfDiscTime	1.3.6.1.4.1.9.10.137.1.3.1.7	TimeStamp	read-only	The value of sysUpTime on the most recent occasion at which any one or more of the session counters suffered a discontinuity. The relevant counters are the specific instances associated with this BFD session of any Counter32 object contained in the ciscoBfdSessPerfTable. If no such discontinuities have occurred since the last re-initialization of the local management subsystem, then this object contains a zero value.
C64 ciscoBfdSessPerfPktInHC	1.3.6.1.4.1.9.10.137.1.3.1.8	Counter64	read-only	This value represents the total number of BFD messages received for this BFD session. It MUST be equal to the least significant 32 bits of ciscoBfdSessPerfPktIn if ciscoBfdSessPerfPktInHC is supported according to the rules spelled out in RFC2863.
C64 ciscoBfdSessPerfPktOutHC	1.3.6.1.4.1.9.10.137.1.3.1.9	Counter64	read-only	This value represents the total number of total number of BFD messages transmitted for this BFD session. It MUST be equal to the least significant 32 bits of ciscoBfdSessPerfPktIn if ciscoBfdSessPerfPktOutHC is supported according to the rules spelled out in RFC2863.
ciscoBfdSessMapTable	1.3.6.1.4.1.9.10.137.1.4		not-accessible	The BFD Session Mapping Table maps the complex indexing of the BFD sessions to the flat CiscoBfdSessIndexTC used in the ciscoBfdSessTable.
ciscoBfdSessMapEntry	1.3.6.1.4.1.9.10.137.1.4.1		not-accessible	The BFD Session Entry describes BFD session that is mapped to this index.
CIS ciscoBfdSessMapBfdIndex	1.3.6.1.4.1.9.10.137.1.4.1.1	CiscoBfdSessIndexTC	read-only	This object indicates the CiscoBfdSessIndexTC referred to by the indices of this row. In essence, a mapping is provided between these indices and the ciscoBfdSessTable.
ciscoBfdSessDiscMapTable	1.3.6.1.4.1.9.10.137.1.5		not-accessible	The BFD Session Discriminator Mapping Table maps a local discriminator value to associated BFD sessions' CiscoBfdSessIndexTC used in the ciscoBfdSessTable.
ciscoBfdSessDiscMapEntry	1.3.6.1.4.1.9.10.137.1.5.1		not-accessible	Each row contains a mapping between a local discriminator value to an entry in ciscoBfdSessTable.
CIS ciscoBfdSessDiscMapIndex	1.3.6.1.4.1.9.10.137.1.5.1.1	CiscoBfdSessIndexTC	read-only	This object indicates the CiscoBfdSessIndexTC referred to by the index of this row. In essence, a mapping is provided between this index and the ciscoBfdSessTable.
ciscoBfdSessIpMapTable	1.3.6.1.4.1.9.10.137.1.6		not-accessible	The BFD Session IP Mapping Table maps given ciscoBfdSessInterface, ciscoBfdSessAddrType, and ciscoBbfdSessAddr to an associated BFD sessions' CiscoBfdSessIndexTC used in the ciscoBfdSessTable. This table SHOULD contains those BFD sessions are of IP type: singleHop(1) and multiHop(2).
ciscoBfdSessIpMapEntry	1.3.6.1.4.1.9.10.137.1.6.1		not-accessible	Each row contains a mapping between ciscoBfdSessInterface, ciscoBfdSessAddrType and ciscoBfdSessAddr values to an entry in ciscoBfdSessTable.
CIS ciscoBfdSessIpMapIndex	1.3.6.1.4.1.9.10.137.1.6.1.1	CiscoBfdSessIndexTC	read-only	This object indicates the CiscoBfdSessIndexTC referred to by the indices of this row. In essence, a mapping is provided between these indices and an entry in ciscoBfdSessTable.
ciscoBfdConformance	1.3.6.1.4.1.9.10.137.3
ciscoBfdGroups	1.3.6.1.4.1.9.10.137.3.1
ciscoBfdSessionGroup	1.3.6.1.4.1.9.10.137.3.1.1			Collection of objects needed for BFD sessions.
ciscoBfdSessionPerfGroup	1.3.6.1.4.1.9.10.137.3.1.2			Collection of objects needed to monitor the performance of BFD sessions.
ciscoBfdSessionPerfHCGroup	1.3.6.1.4.1.9.10.137.3.1.3			Collection of objects needed to monitor the performance of BFD sessions for which the values of ciscoBfdSessPerfPktIn, ciscoBfdSessPerfPktOut wrap around too quickly.
ciscoBfdNotificationGroup	1.3.6.1.4.1.9.10.137.3.1.4			Set of notifications implemented in this module.
ciscoBfdSession0304Group	1.3.6.1.4.1.9.10.137.3.1.5			Collection of objects needed for BFD sessions for both draft-ietf-bfd-mib-03.txt and draft-ietf-bfd-mib-04.txt.
ciscoBfdSession03Group	1.3.6.1.4.1.9.10.137.3.1.6			Collection of objects needed for BFD sessions to support draft-ietf-bfd-mib-03.txt.
ciscoBfdSession04Group	1.3.6.1.4.1.9.10.137.3.1.7			Collection of objects needed for BFD sessions to support draft-ietf-bfd-mib-04.txt.
ciscoBfdCompliances	1.3.6.1.4.1.9.10.137.3.2
ciscoBfdModuleFullCompliance	1.3.6.1.4.1.9.10.137.3.2.1			Compliance statement for agents that provide full support for CISCO-IETF-BFD-MIB of draft-ietf-bfd-mib-03.txt. Such devices can then be monitored and also be configured using this MIB module. This compliance statement is superceded by ciscoBfdModuleFullComplianceRev2.
ciscoBfdModuleFullComplianceRev2	1.3.6.1.4.1.9.10.137.3.2.2			Compliance statement for agents that provide full support for CISCO-IETF-BFD-MIB of draft-ietf-bfd-mib-04.txt. Such devices can then be monitored and also be configured using this MIB module.

RFC description

MIB for Bidirectional Forwarding Detection (BFD) protocol that detects faults in forwarding paths.

Start monitoring Cisco routers and switches (BFD fast failure detection) 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 CISCO-IETF-BFD-MIB