show igmp statistics

Syntax

Syntax (ACX Series)

Syntax (EX Series and QFX Series)

Description

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.

MX series 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 only for MX series devices. 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.

Options

none	Display IGMP statistics for all interfaces. These statistics represent currently active subscribers.
brief \| detail	(Optional) Display the specified level of output.
continuous	(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

view

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. Note: 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`—Cumulative sum of membership queries sent and received. `V1 Membership Query`—Number of V1 membership queries sent and received. `V2 Membership Query`—Number of V2 membership queries sent and received. `V3 Membership Query`—Number of V3 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.
`Received`	Number of messages received.
`Sent`	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. Note: 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