IGMP-MIB

All MIBs › IGMP-MIB

Organization: IETF IDMR Working Group.

Last Updated: 1997-12-18

Category: Routing Protocols

Description: Defines managed objects for the Internet Group Management Protocol (IGMP), used to manage IPv4 multicast group membership on routers and hosts.

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

What Is IGMP-MIB?

IGMP-MIB is a vendor-neutral IETF standards-track module (based on RFC 2933) covering the Internet Group Management Protocol, which routers and hosts use to manage IPv4 multicast group membership on a LAN segment. The IGMP-MIB MIB is a foundational module for any network relying on IPv4 multicast delivery. It exposes per-interface IGMP configuration and per-group multicast cache data, describing which multicast groups are being requested on which interfaces and by which hosts. For hardware/software status monitoring it is most useful for confirming that IGMP is enabled and functioning correctly on router interfaces—showing group membership counts, query intervals, and interface-level IGMP state rather than physical hardware health. It commonly depends on and is deployed alongside the IP-MIB and multicast routing MIBs (e.g., IPMROUTE-MIB) since IGMP group state feeds multicast forwarding decisions. It is typically deployed on multicast-enabled routers and Layer 3 switches in networks running IPTV, video conferencing, or other multicast applications.

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

Monitoring Examples

An administrator would poll the IGMP interface table to confirm querier status and query-interval configuration on a router's multicast-enabled interfaces, and poll the IGMP cache/group membership data to see which multicast groups currently have active receivers. A sudden drop in reported group memberships on an interface that should have active video receivers would indicate an IGMP snooping or membership-timeout problem. Because sample_objects was empty for this MIB, exact table/column names are based on the well-known RFC 2933 structure (interface and cache tables) rather than a source-verified list.

What Can Be Monitored

IGMP querier status per interface
multicast group membership per interface
IGMP query interval configuration
IGMP version in use

Imported Objects

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

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

From SNMPv2-TC

RowStatus
TruthValue

How to Use in IPNetwork Monitor

Example using igmpCacheUpTime OID:

Select a device implementing IGMP-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 igmpCacheUpTime 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. It reports, in TimeTicks, how long the system has been a member of this IGMP multicast group — a value of 0 means it is not currently a member. 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 TimeTicks-type OID, Value bounds is the most useful condition here — trigger an alert if the value unexpectedly drops to 0 for a group your applications rely on, indicating group membership was lost. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
igmp	1.3.6.1.3.59.1.1
igmpBaseMIBGroup	1.3.6.1.3.59.2.2.1			The basic collection of objects providing management of IGMP version 1 or 2.
IP igmpCacheAddress	1.3.6.1.3.59.1.1.2.1.1	IpAddress	not-accessible	The IP multicast group address for which this entry contains information.
igmpCacheEntry	1.3.6.1.3.59.1.1.2.1		not-accessible	An entry (conceptual row) in the igmpCacheTable.
TIK igmpCacheExpiryTime	1.3.6.1.3.59.1.1.2.1.6	TimeTicks	read-only	The minimum amount of time remaining before this entry will be aged out.
I32 igmpCacheIfIndex	1.3.6.1.3.59.1.1.2.1.2	Integer32	not-accessible	The interface for which this entry contains information for an IP multicast group address.
IP igmpCacheLastReporter	1.3.6.1.3.59.1.1.2.1.4	IpAddress	read-only	The IP address of the source of the last membership report received for this IP Multicast group address on this interface. If no membership report has been received, this object has the value 0.0.0.0.
T/F igmpCacheSelf	1.3.6.1.3.59.1.1.2.1.3	TruthValue	read-create	An indication of whether the local system is a member of this group address on this interface.
ROW igmpCacheStatus	1.3.6.1.3.59.1.1.2.1.7	RowStatus	read-create	The status of this entry.
igmpCacheTable	1.3.6.1.3.59.1.1.2		not-accessible	The (conceptual) table listing the IP multicast groups for which there are members on a particular interface.
TIK igmpCacheUpTimeEx	1.3.6.1.3.59.1.1.2.1.5	TimeTicks	read-only	The time since the system joined this group address, or zero if the system is not currently a member.
I32 igmpCacheVersion1HostTimer	1.3.6.1.3.59.1.1.2.1.8	Integer32	read-only	The time remaining until the local router will assume that there are no longer any IGMP version 1 members on the IP subnet attached to this interface. Upon hearing any IGMPv1 Membership Report, this value is reset to the group membership timer. While this time remaining is non-zero, the local router ignores any IGMPv2 Leave messages for this group that it receives on this interface.
igmpInterfaceEntry	1.3.6.1.3.59.1.1.1.1		not-accessible	An entry (conceptual row) representing an interface on which IGMP is enabled.
G32 igmpInterfaceGroups	1.3.6.1.3.59.1.1.1.1.13	Gauge32	read-only	The current number of entries for this interface in the Cache Table.
I32 igmpInterfaceIfIndex	1.3.6.1.3.59.1.1.1.1.1	Integer32	not-accessible	The interface for which IGMP is enabled.
C32 igmpInterfaceJoins	1.3.6.1.3.59.1.1.1.1.11	Counter32	read-only	The number of times a group membership has been added on this interface; that is, the number of times an entry for this interface has been added to the Cache Table. This object gives an indication of the amount of IGMP activity over time.
T/F igmpInterfaceLeaveEnabled	1.3.6.1.3.59.1.1.1.1.8	TruthValue	read-create	An indication of whether the processing of IGMPv2 Leave messages is enabled on this interface. This object is now deprecated since it must be true when igmpInterfaceVersion is version2, and must be false when it is version1 to comply with the IGMP specfication.
C32 igmpInterfaceLeaves	1.3.6.1.3.59.1.1.1.1.12	Counter32	read-only	The number of times a group membership has been removed from this interface; that is, the number of times an entry for this interface has been deleted from the Cache Table. This object is deprecated since its value cannot be usefully compared with igmpInterfaceJoins to get the number of groups joined. Instead, igmpInterfaceGroups gives the number of groups joined, which may be compared with igmpInterfaceJoins to derive the number of leaves.
IP igmpInterfaceQuerier	1.3.6.1.3.59.1.1.1.1.5	IpAddress	read-only	The address of the IGMP Querier on the IP subnet to which this interface is attached.
I32 igmpInterfaceQuerierPresentTimeout	1.3.6.1.3.59.1.1.1.1.7	Integer32	read-create	A timeout interval. If no IGMPv2 queries are heard on this interface within this timeout interval, the local router will take over the Querier on the IP subnet to which this interface is attached. This object is now deprecated, since its value can be derived from igmpInterfaceRobustness.
I32 igmpInterfaceQueryInterval	1.3.6.1.3.59.1.1.1.1.2	Integer32	read-create	The frequency at which IGMP Host-Query packets are transmitted on this interface.
I32 igmpInterfaceQueryMaxResponseTime	1.3.6.1.3.59.1.1.1.1.6	Integer32	read-create	The maximum query response time advertised in IGMPv2 queries on this interface.
I32 igmpInterfaceRobustness	1.3.6.1.3.59.1.1.1.1.14	Integer32	read-create	The Robustness Variable allows tuning for the expected packet loss on a subnet. If a subnet is expected to be lossy, the Robustness Variable may be increased. IGMP is robust to (Robustness Variable-1) packet losses.
ROW igmpInterfaceStatus	1.3.6.1.3.59.1.1.1.1.3	RowStatus	read-create	The activation of a row enables IGMP on the interface. The destruction of a row disables IGMP on the interface.
igmpInterfaceTable	1.3.6.1.3.59.1.1.1		not-accessible	The (conceptual) table listing the interfaces on which IGMP is enabled.
INT igmpInterfaceVersion	1.3.6.1.3.59.1.1.1.1.4	INTEGER	read-create	The version of IGMP which is running on this interface. This object can be used to configure a router capable of running either value. For IGMP to function correctly, all routers on a LAN must be configured to run the same version of IGMP on that LAN.
I32 igmpInterfaceVersion1QuerierTimer	1.3.6.1.3.59.1.1.1.1.9	Integer32	read-only	The time remaining until the host assumes that there are no IGMPv1 routers present on the interface. While this is non-zero, the host will reply to all queries with version 1 membership reports.
C32 igmpInterfaceWrongVersionQueries	1.3.6.1.3.59.1.1.1.1.10	Counter32	read-only	The number of queries received whose IGMP version does not match igmpInterfaceVersion. IGMP requires that all routers on a LAN be configured to run the same version of IGMP. Thus, if any queries are received with the wrong version, this indicates a configuration error.
igmpMIB	1.3.6.1.3.59			The MIB module for IGMP Management.
igmpMIBCompliances	1.3.6.1.3.59.2.1
igmpMIBConformance	1.3.6.1.3.59.2
igmpMIBGroups	1.3.6.1.3.59.2.2
igmpMIBObjects	1.3.6.1.3.59.1
igmpRouterMIBGroup	1.3.6.1.3.59.2.2.2			A collection of additional objects for management of IGMP version 1 or 2 in routers.
igmpRouterVersion2MIBGroup	1.3.6.1.3.59.2.2.4			A collection of additional objects for management of IGMP version 2 in routers. This group has been obsoleted by igmpV2RouterMIBGroup.
igmpV1HostMIBCompliance	1.3.6.1.3.59.2.1.1			The compliance statement for hosts running IGMPv1 and implementing the IGMP MIB.
igmpV1RouterMIBCompliance	1.3.6.1.3.59.2.1.2			The compliance statement for routers running IGMPv1 and implementing the IGMP MIB.
igmpV2HostMIBCompliance	1.3.6.1.3.59.2.1.3			The compliance statement for hosts running IGMPv2 and implementing the IGMP MIB.
igmpV2HostMIBGroup	1.3.6.1.3.59.2.2.3			A collection of additional objects for management of IGMP version 2 in hosts.
igmpV2RouterMIBCompliance	1.3.6.1.3.59.2.1.4			The compliance statement for routers running IGMPv2 and implementing the IGMP MIB.
igmpV2RouterMIBGroup	1.3.6.1.3.59.2.2.5			A collection of additional objects for management of IGMP version 2 in routers.

FAQ

What does IGMP-MIB expose for monitoring multicast on a router?
It exposes per-interface IGMP configuration and per-group multicast cache data, describing which multicast groups are being requested on which interfaces, along with query interval settings and the IGMP version in use.

How would this MIB be used in an IPTV or multicast video deployment?
On a multicast-enabled router or Layer 3 switch, an operator polls IGMP querier status and group membership counts per interface to confirm IGMP is enabled and functioning correctly, typically alongside the IP-MIB and multicast routing MIBs like IPMROUTE-MIB that use the IGMP group state for forwarding decisions.

RFC description

Internet Group Management Protocol MIB (RFC 2933, obsoleted by RFC 5519) defining objects for managing IGMP version configuration, group memberships, and multicast operations.

Start monitoring Vendor-neutral IETF standard (IPv4 multicast-capable routers/Layer 3 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 IGMP-MIB