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.
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 symbolic | OID numeric | Type | Access | Description |
|---|---|---|---|---|
| msdpMIB | 1.3.6.1.3.92 | An experimental MIB module for MSDP Management. | ||
| msdpMIBobjects | 1.3.6.1.3.92.1 | |||
| msdp | 1.3.6.1.3.92.1.1 | |||
| 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. |
| 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. |
| 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 Caching is enabled, this table may be empty. | |
| 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. |
| 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. | |
| 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 RPF failures on SA messages received from this peer. |
| 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. |
| 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. |
| 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 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 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 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 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 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 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. |
| 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 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. |
| 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. |
| 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). |
| 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 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 msdpPeerConnectRetryInterval | 1.3.6.1.3.92.1.1.5.1.20 | INTEGER | read-create | Time interval in seconds for the ConnectRetry timer. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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 on this connection. 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. |
| 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. |
| 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 advert. | |
| 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 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. |
| 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 placed in the SA cache. |
| 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. |
| 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. |
| msdpTraps | 1.3.6.1.3.92.1.1.7 | |||
| 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. | ||
| 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. | ||
| 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 which implement the MSDP MIB. | ||
| 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. | ||
| msdpSACacheGroup | 1.3.6.1.3.92.1.1.8.2.3 | A collection of objects for managing MSDP SA cache entries. | ||
| 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 |
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.