MSDP-MIB

All MIBs › MSDP-MIB

Organization: IETF MBONED Working Group

Last Updated: 2006-08-01

Category: Routing Protocols

Description: Defines managed objects for managing Multicast Source Discovery Protocol (MSDP) speakers, including peer connections, Source-Active cache entries, and mesh group membership.

IPNetwork Monitor uses several OIDs from this MIB in network discovery and polling the applicable devices. Start monitoring MSDP-MIB with a free 30-day trial of IPNetwork Monitor.

What Is MSDP-MIB?

MSDP-MIB is an IETF experimental-track MIB defined by RFC 4624 for Multicast Source Discovery Protocol (MSDP) speakers, which are routers that exchange information about active multicast sources across PIM domains. It exposes configuration data (enabling MSDP, cache lifetime, RP address), operational counters (number of Source-Active cache entries), and tables for configured SA-request policies and MSDP peer connections. Its monitoring value is centered on protocol/software status for multicast routing -- tracking whether MSDP is enabled, how many Source-Active entries are cached, and the state of MSDP peer sessions, which reveals whether inter-domain multicast source discovery is functioning or whether a peer session has gone down. It is explicitly dependent on and complementary to PIM/multicast routing MIBs since MSDP operates alongside PIM Sparse Mode for inter-domain multicast. It would be deployed on multicast-capable routers acting as MSDP speakers/RPs at the boundary between PIM domains in service-provider or enterprise multicast networks, as formally specified by the MSDP-MIB RFC.

IPNetwork Monitor allows you to monitor SNMP objects defined in 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-capable routers (MSDP speakers/RPs)

Monitoring Examples

An administrator would poll msdpNumSACacheEntries and msdpCacheLifetime to gauge how many active multicast sources are currently cached and for how long, and would check the msdpPeerTable/msdpPeerEntry to confirm each configured MSDP peer session is in an established state. A peer entry unexpectedly dropping out of an established state, combined with a falling msdpNumSACacheEntries count, would indicate a loss of inter-domain multicast source visibility, and msdpTraps notifications would alert on such peer state changes.

What Can Be Monitored

MSDP enabled/disabled state
Source-Active cache entry count and lifetime
MSDP peer session state
SA-request policy configuration

Imported Objects

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

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

From SNMPv2-TC

DisplayString
RowStatus
TimeStamp
TruthValue

How to Use in IPNetwork Monitor

Example using msdpPeerRPFFailures OID:

Select a device implementing MSDP-MIB 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 SA messages received from this peer that failed the Peer-RPF check. 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.0.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. This is the [SG-State-Period] in the MSDP spec. A value of 0 means no SA caching is done by this MSDP speaker. Changes to this object should be stored to non-volatile memory. This object does not measure time per se; instead, it is the delta from the time at which an SA message is received at which it should be expired if not refreshed. (i.e., it is the value of msdpSACacheExpiryTime immediately after receiving an SA message applying to that row.) As such, TimeInterval would be a more appropriate SYNTAX; it remains TimeTicks for backwards compatibility.
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. Changes to this object should be stored to non-volatile memory.
NTF msdpEstablished	1.3.6.1.3.92.1.1.0.1			The MSDP Established event is generated when the MSDP FSM enters the ESTABLISHED state.
msdpMeshGroupEntry	1.3.6.1.3.92.1.1.12.1		not-accessible	An entry (conceptual row) representing a peer in an MSDP Mesh Group. If row creation is supported, dynamically added rows are added to the system's stable configuration (corresponding to a StorageType value of nonVolatile).
STR msdpMeshGroupName	1.3.6.1.3.92.1.1.12.1.1	DisplayString	not-accessible	The name of the mesh group.
IP msdpMeshGroupPeerAddress	1.3.6.1.3.92.1.1.12.1.2	IpAddress	not-accessible	A peer address that is a member of the mesh group with name msdpMeshGroupName. The msdpMeshGroupPeerAddress must match a row in the msdpPeerTable.
ROW msdpMeshGroupStatus	1.3.6.1.3.92.1.1.12.1.3	RowStatus	read-create	This entry's status, by which new entries may be added to the table and old entries deleted. msdpMeshGroupName and msdpMeshGroupPeerAddress must be set to valid values before the row can be activated. Since these are the table's INDEX, a row can be activated by simply setting the msdpMeshGroupStatus variable. It is not possible to modify other columns in the same conceptual row when the status value is active(1), because the only other objects in the row are part of the INDEX. Changing one of these changes the row, so an old row must be deleted and a new one created.
msdpMeshGroupTable	1.3.6.1.3.92.1.1.12		not-accessible	The (conceptual) table listing MSDP Mesh Group configuration.
msdpMIB	1.3.6.1.3.92			An experimental MIB module for MSDP Management and Monitoring. Copyright (C) The Internet Society 2006. This version of this MIB module is part of RFC 4624; see the RFC itself for full legal notices.
msdpMIBCompliance	1.3.6.1.3.92.1.1.8.1.1			The compliance statement for entities that implement a pre- RFC version of MSDP. This statement is deprecated because it includes objects used for managing/monitoring aspects of MSDP that were removed before it was published as an RFC.
msdpMIBCompliances	1.3.6.1.3.92.1.1.8.1
msdpMIBConformance	1.3.6.1.3.92.1.1.8
msdpMIBEncapsulationGroup	1.3.6.1.3.92.1.1.8.2.3			A collection of objects for managing encapsulations if the MSDP encapsulation interfaces are not given interface indices.
msdpMIBFullCompliance	1.3.6.1.3.92.1.1.8.1.2			The compliance statement for entities that implement MSDP (RFC3618).
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
msdpMIBMeshGroupGroup	1.3.6.1.3.92.1.1.8.2.8			A collection of objects for MSDP speakers that can participate in MSDP mesh groups.
msdpMIBNotificationGroup	1.3.6.1.3.92.1.1.8.2.5			A collection of notifications for signaling changes in MSDP peer relationships.
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. This group is deprecated in favor of msdpMIBPeerGroup2 because it contains objects for managing aspects of MSDP that were removed before it was published as an RFC.
msdpMIBPeerGroup2	1.3.6.1.3.92.1.1.8.2.9			A collection of objects for managing MSDP peers.
msdpMIBReadOnlyCompliance	1.3.6.1.3.92.1.1.8.1.3			The compliance statement for entities that implement MSDP (RFC3618), but do not permit configuration (or only permit partial configuration) via SNMP.
msdpMIBRequestsGroup	1.3.6.1.3.92.1.1.8.2.6			A collection of objects for managing MSDP Request transmission. This group is deprecated because Requests were removed from MSDP before its publication as an RFC.
msdpMIBRPGroup	1.3.6.1.3.92.1.1.8.2.7			A collection of objects for MSDP speakers that source MSDP messages.
msdpMIBSACacheGroup	1.3.6.1.3.92.1.1.8.2.4			A collection of objects for managing MSDP SA cache entries.
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.
I32 msdpPeerConnectRetryInterval	1.3.6.1.3.92.1.1.5.1.20	Integer32	read-create	Time interval, in seconds, for the [ConnectRetry-period] for this peer.
I32 msdpPeerDataTtl	1.3.6.1.3.92.1.1.5.1.23	Integer32	read-create	The minimum TTL a packet is required to have before it may be forwarded using SA encapsulation to this peer.
TIM msdpPeerDiscontinuityTime	1.3.6.1.3.92.1.1.5.1.34	TimeStamp	read-only	The value of sysUpTime on the most recent occasion at which one or more of this entry's counters suffered a discontinuity. See the DESCRIPTION of each object to see if it is expected to have discontinuities. These discontinuities may occur at peer connection establishment. If no such discontinuities have occurred since the last reinitialization of the local management subsystem, then this object contains a zero value.
INT msdpPeerEncapsulationType	1.3.6.1.3.92.1.1.5.1.29	INTEGER	read-create	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. If row creation is supported, dynamically added rows are added to the system's stable configuration (corresponding to a StorageType value of nonVolatile).
TIM msdpPeerFsmEstablishedTime	1.3.6.1.3.92.1.1.5.1.16	TimeStamp	read-only	This timestamp is set to the value of sysUpTime when a peer transitions into or out of the ESTABLISHED state. It is set to zero when 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.
I32 msdpPeerHoldTimeConfigured	1.3.6.1.3.92.1.1.5.1.21	Integer32	read-create	Time interval, in seconds, for the [HoldTime-Period] configured for this MSDP speaker with this peer. If the value of this object is zero (0), the MSDP connection is never torn down due to the absence of messages from the peer.
C32 msdpPeerInControlMessages	1.3.6.1.3.92.1.1.5.1.11	Counter32	read-only	The total number of MSDP messages, excluding encapsulated data packets, received on this TCP connection. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of msdpPeerDiscontinuityTime.
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. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of msdpPeerDiscontinuityTime.
TIM msdpPeerInMessageTime	1.3.6.1.3.92.1.1.5.1.17	TimeStamp	read-only	The sysUpTime value when the last MSDP message was received from the peer. It is set to zero when the MSDP speaker is booted.
C32 msdpPeerInNotifications	1.3.6.1.3.92.1.1.5.1.31	Counter32	read-only	The number of MSDP Notification messages received from this peer. This object is deprecated because MSDP Notifications have been removed from the spec.
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. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of msdpPeerDiscontinuityTime.
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. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of msdpPeerDiscontinuityTime.
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. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of msdpPeerDiscontinuityTime.
I32 msdpPeerKeepAliveConfigured	1.3.6.1.3.92.1.1.5.1.22	Integer32	read-create	Time interval, in seconds, for the [KeepAlive-Period] configured for this MSDP speaker with this peer. 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 received via Notification from this peer. If no error has occurred, this field is zero. Otherwise, the first byte of this two-byte OCTET STRING contains the O-bit and error code, and the second byte contains the subcode. This object is deprecated because MSDP Notifications have been removed from the spec.
IP msdpPeerLocalAddress	1.3.6.1.3.92.1.1.5.1.18	IpAddress	read-create	The local IP address used for this entry's MSDP TCP connection.
I32 msdpPeerLocalPort	1.3.6.1.3.92.1.1.5.1.27	Integer32	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, excluding encapsulated data packets, transmitted on this TCP connection. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of msdpPeerDiscontinuityTime.
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. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of msdpPeerDiscontinuityTime.
C32 msdpPeerOutNotifications	1.3.6.1.3.92.1.1.5.1.32	Counter32	read-only	The number of MSDP Notification messages transmitted to this peer. This object is deprecated because MSDP Notifications have been removed from the spec.
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. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of msdpPeerDiscontinuityTime.
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. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of msdpPeerDiscontinuityTime.
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. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of msdpPeerDiscontinuityTime.
T/F msdpPeerProcessRequestsFrom	1.3.6.1.3.92.1.1.5.1.24	TruthValue	read-create	This object indicates whether 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 to True when msdpCacheLifetime is non-0. This object is deprecated because MSDP SA Requests were removed from the MSDP specification.
IP msdpPeerRemoteAddress	1.3.6.1.3.92.1.1.5.1.1	IpAddress	not-accessible	The address of the remote MSDP peer.
I32 msdpPeerRemotePort	1.3.6.1.3.92.1.1.5.1.26	Integer32	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 SA messages received from this peer that failed the Peer-RPF check. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of msdpPeerDiscontinuityTime.
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 'Enable MSDP peering with P' Event to be generated. A transition out of the 'active' state will cause the MSDP 'Disable MSDP peering with P' Event to be generated. Care should be used in providing write access to this object without adequate authentication. msdpPeerRemoteAddress is the only variable that must be set to a valid value before the row can be activated. Since this is the table's INDEX, a row can be activated by simply setting the msdpPeerStatus variable. It is possible to modify other columns in the same conceptual row when the status value is active(1).
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 to which this row applies.
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 to which this row applies.
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. This object, combined with msdpRequestsPeerType, must match the INDEX of a row in the msdpPeerTable, and to be considered, this peer's msdpPeerState must be established.
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 or old rows may be deleted.
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 Requests are not enabled, this table may be empty. In order to choose a peer to whom to send an SA Request for a given group, G, the subset of entries in this table whose (msdpRequestsPeerType, msdpRequestsPeer) tuple represents a peer whose msdpPeerState is established are examined. The set is further reduced by examining only those entries for which msdpPeerRequestsGroupAddressType equals the address type of G. The entries with the highest value of msdpRequestsGroupPrefix are considered, where the group G falls within the range described by the combination of msdpRequestsGroup and msdpRequestsGroupPrefix. (This sequence is commonly known as a 'longest-match' lookup.) Finally, if multiple entries remain, the entry with the lowest value of msdpRequestsPriority is chosen. The SA Request message is sent to the peer described by this row.
IP msdpRPAddress	1.3.6.1.3.92.1.1.11	IpAddress	read-write	The Rendezvous Point (RP) address used when sourcing MSDP SA messages. May be 0.0.0.0 on non-RPs. Changes to this object should be stored to non-volatile memory.
msdpSACacheEntry	1.3.6.1.3.92.1.1.6.1		not-accessible	An entry (conceptual row) representing an MSDP SA advertisement. The INDEX to this table includes msdpSACacheOriginRP for diagnosing incorrect MSDP advertisements; normally, a Group and Source pair would be unique. Row creation is not permitted; msdpSACacheStatus may only be used to delete rows from this table.
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. The first epoch is now, and the second epoch is the time that the entry will expire.
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 RP of the SA Cache entry. This field is in the INDEX in order to catch multiple RP's advertising the same source and group.
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. This should be 0.0.0.0 on the router that originated the entry.
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, or it may be 0.0.0.0 if no RPF peer exists.
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 retrieve the status, which will be 'active', or to set the status to 'destroy' in order to remove this entry from the cache. Row creation is not permitted. No columnar objects are writable, so there are none that may be changed while the status value is active(1).
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 first placed in the SA cache. The first epoch is the time that the entry was first placed in the SA cache, and the second epoch is the current time.
msdpTraps	1.3.6.1.3.92.1.1.0

RFC description

Manages Multicast Source Discovery Protocol (MSDP) peering and multicast distribution tree information.

Start monitoring Vendor-neutral IETF standard (multicast-capable router, MSDP speaker/RP) 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 MSDP-MIB