DRAFT-MSDP-MIB

MIB Reference — IPNetwork Monitor

All MIBsDRAFT-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.

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

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.

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

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.

OIDs
OID symbolicOID numericTypeAccessDescription
msdpMIB1.3.6.1.3.92An experimental MIB module for MSDP Management.
msdpMIBobjects1.3.6.1.3.92.1
msdp1.3.6.1.3.92.1.1
T/F msdpEnabled1.3.6.1.3.92.1.1.1TruthValueread-writeThe state of MSDP on this MSDP speaker - globally enabled or disabled.
TIK msdpCacheLifetime1.3.6.1.3.92.1.1.2TimeTicksread-writeThe lifetime given to SA cache entries when created or refreshed. A value of 0 means no SA caching is done by this MSDP speaker.
G32 msdpNumSACacheEntries1.3.6.1.3.92.1.1.3Gauge32read-onlyThe total number of entries in the SA Cache table.
msdpRequestsTable1.3.6.1.3.92.1.1.4not-accessibleThe (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.
msdpRequestsEntry1.3.6.1.3.92.1.1.4.1not-accessibleAn entry (conceptual row) representing a group range used when deciding where to send an SA Request message.
IP msdpRequestsGroupAddress1.3.6.1.3.92.1.1.4.1.1IpAddressnot-accessibleThe 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 msdpRequestsGroupMask1.3.6.1.3.92.1.1.4.1.2IpAddressnot-accessibleThe 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 msdpRequestsPeer1.3.6.1.3.92.1.1.4.1.3IpAddressread-createThe 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 msdpRequestsStatus1.3.6.1.3.92.1.1.4.1.4RowStatusread-createThe status of this row, by which new rows may be added to the table.
msdpPeerTable1.3.6.1.3.92.1.1.5not-accessibleThe (conceptual) table listing the MSDP speaker's peers.
msdpPeerEntry1.3.6.1.3.92.1.1.5.1not-accessibleAn entry (conceptual row) representing an MSDP peer.
IP msdpPeerRemoteAddress1.3.6.1.3.92.1.1.5.1.1IpAddressnot-accessibleThe address of the remote MSDP peer.
INT msdpPeerState1.3.6.1.3.92.1.1.5.1.3INTEGERread-onlyThe state of the MSDP TCP connection with this peer.
C32 msdpPeerRPFFailures1.3.6.1.3.92.1.1.5.1.4Counter32read-onlyThe number of RPF failures on SA messages received from this peer.
C32 msdpPeerInSAs1.3.6.1.3.92.1.1.5.1.5Counter32read-onlyThe number of MSDP SA messages received on this connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerOutSAs1.3.6.1.3.92.1.1.5.1.6Counter32read-onlyThe number of MSDP SA messages transmitted on this connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerInSARequests1.3.6.1.3.92.1.1.5.1.7Counter32read-onlyThe number of MSDP SA-Request messages received on this connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerOutSARequests1.3.6.1.3.92.1.1.5.1.8Counter32read-onlyThe number of MSDP SA-Request messages transmitted on this connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerInSAResponses1.3.6.1.3.92.1.1.5.1.9Counter32read-onlyThe number of MSDP SA-Response messages received on this connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerOutSAResponses1.3.6.1.3.92.1.1.5.1.10Counter32read-onlyThe number of MSDP SA Response messages transmitted on this TCP connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerInControlMessages1.3.6.1.3.92.1.1.5.1.11Counter32read-onlyThe total number of MSDP messages received on this TCP connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerOutControlMessages1.3.6.1.3.92.1.1.5.1.12Counter32read-onlyThe total number of MSDP messages transmitted on this TCP connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerInDataPackets1.3.6.1.3.92.1.1.5.1.13Counter32read-onlyThe total number of encapsulated data packets received from this peer. This object should be initialized to zero when the connection is established.
C32 msdpPeerOutDataPackets1.3.6.1.3.92.1.1.5.1.14Counter32read-onlyThe total number of encapsulated data packets sent to this peer. This object should be initialized to zero when the connection is established.
C32 msdpPeerFsmEstablishedTransitions1.3.6.1.3.92.1.1.5.1.15Counter32read-onlyThe total number of times the MSDP FSM transitioned into the established state.
G32 msdpPeerFsmEstablishedTime1.3.6.1.3.92.1.1.5.1.16Gauge32read-onlyThis 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.
G32 msdpPeerInMessageElapsedTime1.3.6.1.3.92.1.1.5.1.17Gauge32read-onlyElapsed 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).
IP msdpPeerLocalAddress1.3.6.1.3.92.1.1.5.1.18IpAddressread-createThe local IP address of this entry's MSDP connection.
INT msdpPeerSAAdvPeriod1.3.6.1.3.92.1.1.5.1.19INTEGERread-createTime interval in seconds for the MinSAAdvertisementInterval MSDP timer.
INT msdpPeerConnectRetryInterval1.3.6.1.3.92.1.1.5.1.20INTEGERread-createTime interval in seconds for the ConnectRetry timer.
INT msdpPeerHoldTimeConfigured1.3.6.1.3.92.1.1.5.1.21INTEGERread-createTime interval in seconds for the Hold Timer configured for this MSDP speaker with this peer.
INT msdpPeerKeepAliveConfigured1.3.6.1.3.92.1.1.5.1.22INTEGERread-createTime 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.
INT msdpPeerDataTtl1.3.6.1.3.92.1.1.5.1.23INTEGERread-createThe minimum TTL a packet is required to have before it may be forwarded using SA encapsulation to this peer.
T/F msdpPeerProcessRequestsFrom1.3.6.1.3.92.1.1.5.1.24TruthValueread-createThis 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.
ROW msdpPeerStatus1.3.6.1.3.92.1.1.5.1.25RowStatusread-createThe 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.
INT msdpPeerRemotePort1.3.6.1.3.92.1.1.5.1.26INTEGERread-onlyThe remote port for the TCP connection between the MSDP peers.
INT msdpPeerLocalPort1.3.6.1.3.92.1.1.5.1.27INTEGERread-onlyThe local port for the TCP connection between the MSDP peers.
INT msdpPeerEncapsulationState1.3.6.1.3.92.1.1.5.1.28INTEGERread-onlyThe status of the encapsulation negotiation state machine.
INT msdpPeerEncapsulationType1.3.6.1.3.92.1.1.5.1.29INTEGERread-onlyThe encapsulation in use when encapsulating data in SA messages to this peer.
C32 msdpPeerConnectionAttempts1.3.6.1.3.92.1.1.5.1.30Counter32read-onlyThe number of times the state machine has transitioned from inactive to connecting.
C32 msdpPeerInNotifications1.3.6.1.3.92.1.1.5.1.31Counter32read-onlyThe number of MSDP Notification messages received on this connection. This object should be initialized to zero when the connection is established.
C32 msdpPeerOutNotifications1.3.6.1.3.92.1.1.5.1.32Counter32read-onlyThe number of MSDP Notification messages transmitted on this connection. This object should be initialized to zero when the connection is established.
OCT msdpPeerLastError1.3.6.1.3.92.1.1.5.1.33OCTET STRINGread-onlyThe 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.
msdpSACacheTable1.3.6.1.3.92.1.1.6not-accessibleThe (conceptual) table listing the MSDP SA advertisements currently in the MSDP speaker's cache.
msdpSACacheEntry1.3.6.1.3.92.1.1.6.1not-accessibleAn entry (conceptual row) representing an MSDP SA advert.
IP msdpSACacheGroupAddr1.3.6.1.3.92.1.1.6.1.1IpAddressnot-accessibleThe group address of the SA Cache entry.
IP msdpSACacheSourceAddr1.3.6.1.3.92.1.1.6.1.2IpAddressnot-accessibleThe source address of the SA Cache entry.
IP msdpSACacheOriginRP1.3.6.1.3.92.1.1.6.1.3IpAddressnot-accessibleThe address of the RP which originated the last SA message accepted for this entry.
IP msdpSACachePeerLearnedFrom1.3.6.1.3.92.1.1.6.1.4IpAddressread-onlyThe 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 msdpSACacheRPFPeer1.3.6.1.3.92.1.1.6.1.5IpAddressread-onlyThe 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.
C32 msdpSACacheInSAs1.3.6.1.3.92.1.1.6.1.6Counter32read-onlyThe number of MSDP SA messages received relevant to this cache entry. This object must be initialized to zero when creating a cache entry.
C32 msdpSACacheInDataPackets1.3.6.1.3.92.1.1.6.1.7Counter32read-onlyThe number of MSDP encapsulated data packets received relevant to this cache entry. This object must be initialized to zero when creating a cache entry.
TIK msdpSACacheUpTime1.3.6.1.3.92.1.1.6.1.8TimeTicksread-onlyThe time since this entry was placed in the SA cache.
TIK msdpSACacheExpiryTime1.3.6.1.3.92.1.1.6.1.9TimeTicksread-onlyThe time remaining before this entry will expire from the SA cache.
ROW msdpSACacheStatus1.3.6.1.3.92.1.1.6.1.10RowStatusread-writeThe 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.
msdpTraps1.3.6.1.3.92.1.1.7
NTF msdpEstablished1.3.6.1.3.92.1.1.7.1The MSDP Established event is generated when the MSDP FSM enters the ESTABLISHED state.
NTF msdpBackwardTransition1.3.6.1.3.92.1.1.7.2The MSDPBackwardTransition Event is generated when the MSDP FSM moves from a higher numbered state to a lower numbered state.
msdpMIBConformance1.3.6.1.3.92.1.1.8
msdpMIBCompliances1.3.6.1.3.92.1.1.8.1
msdpMIBCompliance1.3.6.1.3.92.1.1.8.1.1The compliance statement for entities which implement the MSDP MIB.
msdpMIBGroups1.3.6.1.3.92.1.1.8.2
msdpMIBGlobalsGroup1.3.6.1.3.92.1.1.8.2.1A collection of objects providing information on global MSDP state.
msdpMIBPeerGroup1.3.6.1.3.92.1.1.8.2.2A collection of objects for managing MSDP peers.
msdpSACacheGroup1.3.6.1.3.92.1.1.8.2.3A collection of objects for managing MSDP SA cache entries.
INT msdpSAHoldDownPeriod1.3.6.1.3.92.1.1.9INTEGERread-onlyThe number of seconds in the MSDP SA Hold-down period

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