IPMROUTE-MIB

All MIBs › IPMROUTE-MIB

Organization: IETF IDMR Working Group

Last Updated: 1999-07-22

Category: IP and Core Protocols, Routing Protocols, Standard: IETF, Technology: Multicast

Description: IETF IP Multicast Routing MIB (RFC 2932) providing objects for managing and monitoring multicast routing table entries and protocols.

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 IPMROUTE-MIB?

IPMROUTE-MIB is an IETF standards-track module (RFC 2932) that models IP multicast routing state independently of the specific multicast routing protocol (PIM, DVMRP, etc.) running on the device. It exposes multicast forwarding table entries, including group and source addresses, upstream neighbor and incoming interface, packet counts, and entry age/expiry timers. Because multicast routes are dynamic, this MIB is primarily used to monitor software-level routing state rather than hardware health: whether expected multicast groups have active forwarding entries, how long routes have been up, and whether packet counters are incrementing as expected. It commonly depends on and complements protocol-specific multicast MIBs (e.g. PIM-MIB, DVMRP-MIB) and the IP-MIB for interface indices. It is typically deployed on routers and Layer 3 switches that participate in multicast distribution trees for applications like IPTV or financial market data feeds. Engineers searching for ip mroute reference this IETF MIB to monitor protocol-independent IP multicast routing-table state via SNMP.

IPNetwork Monitor allows you to monitor SNMP objects defined in IPMROUTE-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
IP multicast-capable routers and Layer 3 switches

Monitoring Examples

An administrator polls ipMRoute1Table (ipMRoute1Entry) keyed by ipMRoute1Group and ipMRoute1Source to confirm a multicast stream is being forwarded, checking ipMRoute1UpstreamNeighbor and ipMRoute1InIfIndex to verify the RPF interface is correct. A sudden reset of ipMRoute1UpTime or a stalled ipMRoute1Pkts counter would indicate the multicast route flapped or traffic stopped flowing. ipMRoute1ExpiryTime nearing zero without renewal signals the entry is about to age out, useful for catching silent multicast tree failures before subscribers notice.

What Can Be Monitored

multicast route entry count
group and source addresses
upstream neighbor and incoming interface
route uptime and expiry time
forwarded packet counts

Imported Objects

From IF-MIB

InterfaceIndex
InterfaceIndexOrZero

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

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

From SNMPv2-TC

DisplayString
RowStatus
TEXTUAL-CONVENTION
TruthValue

How to Use in IPNetwork Monitor

Example using ipMRoute1Pkts OID:

Select an IP multicast-capable router or switch 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 ipMRoute1Pkts 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 packets which this router has received from these sources and addressed to this multicast group address. 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 sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ipMRoute1MIB	1.3.6.1.3.60			The MIB module for management of IP Multicast routing, but independent of the specific multicast routing protocol in use.
ipMRoute1MIBObjects	1.3.6.1.3.60.1
ipMRoute1	1.3.6.1.3.60.1.1
INT ipMRoute1Enable	1.3.6.1.3.60.1.1.1	INTEGER	read-only	The enabled status of IP Multicast routing on this router.
ipMRoute1Table	1.3.6.1.3.60.1.1.2		not-accessible	The (conceptual) table containing multicast routing information for IP datagrams sent by particular sources to the IP multicast groups known to this router.
ipMRoute1Entry	1.3.6.1.3.60.1.1.2.1		not-accessible	An entry (conceptual row) containing the multicast routing information for IP datagrams from a particular source and addressed to a particular IP multicast group address. Discontinuities in counters in this entry can be detected by observing the value of ipMRoute1UpTime.
IP ipMRoute1Group	1.3.6.1.3.60.1.1.2.1.1	IpAddress	not-accessible	The IP multicast group address for which this entry contains multicast routing information.
IP ipMRoute1Source	1.3.6.1.3.60.1.1.2.1.2	IpAddress	not-accessible	The network address which when combined with the corresponding value of ipMRoute1SourceMask identifies the sources for which this entry contains multicast routing information.
IP ipMRoute1SourceMask	1.3.6.1.3.60.1.1.2.1.3	IpAddress	not-accessible	The network mask which when combined with the corresponding value of ipMRoute1Source identifies the sources for which this entry contains multicast routing information.
IP ipMRoute1UpstreamNeighbor	1.3.6.1.3.60.1.1.2.1.4	IpAddress	read-only	The address of the upstream neighbor (e.g., RPF neighbor) from which IP datagrams from these sources to this multicast address are received, or 0.0.0.0 if the upstream neighbor is unknown (e.g., in CBT).
NUM ipMRoute1InIfIndex	1.3.6.1.3.60.1.1.2.1.5	InterfaceIndexOrZero	read-only	The value of ifIndex for the interface on which IP datagrams sent by these sources to this multicast address are received. A value of 0 indicates that datagrams are not subject to an incoming interface check, but may be accepted on multiple interfaces (e.g., in CBT).
TIK ipMRoute1UpTime	1.3.6.1.3.60.1.1.2.1.6	TimeTicks	read-only	The time since the multicast routing information represented by this entry was learned by the router.
TIK ipMRoute1ExpiryTime	1.3.6.1.3.60.1.1.2.1.7	TimeTicks	read-only	The minimum amount of time remaining before this entry will be aged out. The value 0 indicates that the entry is not subject to aging.
C32 ipMRoute1PktsEx	1.3.6.1.3.60.1.1.2.1.8	Counter32	read-only	The number of packets which this router has received from these sources and addressed to this multicast group address.
C32 ipMRoute1DifferentInIfPackets	1.3.6.1.3.60.1.1.2.1.9	Counter32	read-only	The number of packets which this router has received from these sources and addressed to this multicast group address, which were dropped because they were not received on the interface indicated by ipMRoute1InIfIndex. Packets which are not subject to an incoming interface check (e.g., using CBT) are not counted.
C32 ipMRoute1Octets	1.3.6.1.3.60.1.1.2.1.10	Counter32	read-only	The number of octets contained in IP datagrams which were received from these sources and addressed to this multicast group address, and which were forwarded by this router.
IPM ipMRoute1Protocol	1.3.6.1.3.60.1.1.2.1.11	IpMRoute1Protocol	read-only	The multicast routing protocol via which this multicast forwarding entry was learned.
INT ipMRoute1RtProto	1.3.6.1.3.60.1.1.2.1.12	INTEGER	read-only	The routing mechanism via which the route used to find the upstream or parent interface for this multicast forwarding entry was learned. Inclusion of values for routing protocols is not intended to imply that those protocols need be supported.
IP ipMRoute1RtAddress	1.3.6.1.3.60.1.1.2.1.13	IpAddress	read-only	The address portion of the route used to find the upstream or parent interface for this multicast forwarding entry.
IP ipMRoute1RtMask	1.3.6.1.3.60.1.1.2.1.14	IpAddress	read-only	The mask associated with the route used to find the upstream or parent interface for this multicast forwarding entry.
INT ipMRoute1RtType	1.3.6.1.3.60.1.1.2.1.15	INTEGER	read-only	The reason the given route was placed in the (logical) multicast Routing Information Base (RIB). A value of unicast means that the route would normally be placed only in the unicast RIB, but was placed in the multicast RIB (instead or in addition) due to local configuration, such as when running PIM over RIP. A value of multicast means that the route was explicitly added to the multicast RIB by the routing protocol, such as DVMRP or Multiprotocol BGP.
C64 ipMRoute1HCOctets	1.3.6.1.3.60.1.1.2.1.16	Counter64	read-only	The number of octets contained in IP datagrams which were received from these sources and addressed to this multicast group address, and which were forwarded by this router. This object is a 64-bit version of ipMRoute1Octets.
ipMRoute1NextHopTable	1.3.6.1.3.60.1.1.3		not-accessible	The (conceptual) table containing information on the next- hops on outgoing interfaces for routing IP multicast datagrams. Each entry is one of a list of next-hops on outgoing interfaces for particular sources sending to a particular multicast group address.
ipMRoute1NextHopEntry	1.3.6.1.3.60.1.1.3.1		not-accessible	An entry (conceptual row) in the list of next-hops on outgoing interfaces to which IP multicast datagrams from particular sources to a IP multicast group address are routed. Discontinuities in counters in this entry can be detected by observing the value of ipMRoute1UpTime.
IP ipMRoute1NextHopGroup	1.3.6.1.3.60.1.1.3.1.1	IpAddress	not-accessible	The IP multicast group for which this entry specifies a next-hop on an outgoing interface.
IP ipMRoute1NextHopSource	1.3.6.1.3.60.1.1.3.1.2	IpAddress	not-accessible	The network address which when combined with the corresponding value of ipMRoute1NextHopSourceMask identifies the sources for which this entry specifies a next-hop on an outgoing interface.
IP ipMRoute1NextHopSourceMask	1.3.6.1.3.60.1.1.3.1.3	IpAddress	not-accessible	The network mask which when combined with the corresponding value of ipMRoute1NextHopSource identifies the sources for which this entry specifies a next-hop on an outgoing interface.
NUM ipMRoute1NextHopIfIndex	1.3.6.1.3.60.1.1.3.1.4	InterfaceIndex	not-accessible	The ifIndex value of the interface for the outgoing interface for this next-hop.
IP ipMRoute1NextHopAddress	1.3.6.1.3.60.1.1.3.1.5	IpAddress	not-accessible	The address of the next-hop specific to this entry. For most interfaces, this is identical to ipMRoute1NextHopGroup. NBMA interfaces, however, may have multiple next-hop addresses out a single outgoing interface.
INT ipMRoute1NextHopState	1.3.6.1.3.60.1.1.3.1.6	INTEGER	read-only	An indication of whether the outgoing interface and next- hop represented by this entry is currently being used to forward IP datagrams. The value 'forwarding' indicates it is currently being used; the value 'pruned' indicates it is not.
TIK ipMRoute1NextHopUpTime	1.3.6.1.3.60.1.1.3.1.7	TimeTicks	read-only	The time since the multicast routing information represented by this entry was learned by the router.
TIK ipMRoute1NextHopExpiryTime	1.3.6.1.3.60.1.1.3.1.8	TimeTicks	read-only	The minimum amount of time remaining before this entry will be aged out. If ipMRoute1NextHopState is pruned(1), the remaining time until the prune expires and the state reverts to forwarding(2). Otherwise, the remaining time until this entry is removed from the table. The time remaining may be copied from ipMRoute1ExpiryTime if the protocol in use for this entry dos not specify next-hop timers. The value 0 indicates that the entry is not subject to aging.
I32 ipMRoute1NextHopClosestMemberHops	1.3.6.1.3.60.1.1.3.1.9	Integer32	read-only	The minimum number of hops between this router and any member of this IP multicast group reached via this next-hop on this outgoing interface. Any IP multicast datagrams for the group which have a TTL less than this number of hops will not be forwarded to this next-hop.
IPM ipMRoute1NextHopProtocol	1.3.6.1.3.60.1.1.3.1.10	IpMRoute1Protocol	read-only	The routing mechanism via which this next-hop was learned.
C32 ipMRoute1NextHopPkts	1.3.6.1.3.60.1.1.3.1.11	Counter32	read-only	The number of packets which have been forwarded using this route.
ipMRoute1InterfaceTable	1.3.6.1.3.60.1.1.4		not-accessible	The (conceptual) table containg multicast routing information specific to interfaces.
ipMRoute1InterfaceEntry	1.3.6.1.3.60.1.1.4.1		not-accessible	An entry (conceptual row) containing the multicast routing information for a particular interface.
NUM ipMRoute1InterfaceIfIndex	1.3.6.1.3.60.1.1.4.1.1	InterfaceIndex	not-accessible	The ifIndex value of the interface for which this entry contains information.
I32 ipMRoute1InterfaceTtl	1.3.6.1.3.60.1.1.4.1.2	Integer32	read-only	The datagram TTL threshold for the interface. Any IP multicast datagrams with a TTL less than this threshold will not be forwarded out the interface. The default value of 0 means all multicast packets are forwarded out the interface.
IPM ipMRoute1InterfaceProtocol	1.3.6.1.3.60.1.1.4.1.3	IpMRoute1Protocol	read-only	The routing protocol running on this interface.
I32 ipMRoute1InterfaceRateLimit	1.3.6.1.3.60.1.1.4.1.4	Integer32	read-only	The rate-limit, in kilobits per second, of forwarded multicast traffic on the interface. A rate-limit of 0 indicates that no rate limiting is done.
C32 ipMRoute1InterfaceInMcastOctets	1.3.6.1.3.60.1.1.4.1.5	Counter32	read-only	The number of octets of multicast packets that have arrived on the interface, including framing characters. This object is similar to ifInOctets in the Interfaces MIB, except that only multicast packets are counted.
C32 ipMRoute1InterfaceOutMcastOctets	1.3.6.1.3.60.1.1.4.1.6	Counter32	read-only	The number of octets of multicast packets that have been sent on the interface.
C64 ipMRoute1InterfaceHCInMcastOctets	1.3.6.1.3.60.1.1.4.1.7	Counter64	read-only	The number of octets of multicast packets that have arrived on the interface, including framing characters. This object is a 64-bit version of ipMRoute1InterfaceInMcastOctets. It is similar to ifHCInOctets in the Interfaces MIB, except that only multicast packets are counted.
C64 ipMRoute1InterfaceHCOutMcastOctets	1.3.6.1.3.60.1.1.4.1.8	Counter64	read-only	The number of octets of multicast packets that have been sent on the interface. This object is a 64-bit version of ipMRoute1InterfaceOutMcastOctets.
ipMRoute1BoundaryTable	1.3.6.1.3.60.1.1.5		not-accessible	The (conceptual) table listing the router's scoped multicast address boundaries.
ipMRoute1BoundaryEntry	1.3.6.1.3.60.1.1.5.1		not-accessible	An entry (conceptual row) in the ipMRoute1BoundaryTable representing a scoped boundary.
NUM ipMRoute1BoundaryIfIndex	1.3.6.1.3.60.1.1.5.1.1	InterfaceIndex	not-accessible	The IfIndex value for the interface to which this boundary applies. Packets with a destination address in the associated address/mask range will not be forwarded out this interface.
IP ipMRoute1BoundaryAddress	1.3.6.1.3.60.1.1.5.1.2	IpAddress	not-accessible	The group address which when combined with the corresponding value of ipMRoute1BoundaryAddressMask identifies the group range for which the scoped boundary exists. Scoped addresses must come from the range 239.x.x.x as specified in RFC 2365.
IP ipMRoute1BoundaryAddressMask	1.3.6.1.3.60.1.1.5.1.3	IpAddress	not-accessible	The group address mask which when combined with the corresponding value of ipMRoute1BoundaryAddress identifies the group range for which the scoped boundary exists.
ROW ipMRoute1BoundaryStatus	1.3.6.1.3.60.1.1.5.1.4	RowStatus	read-only	The status of this row, by which new entries may be created, or old entries deleted from this table.
ipMRoute1ScopeNameTable	1.3.6.1.3.60.1.1.6		not-accessible	The (conceptual) table listing the multicast scope names.
ipMRoute1ScopeNameEntry	1.3.6.1.3.60.1.1.6.1		not-accessible	An entry (conceptual row) in the ipMRoute1ScopeNameTable representing a multicast scope name.
IP ipMRoute1ScopeNameAddress	1.3.6.1.3.60.1.1.6.1.1	IpAddress	not-accessible	The group address which when combined with the corresponding value of ipMRoute1ScopeNameAddressMask identifies the group range associated with the multicast scope. Scoped addresses must come from the range 239.x.x.x.
IP ipMRoute1ScopeNameAddressMask	1.3.6.1.3.60.1.1.6.1.2	IpAddress	not-accessible	The group address mask which when combined with the corresponding value of ipMRoute1ScopeNameAddress identifies the group range associated with the multicast scope.
STR ipMRoute1ScopeNameLanguage	1.3.6.1.3.60.1.1.6.1.3	DisplayString	not-accessible	An RFC 1766-style language tag, with all alphabetic characters converted to lowercase. This restriction is intended to make the lexical ordering imposed by SNMP useful when applied to language tags. Note that it is theoretically possible for a valid language tag to exceed the allowed length of this object, and thus be impossible to represent in this table. Sampling of language tags in current use on the Internet suggests that this limit does not pose a serious problem in practice.
STR ipMRoute1ScopeNameString	1.3.6.1.3.60.1.1.6.1.4	SnmpAdminString	read-only	The textual name associated with the multicast scope. The value of this object should be suitable for displaying to end-users, such as when allocating a multicast address in this scope. When no name is specified, the default value of this object should be the string 239.x.x.x/y with x and y replaced appropriately to describe the address and mask length associated with the scope.
T/F ipMRoute1ScopeNameDefault	1.3.6.1.3.60.1.1.6.1.5	TruthValue	read-only	If true, indicates a preference that the name in the following language should be used by applications if no name is available in a desired language.
ROW ipMRoute1ScopeNameStatus	1.3.6.1.3.60.1.1.6.1.6	RowStatus	read-only	The status of this row, by which new entries may be created, or old entries deleted from this table.
G32 ipMRoute1EntryCount	1.3.6.1.3.60.1.1.7	Gauge32	read-only	The number of rows in the ipMRoute1Table. This can be used to monitor the multicast routing table size.
ipMRoute1MIBConformance	1.3.6.1.3.60.2
ipMRoute1MIBCompliances	1.3.6.1.3.60.2.1
ipMRoute1MIBCompliance	1.3.6.1.3.60.2.1.1			The compliance statement for the IP Multicast MIB.
ipMRoute1MIBGroups	1.3.6.1.3.60.2.2
ipMRoute1MIBBasicGroup	1.3.6.1.3.60.2.2.1			A collection of objects to support basic management of IP Multicast routing.
ipMRoute1MIBHopCountGroup	1.3.6.1.3.60.2.2.2			A collection of objects to support management of the use of hop counts in IP Multicast routing.
ipMRoute1MIBBoundaryGroup	1.3.6.1.3.60.2.2.3			A collection of objects to support management of scoped multicast address boundaries.
ipMRoute1MIBPktsOutGroup	1.3.6.1.3.60.2.2.4			A collection of objects to support management of packet counters for each outgoing interface entry of a route.
ipMRoute1MIBHCInterfaceGroup	1.3.6.1.3.60.2.2.5			A collection of objects providing information specific to high speed (greater than 20,000,000 bits/second) network interfaces.
ipMRoute1MIBRouteGroup	1.3.6.1.3.60.2.2.6			A collection of objects providing information on the relationship between multicast routing information, and the IP Forwarding Table.
ipMRoute1MIBPktsGroup	1.3.6.1.3.60.2.2.7			A collection of objects to support management of packet counters for each forwarding entry.

RFC description

Manages IP multicast routing protocol independent functionality for multicast forwarding, group management, and routing protocol status.

Start monitoring IP multicast-capable routers and switches 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 IPMROUTE-MIB