Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


show igmp statistics


Syntax (MX Series)

Syntax (EX Series and QFX Series)


Display Internet Group Management Protocol (IGMP) statistics.

By default, Junos OS multicast devices collect statistics of received and transmitted IGMP control messages that reflect currently active multicast group subscribers.

Some devices also automatically maintain continuous IGMP statistics globally on the device in addition to the default active subscriber statistics—these are persistent, continuous statistics of received and transmitted IGMP control packets that account for both past and current multicast group subscriptions processed on the device. With continuous statistics, you can see the total count of IGMP control packets the device processed since the last device reboot or clear igmp statistics continuous command. The device collects and displays continuous statistics only for the fields shown in the IGMP packet statistics output section of this command, and does not display the IGMP Global statistics section.

Devices that support continuous statistics maintain this information in a shared database and copy it to the backup Routing Engine at a configurable interval to avoid too much processing overhead on the Routing Engine. These actions preserve statistics counts across the following events or operations (which doesn’t happen for the default active subscriber statistics):

  • Routing daemon restart

  • Graceful Routing Engine switchover (GRES)

  • In-service software upgrade (ISSU)

  • Line card reboot

You can change the default interval (300 seconds) using the cont-stats-collection-interval configuration statement at the [edit routing-options multicast] hierarchy level.

You can display either the default currently active subscriber statistics or continuous subscriber statistics (if supported), but not both at the same time. Include the continuous option to display continuous statistics, otherwise the command displays the statistics only for active subscribers.

Run the clear igmp statistics command to clear the currently active subscriber statistics. On devices that support continuous statistics, run the clear command with the continuous option to clear all continuous statistics. You must run these commands separately to clear both types of statistics because the device maintains and clears the two types of statistics separately.



Display IGMP statistics for all interfaces. These statistics represent currently active subscribers.

brief | detail

(Optional) Display the specified level of output.


(Optional) Display continuous IGMP statistics that account for both past and current multicast group subscribers instead of the default statistics that only reflect currently active subscribers. This option is not available with the interface option for interface-specific statistics.

interface interface-name

(Optional) Display IGMP statistics about the specified interface only. This option is not available with the continuous option.

logical-system (all | logical-system-name)

(Optional) Perform this operation on all logical systems or on a particular logical system.

Required Privilege Level


Output Fields

Table 1 describes the output fields for the show igmp statistics command. Output fields are listed in the approximate order in which they appear.

Table 1: show igmp statistics Output Fields

Field Name

Field Description

IGMP packet statistics

Heading for IGMP packet statistics for all interfaces or for the specified interface name.


Shows currently active subscriber statistics in this section by default, or when the command includes the continuous option, shows continuous, persistent statistics that account for all IGMP control packets processed on the device.

IGMP Message type

Summary of IGMP statistics:

  • Membership Query—Number of membership queries sent and received.

  • V1 Membership Report—Number of version 1 membership reports sent and received.

  • DVMRP—Number of DVMRP messages sent or received.

  • PIM V1—Number of PIM version 1 messages sent or received.

  • Cisco Trace—Number of Cisco trace messages sent or received.

  • V2 Membership Report—Number of version 2 membership reports sent or received.

  • Group Leave—Number of group leave messages sent or received.

  • Mtrace Response—Number of Mtrace response messages sent or received.

  • Mtrace Request—Number of Mtrace request messages sent or received.

  • Domain Wide Report—Number of domain-wide reports sent or received.

  • V3 Membership Report—Number of version 3 membership reports sent or received.

  • Other Unknown types—Number of unknown message types received.

  • IGMP v3 unsupported type—Number of messages received with unknown and unsupported IGMP version 3 message types.

  • IGMP v3 source required for SSM—Number of IGMP version 3 messages received that contained no source.

  • IGMP v3 mode not applicable for SSM—Number of IGMP version 3 messages received that did not contain a mode applicable for source-specific multicast (SSM). Beginning with certain releases, this type includes records received for groups in the SSM range of addresses and in which the mode is MODE_IS_EXCLUDE or CHANGE_TO_EXCLUDE_MODE. This includes records with a non-empty source list.


Number of messages received.


Number of messages sent.

Rx errors

Number of received packets that contained errors.

Max Rx rate (pps)

Maximum number of IGMP packets received during 1 second interval.

IGMP Global Statistics

Summary of IGMP statistics for all interfaces.


These statistics are not supported or displayed with the continuous option.

  • Bad Length—Number of messages received with length errors so severe that further classification could not occur.

  • Bad Checksum—Number of messages received with a bad IP checksum. No further classification was performed.

  • Bad Receive If—Number of messages received on an interface not enabled for IGMP.

  • Rx non-local—Number of messages received from senders that are not local.

  • Timed out—Number of groups that timed out as a result of not receiving an explicit leave message.

  • Rejected Report—Number of reports dropped because of the IGMP group policy.

  • Total Interfaces—Number of interfaces configured to support IGMP.

Sample Output

show igmp statistics

show igmp statistics interface

show igmp statistics continuous

Release Information

Command introduced before Junos OS Release 7.4.

continuous option added in Junos OS Release 19.4R1 for MX Series routers.