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.
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 |
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.
What Can Be Monitored
- MSDP enabled/disabled state
- Source-Active cache entry count and lifetime
- MSDP peer session state
- SA-request policy configuration
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.
OIDs
| OID symbolic | OID numeric | Type | Access | Description |
|---|---|---|---|---|
| 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. | ||
| msdpMIBobjects | 1.3.6.1.3.92.1 | |||
| msdp | 1.3.6.1.3.92.1.1 | |||
| msdpTraps | 1.3.6.1.3.92.1.1.0 | |||
| 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. | ||
| 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. | ||
| 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. |
| 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. |
| G32 msdpNumSACacheEntries | 1.3.6.1.3.92.1.1.3 | Gauge32 | read-only | The total number of entries in the SA Cache 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 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. | |
| 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. |
| msdpPeerTable | 1.3.6.1.3.92.1.1.5 | not-accessible | The (conceptual) table listing the MSDP speaker's peers. | |
| 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). | |
| IP msdpPeerRemoteAddress | 1.3.6.1.3.92.1.1.5.1.1 | IpAddress | not-accessible | The address of the remote MSDP peer. |
| 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. |
| C32 msdpPeerRPFFailures | 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. |
| 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. |
| 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. |
| 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 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 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 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 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 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 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. |
| 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 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. |
| 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. |
| 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. |
| 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 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 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. |
| 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. |
| 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. |
| 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. |
| 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). |
| 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. |
| 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. |
| 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. |
| 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. |
| 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 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. |
| 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. |
| 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. |
| 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. | |
| 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. | |
| IP msdpSACacheGroupAddr | 1.3.6.1.3.92.1.1.6.1.1 | IpAddress | not-accessible | The group address of the SA Cache entry. |
| IP msdpSACacheSourceAddr | 1.3.6.1.3.92.1.1.6.1.2 | IpAddress | not-accessible | The source address of the SA 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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). |
| msdpMIBConformance | 1.3.6.1.3.92.1.1.8 | |||
| msdpMIBCompliances | 1.3.6.1.3.92.1.1.8.1 | |||
| 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. | ||
| msdpMIBFullCompliance | 1.3.6.1.3.92.1.1.8.1.2 | The compliance statement for entities that implement MSDP (RFC3618). | ||
| 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. | ||
| msdpMIBGroups | 1.3.6.1.3.92.1.1.8.2 | |||
| msdpMIBGlobalsGroup | 1.3.6.1.3.92.1.1.8.2.1 | A collection of objects providing information on global MSDP state. | ||
| 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. | ||
| 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. | ||
| msdpMIBSACacheGroup | 1.3.6.1.3.92.1.1.8.2.4 | A collection of objects for managing MSDP SA cache entries. | ||
| msdpMIBNotificationGroup | 1.3.6.1.3.92.1.1.8.2.5 | A collection of notifications for signaling changes in MSDP peer relationships. | ||
| 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. | ||
| 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. | ||
| msdpMIBPeerGroup2 | 1.3.6.1.3.92.1.1.8.2.9 | A collection of objects for managing MSDP peers. | ||
| 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. |
| msdpMeshGroupTable | 1.3.6.1.3.92.1.1.12 | not-accessible | The (conceptual) table listing MSDP Mesh Group configuration. | |
| 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. |
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.