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.
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 |
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.
What Can Be Monitored
- IGMP querier status per interface
- multicast group membership per interface
- IGMP query interval configuration
- IGMP version in use
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.
OIDs
| OID symbolic | OID numeric | Type | Access | Description |
|---|---|---|---|---|
| igmpMIB | 1.3.6.1.3.59 | The MIB module for IGMP Management. | ||
| igmpMIBObjects | 1.3.6.1.3.59.1 | |||
| igmp | 1.3.6.1.3.59.1.1 | |||
| igmpInterfaceTable | 1.3.6.1.3.59.1.1.1 | not-accessible | The (conceptual) table listing the interfaces on which IGMP is enabled. | |
| 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. | |
| I32 igmpInterfaceIfIndex | 1.3.6.1.3.59.1.1.1.1.1 | Integer32 | not-accessible | The interface for which IGMP is enabled. |
| 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. |
| 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. |
| 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. |
| 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 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 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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 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. |
| 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. | |
| igmpCacheEntry | 1.3.6.1.3.59.1.1.2.1 | not-accessible | An entry (conceptual row) in the igmpCacheTable. | |
| 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. |
| 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. |
| 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. |
| 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. |
| TIK igmpCacheUpTime | 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. |
| 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. |
| ROW igmpCacheStatus | 1.3.6.1.3.59.1.1.2.1.7 | RowStatus | read-create | The status of this entry. |
| 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. |
| igmpMIBConformance | 1.3.6.1.3.59.2 | |||
| igmpMIBCompliances | 1.3.6.1.3.59.2.1 | |||
| 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. | ||
| igmpV2RouterMIBCompliance | 1.3.6.1.3.59.2.1.4 | The compliance statement for routers running IGMPv2 and implementing the IGMP MIB. | ||
| igmpMIBGroups | 1.3.6.1.3.59.2.2 | |||
| igmpBaseMIBGroup | 1.3.6.1.3.59.2.2.1 | The basic collection of objects providing management of IGMP version 1 or 2. | ||
| 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. | ||
| igmpV2HostMIBGroup | 1.3.6.1.3.59.2.2.3 | A collection of additional objects for management of IGMP version 2 in hosts. | ||
| 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. | ||
| 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.