DRAFT-MSDP-MIB

All MIBs › DRAFT-MSDP-MIB

Organization: IETF MSDP Working Group

Last Updated: 1999-12-16

Category: Standard: IETF, Technology: Multicast

Description: A draft-stage MIB covering management of MSDP (Multicast Source Discovery Protocol) peer sessions and source-active cache entries.

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 DRAFT-MSDP-MIB?

DRAFT-MSDP-MIB is an IETF experimental, vendor-neutral MIB for managing Multicast Source Discovery Protocol (MSDP), which lets multicast routers in different PIM domains share information about active multicast sources. It exposes protocol enable/disable configuration, source-active (SA) cache statistics, a peer table, and a source-active request table. From a monitoring standpoint it is primarily useful for software/protocol-state health: the number of SA cache entries and cache lifetime reveal whether the multicast source-discovery mechanism is functioning normally, and peer table entries show whether MSDP peering sessions are established, rather than exposing any hardware sensors. It is designed to work alongside PIM and IP multicast MIBs on the same router. It is typically deployed on ISP or enterprise core routers participating in interdomain IP multicast routing, per the DRAFT-MSDP-MIB RFC that defines its experimental object set.

IPNetwork Monitor allows you to monitor SNMP objects defined in DRAFT-MSDP-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

vendor-neutral, standards-based MIB, not tied to a specific manufacturer
multicast-enabled router (MSDP speaker)

Monitoring Examples

An administrator polling msdpPeerTable and msdpPeerEntry can determine whether a configured MSDP peer session is up, which is the primary indicator of MSDP health. Tracking msdpNumSACacheEntries over time reveals whether the router is learning the expected number of active multicast sources from its peers, with an unexpected drop to zero suggesting a peering failure. The msdpRequestsTable, keyed by group address and peer, shows outstanding SA requests, useful for diagnosing why a receiver isn't getting expected multicast source data.

What Can Be Monitored

MSDP peer session status
source-active (SA) cache entry count
SA cache lifetime and hold-down settings
SA request status per group
MSDP protocol enabled state

Imported Objects

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Gauge32
IpAddress
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
TimeTicks
experimental

From SNMPv2-TC

RowStatus
TruthValue

How to Use in IPNetwork Monitor

Example using msdpPeerRPFFailures OID:

Select a Multicast-enabled router, MSDP speaker (vendor-neutral IETF experimental standard) 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 msdpPeerRPFFailures 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 RPF failures on SA messages received from this peer. 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 between polls, since a rising count of errors, failures, or discards often points to a real underlying problem. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
msdp	1.3.6.1.3.92.1.1
NTF msdpBackwardTransition	1.3.6.1.3.92.1.1.7.2			The MSDPBackwardTransition Event is generated when the MSDP FSM moves from a higher numbered state to a lower numbered state.
TIK msdpCacheLifetime	1.3.6.1.3.92.1.1.2	TimeTicks	read-write	The lifetime given to SA cache entries when created or refreshed. A value of 0 means no SA caching is done by this MSDP speaker.
T/F msdpEnabled	1.3.6.1.3.92.1.1.1	TruthValue	read-write	The state of MSDP on this MSDP speaker - globally enabled or disabled.
NTF msdpEstablished	1.3.6.1.3.92.1.1.7.1			The MSDP Established event is generated when the MSDP FSM enters the ESTABLISHED state.
msdpMIB	1.3.6.1.3.92			An experimental MIB module for MSDP Management.
msdpMIBCompliance	1.3.6.1.3.92.1.1.8.1.1			The compliance statement for entities which implement the MSDP MIB.
msdpMIBCompliances	1.3.6.1.3.92.1.1.8.1
msdpMIBConformance	1.3.6.1.3.92.1.1.8
msdpMIBGlobalsGroup	1.3.6.1.3.92.1.1.8.2.1			A collection of objects providing information on global MSDP state.
msdpMIBGroups	1.3.6.1.3.92.1.1.8.2
msdpMIBobjects	1.3.6.1.3.92.1
msdpMIBPeerGroup	1.3.6.1.3.92.1.1.8.2.2			A collection of objects for managing MSDP peers.
G32 msdpNumSACacheEntries	1.3.6.1.3.92.1.1.3	Gauge32	read-only	The total number of entries in the SA Cache table.
C32 msdpPeerConnectionAttempts	1.3.6.1.3.92.1.1.5.1.30	Counter32	read-only	The number of times the state machine has transitioned from inactive to connecting.
INT msdpPeerConnectRetryInterval	1.3.6.1.3.92.1.1.5.1.20	INTEGER	read-create	Time interval in seconds for the ConnectRetry timer.
INT msdpPeerDataTtl	1.3.6.1.3.92.1.1.5.1.23	INTEGER	read-create	The minimum TTL a packet is required to have before it may be forwarded using SA encapsulation to this peer.
INT msdpPeerEncapsulationState	1.3.6.1.3.92.1.1.5.1.28	INTEGER	read-only	The status of the encapsulation negotiation state machine.
INT msdpPeerEncapsulationType	1.3.6.1.3.92.1.1.5.1.29	INTEGER	read-only	The encapsulation in use when encapsulating data in SA messages to this peer.
msdpPeerEntry	1.3.6.1.3.92.1.1.5.1		not-accessible	An entry (conceptual row) representing an MSDP peer.
G32 msdpPeerFsmEstablishedTime	1.3.6.1.3.92.1.1.5.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 MSDP speaker is booted.
C32 msdpPeerFsmEstablishedTransitions	1.3.6.1.3.92.1.1.5.1.15	Counter32	read-only	The total number of times the MSDP FSM transitioned into the established state.
INT msdpPeerHoldTimeConfigured	1.3.6.1.3.92.1.1.5.1.21	INTEGER	read-create	Time interval in seconds for the Hold Timer configured for this MSDP speaker with this peer.
C32 msdpPeerInControlMessages	1.3.6.1.3.92.1.1.5.1.11	Counter32	read-only	The total number of MSDP messages received on this TCP connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerInDataPackets	1.3.6.1.3.92.1.1.5.1.13	Counter32	read-only	The total number of encapsulated data packets received from this peer. This object should be initialized to zero when the connection is established.
G32 msdpPeerInMessageElapsedTime	1.3.6.1.3.92.1.1.5.1.17	Gauge32	read-only	Elapsed time in seconds since the last MSDP message was received from the peer. Each time msdpPeerInControlMessages is incremented, the value of this object is set to zero (0).
C32 msdpPeerInNotifications	1.3.6.1.3.92.1.1.5.1.31	Counter32	read-only	The number of MSDP Notification messages received on this connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerInSARequests	1.3.6.1.3.92.1.1.5.1.7	Counter32	read-only	The number of MSDP SA-Request messages received on this connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerInSAResponses	1.3.6.1.3.92.1.1.5.1.9	Counter32	read-only	The number of MSDP SA-Response messages received on this connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerInSAs	1.3.6.1.3.92.1.1.5.1.5	Counter32	read-only	The number of MSDP SA messages received on this connection. This object should be initialized to zero when the connection is established.
INT msdpPeerKeepAliveConfigured	1.3.6.1.3.92.1.1.5.1.22	INTEGER	read-create	Time interval in seconds for the KeepAlive timer configured for this MSDP speaker with this peer. A reasonable maximum value for this timer would be configured to be one third of that of msdpPeerHoldTimeConfigured. If the value of this object is zero (0), no periodic KEEPALIVE messages are sent to the peer after the MSDP connection has been established.
OCT msdpPeerLastError	1.3.6.1.3.92.1.1.5.1.33	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.
IP msdpPeerLocalAddress	1.3.6.1.3.92.1.1.5.1.18	IpAddress	read-create	The local IP address of this entry's MSDP connection.
INT msdpPeerLocalPort	1.3.6.1.3.92.1.1.5.1.27	INTEGER	read-only	The local port for the TCP connection between the MSDP peers.
C32 msdpPeerOutControlMessages	1.3.6.1.3.92.1.1.5.1.12	Counter32	read-only	The total number of MSDP messages transmitted on this TCP connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerOutDataPackets	1.3.6.1.3.92.1.1.5.1.14	Counter32	read-only	The total number of encapsulated data packets sent to this peer. This object should be initialized to zero when the connection is established.
C32 msdpPeerOutNotifications	1.3.6.1.3.92.1.1.5.1.32	Counter32	read-only	The number of MSDP Notification messages transmitted on this connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerOutSARequests	1.3.6.1.3.92.1.1.5.1.8	Counter32	read-only	The number of MSDP SA-Request messages transmitted on this connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerOutSAResponses	1.3.6.1.3.92.1.1.5.1.10	Counter32	read-only	The number of MSDP SA Response messages transmitted on this TCP connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerOutSAs	1.3.6.1.3.92.1.1.5.1.6	Counter32	read-only	The number of MSDP SA messages transmitted on this connection. This object should be initialized to zero when the connection is established.
T/F msdpPeerProcessRequestsFrom	1.3.6.1.3.92.1.1.5.1.24	TruthValue	read-create	This object indicates whether or not to process MSDP SA Request messages from this peer. If True(1), MSDP SA Request messages from this peer are processed and replied to (if appropriate) with SA Response messages. If False(2), MSDP SA Request messages from this peer are silently ignored. It defaults to False when msdpCacheLifetime is 0 and True when msdpCacheLifetime is non-0.
IP msdpPeerRemoteAddress	1.3.6.1.3.92.1.1.5.1.1	IpAddress	not-accessible	The address of the remote MSDP peer.
INT msdpPeerRemotePort	1.3.6.1.3.92.1.1.5.1.26	INTEGER	read-only	The remote port for the TCP connection between the MSDP peers.
C32 msdpPeerRPFFailuresEx	1.3.6.1.3.92.1.1.5.1.4	Counter32	read-only	The number of RPF failures on SA messages received from this peer.
INT msdpPeerSAAdvPeriod	1.3.6.1.3.92.1.1.5.1.19	INTEGER	read-create	Time interval in seconds for the MinSAAdvertisementInterval MSDP timer.
INT msdpPeerState	1.3.6.1.3.92.1.1.5.1.3	INTEGER	read-only	The state of the MSDP TCP connection with this peer.
ROW msdpPeerStatus	1.3.6.1.3.92.1.1.5.1.25	RowStatus	read-create	The RowStatus object by which peers can be added and deleted. A transition to 'active' will cause the MSDP Start Event to be generated. A transition out of the 'active' state will cause the MSDP Stop Event to be generated. Care should be used in providing write access to this object without adequate authentication.
msdpPeerTable	1.3.6.1.3.92.1.1.5		not-accessible	The (conceptual) table listing the MSDP speaker's peers.
msdpRequestsEntry	1.3.6.1.3.92.1.1.4.1		not-accessible	An entry (conceptual row) representing a group range used when deciding where to send an SA Request message.
IP msdpRequestsGroupAddress	1.3.6.1.3.92.1.1.4.1.1	IpAddress	not-accessible	The group address that, when combined with the mask in this entry, represents the group range for which this peer will service MSDP SA Requests.
IP msdpRequestsGroupMask	1.3.6.1.3.92.1.1.4.1.2	IpAddress	not-accessible	The mask that, when combined with the group address in this entry, represents the group range for which this peer will service MSDP SA Requests.
IP msdpRequestsPeer	1.3.6.1.3.92.1.1.4.1.3	IpAddress	read-create	The peer to which MSDP SA Requests for groups matching this entry's group range will be sent. Must match the INDEX of a row in the msdpPeerTable.
ROW msdpRequestsStatus	1.3.6.1.3.92.1.1.4.1.4	RowStatus	read-create	The status of this row, by which new rows may be added to the table.
msdpRequestsTable	1.3.6.1.3.92.1.1.4		not-accessible	The (conceptual) table listing group ranges and MSDP peers used when deciding where to send an SA Request message when required. If SA Caching is enabled, this table may be empty.
msdpSACacheEntry	1.3.6.1.3.92.1.1.6.1		not-accessible	An entry (conceptual row) representing an MSDP SA advert.
TIK msdpSACacheExpiryTime	1.3.6.1.3.92.1.1.6.1.9	TimeTicks	read-only	The time remaining before this entry will expire from the SA cache.
msdpSACacheGroup	1.3.6.1.3.92.1.1.8.2.3			A collection of objects for managing MSDP SA cache entries.
IP msdpSACacheGroupAddr	1.3.6.1.3.92.1.1.6.1.1	IpAddress	not-accessible	The group address of the SA Cache entry.
C32 msdpSACacheInDataPackets	1.3.6.1.3.92.1.1.6.1.7	Counter32	read-only	The number of MSDP encapsulated data packets received relevant to this cache entry. This object must be initialized to zero when creating a cache entry.
C32 msdpSACacheInSAs	1.3.6.1.3.92.1.1.6.1.6	Counter32	read-only	The number of MSDP SA messages received relevant to this cache entry. This object must be initialized to zero when creating a cache entry.
IP msdpSACacheOriginRP	1.3.6.1.3.92.1.1.6.1.3	IpAddress	not-accessible	The address of the RP which originated the last SA message accepted for this entry.
IP msdpSACachePeerLearnedFrom	1.3.6.1.3.92.1.1.6.1.4	IpAddress	read-only	The peer from which this SA Cache entry was last accepted. This address must correspond to the msdpPeerRemoteAddress value for a row in the MSDP Peer Table.
IP msdpSACacheRPFPeer	1.3.6.1.3.92.1.1.6.1.5	IpAddress	read-only	The peer from which an SA message corresponding to this cache entry would be accepted (i.e. the RPF peer for msdpSACacheOriginRP). This may be different than msdpSACachePeerLearnedFrom if this entry was created by an MSDP SA-Response. This address must correspond to the msdpPeerRemoteAddress value for a row in the MSDP Peer Table.
IP msdpSACacheSourceAddr	1.3.6.1.3.92.1.1.6.1.2	IpAddress	not-accessible	The source address of the SA Cache entry.
ROW msdpSACacheStatus	1.3.6.1.3.92.1.1.6.1.10	RowStatus	read-write	The status of this row in the table. The only allowable actions are to retreive the status, which will be `active', or to set the status to `destroy' in order to remove this entry from the cache.
msdpSACacheTable	1.3.6.1.3.92.1.1.6		not-accessible	The (conceptual) table listing the MSDP SA advertisements currently in the MSDP speaker's cache.
TIK msdpSACacheUpTime	1.3.6.1.3.92.1.1.6.1.8	TimeTicks	read-only	The time since this entry was placed in the SA cache.
INT msdpSAHoldDownPeriod	1.3.6.1.3.92.1.1.9	INTEGER	read-only	The number of seconds in the MSDP SA Hold-down period
msdpTraps	1.3.6.1.3.92.1.1.7

RFC description

Draft MIB for managing Multicast Source Discovery Protocol (MSDP) peers and source-active cache entries.

Start monitoring Multicast-enabled router, MSDP speaker (vendor-neutral IETF experimental standard) 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 DRAFT-MSDP-MIB