Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show interfaces queue

Syntax

Description

Display class-of-service (CoS) queue information for physical interfaces.

Options

none

Show detailed CoS queue statistics for all physical interfaces.

aggregate

(Optional) Display the aggregated queuing statistics of all logical interfaces that have traffic-control profiles configured. (Not on the QFX Series.)

both-ingress-egress

(Optional) On Gigabit Ethernet Intelligent Queuing 2 (IQ2) PICs, display both ingress and egress queue statistics. (Not on the QFX Series.)

egress

(Optional) Display egress queue statistics.

forwarding-class forwarding-class

(Optional) Forwarding class name for this queue. Shows detailed CoS statistics for the queue associated with the specified forwarding class.

ingress

(Optional) On Gigabit Ethernet IQ2 PICs, display ingress queue statistics. (Not on the QFX Series.)

interface-name

(Optional) Show detailed CoS queue statistics for the specified interface.

l2-statistics

(Optional) Display Layer 2 statistics for MLPPP, FRF.15, and FRF.16 bundles

buffer-occupancy

Displays the peak buffer occupancy for each queue while buffer-monitor-enable is enabled at the [edit chassis fpc slot-number traffic-manager] hierarchy level.

remaining-traffic

(Optional) Display the queuing statistics of all logical interfaces that do not have traffic-control profiles configured. (Not on the QFX Series.)

Overhead for Layer 2 Statistics

Transmitted packets and transmitted byte counts are displayed for the Layer 2 level with the addition of encapsulation overheads applied for fragmentation, as shown in Table 1. Others counters, such as packets and bytes queued (input) and drop counters, are displayed at the Layer 3 level. In the case of link fragmentation and interleaving (LFI) for which fragmentation is not applied, corresponding Layer 2 overheads are added, as shown in Table 1.

Table 1: Layer 2 Overhead and Transmitted Packets or Byte Counts

Protocol

Fragmentation

LFI

First fragmentation

Second to n fragmentations

Bytes

Bytes

MLPPP (Long)

13

12

8

MLPPP (short)

11

10

8

MLFR (FRF15)

12

10

8

MFR (FRF16)

10

8

-

MCMLPPP(Long)

13

12

-

MCMLPPP(Short)

11

10

-

Layer 2 Statistics—Fragmentation Overhead Calculation

Overhead with LFI

The following examples show overhead for different cases:

  • A 1000-byte packet is sent to a mlppp bundle without any fragmentation. At the Layer 2 level, bytes transmitted is 1013 in 1 packet. This overhead is for MLPPP long sequence encap.

  • A 1000-byte packet is sent to a mlppp bundle with a fragment threshold of 250byte. At the Layer 2 level, bytes transmitted is 1061 bytes in 5 packets.

  • A 1000-byte LFI packet is sent to an mlppp bundle. At the Layer 2 level, bytes transmitted is 1008 in 1 packet.

Additional Information

For rate-limited interfaces hosted on Modular Interface Cards (MICs), Modular Port Concentrators (MPCs), or Enhanced Queuing DPCs, rate-limit packet-drop operations occur before packets are queued for transmission scheduling. For such interfaces, the statistics for queued traffic do not include the packets that have already been dropped due to rate limiting, and consequently the displayed statistics for queued traffic are the same as the displayed statistics for transmitted traffic.

Note:

For rate-limited interfaces hosted on other types of hardware, rate-limit packet-drop operations occur after packets are queued for transmission scheduling. For these other interface types, the statistics for queued traffic include the packets that are later dropped due to rate limiting, and consequently the displayed statistics for queued traffic equals the sum of the statistics for transmitted and rate-limited traffic.

On M Series routers (except for the M320 and M120 routers), this command is valid only for a PIC installed on an enhanced Flexible PIC Concentrator (FPC).

Queue statistics for aggregated interfaces are supported on the M Series and T Series routers only. Statistics for an aggregated interface are the summation of the queue statistics of the child links of that aggregated interface. You can view the statistics for a child interface by using the show interfaces statistics command for that child interface.

When you configure tricolor marking on a 10-port 1-Gigabit Ethernet PIC, for queues 6 and 7 only, the output does not display the number of queued bytes and packets, or the number of bytes and packets dropped because of RED. If you do not configure tricolor marking on the interface, these statistics are available for all queues.

For the 4-port Channelized OC12 IQE PIC and 1-port Channelized OC48 IQE PIC, the Packet Forwarding Engine Chassis Queues field represents traffic bound for a particular physical interface on the PIC. For all other PICs, the Packet Forwarding Engine Chassis Queues field represents the total traffic bound for the PIC.

For Gigabit Ethernet IQ2 PICs, the show interfaces queue command output does not display the number of tail-dropped packets. This limitation does not apply to Packet Forwarding Engine chassis queues.

When fragmentation occurs on the egress interface, the first set of packet counters shows the postfragmentation values. The second set of packet counters (under the Packet Forwarding Engine Chassis Queues field) shows the prefragmentation values.

The behavior of the egress queues for the Routing Engine-Generated Traffic is not same as the configured queue for MLPPP and MFR configurations.

For related CoS operational mode commands, see the CLI Explorer.

Required Privilege Level

view

Output Fields

Table 2 lists the output fields for the show interfaces queue command. Output fields are listed in the approximate order in which they appear.

Table 2: show interfaces queue Output Fields

Field Name

Field Description

Physical interface

Name of the physical interface.

Enabled

State of the interface. Possible values are described in the “Enabled Field” section under Common Output Fields Description.

Interface index

Physical interface's index number, which reflects its initialization sequence.

SNMP ifIndex

SNMP index number for the interface.

Forwarding classes supported

Total number of forwarding classes supported on the specified interface.

Forwarding classes in use

Total number of forwarding classes in use on the specified interface.

Ingress queues supported

On Gigabit Ethernet IQ2 PICs only, total number of ingress queues supported on the specified interface.

Ingress queues in use

On Gigabit Ethernet IQ2 PICs only, total number of ingress queues in use on the specified interface.

Output queues supported

Total number of output queues supported on the specified interface.

Output queues in use

Total number of output queues in use on the specified interface.

Egress queues supported

Total number of egress queues supported on the specified interface.

Egress queues in use

Total number of egress queues in use on the specified interface.

Queue counters (Ingress)

CoS queue number and its associated user-configured forwarding class name. Displayed on IQ2 interfaces.

  • Queued packets—Number of queued packets.

    Note:

    This field is not supported on QFX5100, QFX5110, QFX5200, and QFX5210 switches due to hardware limitations.

  • Transmitted packets—Number of transmitted packets.

  • Dropped packets—Number of packets dropped by the ASIC's RED mechanism.

Burst size

(Logical interfaces on IQ PICs only) Maximum number of bytes up to which the logical interface can burst. The burst size is based on the shaping rate applied to the interface.

The following output fields are applicable to both interface component and Packet Forwarding component in the show interfaces queue command:

Queue

Queue number.

Forwarding classes

Forwarding class name.

Queued Packets

Number of packets queued to this queue.

Note:

For Gigabit Ethernet IQ2 interfaces, the Queued Packets count is calculated by the Junos OS interpreting one frame buffer as one packet. If the queued packets are very large or very small, the calculation might not be completely accurate for transit traffic. The count is completely accurate for traffic terminated on the router.

For rate-limited interfaces hosted on MICs or MPCs only, this statistic does not include traffic dropped due to rate limiting. For more information, see Additional Information.

Note:

This field is not supported on QFX5100, QFX5110, QFX5200, and QFX5210 switches due to hardware limitations.

This field is not supported on EX Series switches due to hardware limitations.

Queued Bytes

Number of bytes queued to this queue. The byte counts vary by interface hardware. For more information, see Table 3.

For rate-limited interfaces hosted on MICs or MPCs only, this statistic does not include traffic dropped due to rate limiting. For more information, see Additional Information.

Note:

This field is not supported on QFX5100, QFX5110, QFX5200, and QFX5210 switches due to hardware limitations.

This field is not supported on EX Series switches due to hardware limitations.

Transmitted Packets

Number of packets transmitted by this queue. When fragmentation occurs on the egress interface, the first set of packet counters shows the postfragmentation values. The second set of packet counters (displayed under the Packet Forwarding Engine Chassis Queues field) shows the prefragmentation values.

Note:

For Layer 2 statistics, see Overhead for Layer 2 Statistics

Transmitted Bytes

Number of bytes transmitted by this queue. The byte counts vary by interface hardware. For more information, see Table 3.

Note:

On MX Series routers, this number can be inaccurate when you issue the command for a physical interface repeatedly and in quick succession, because the statistics for the child nodes are collected infrequently. Wait ten seconds between successive iterations to avoid this situation.

Note:

For Layer 2 statistics, see Overhead for Layer 2 Statistics

Tail-dropped packets

Number of packets dropped because of tail drop.

Note:

Starting with Junos OS 18.3R1, the Tail-dropped packets counter is supported on PTX Series Packet Transport Routers.

RL-dropped packets

Number of packets dropped due to rate limiting.

For rate-limited interfaces hosted on MICs, MPCs, and Enhanced Queuing DPCs only, this statistic is not included in the queued traffic statistics. For more information, see Additional Information.

Note:

The RL-dropped packets counter is not supported on the PTX Series Packet Transport Routers, and is omitted from the output.

RL-dropped bytes

Number of bytes dropped due to rate limiting.

For rate-limited interfaces hosted on MICs, MPCs, and Enhanced Queuing DPCs only, this statistic is not included in the queued traffic statistics. For more information, see Additional Information.

RED-dropped packets

Number of packets dropped because of random early detection (RED).

  • (M Series and T Series routers only) On M320 and M120 routers and the T Series routers, the total number of dropped packets is displayed. On all other M Series routers, the output classifies dropped packets into the following categories:

    • Low, non-TCP—Number of low-loss priority non-TCP packets dropped because of RED.

    • Low, TCP—Number of low-loss priority TCP packets dropped because of RED.

    • High, non-TCP—Number of high-loss priority non-TCP packets dropped because of RED.

    • High, TCP—Number of high-loss priority TCP packets dropped because of RED.

  • (MX Series routers with enhanced DPCs, and T Series routers with enhanced FPCs only) The output classifies dropped packets into the following categories:

    • Low—Number of low-loss priority packets dropped because of RED.

    • Medium-low—Number of medium-low loss priority packets dropped because of RED.

    • Medium-high—Number of medium-high loss priority packets dropped because of RED.

    • High—Number of high-loss priority packets dropped because of RED.

Note:

Due to accounting space limitations on certain Type 3 FPCs (which are supported in M320 and T640 routers), this field does not always display the correct value for queue 6 or queue 7 for interfaces on 10-port 1-Gigabit Ethernet PICs.

RED-dropped bytes

Number of bytes dropped because of RED. The byte counts vary by interface hardware. For more information, see Table 3.

  • (M Series and T Series routers only) On M320 and M120 routers and the T Series routers, only the total number of dropped bytes is displayed. On all other M Series routers, the output classifies dropped bytes into the following categories:

    • Low, non-TCP—Number of low-loss priority non-TCP bytes dropped because of RED.

    • Low, TCP—Number of low-loss priority TCP bytes dropped because of RED.

    • High, non-TCP—Number of high-loss priority non-TCP bytes dropped because of RED.

    • High, TCP—Number of high-loss priority TCP bytes dropped because of RED.

Note:

Due to accounting space limitations on certain Type 3 FPCs (which are supported in M320 and T640 routers), this field does not always display the correct value for queue 6 or queue 7 for interfaces on 10-port 1-Gigabit Ethernet PICs.

Queue-depth bytes

Displays queue-depth average, current, peak, and maximum values for RTP queues. Because queue-depth values cannot be aggregated, displays the values for RTP queues regardless of whether aggregate, remaining-traffic, or neither option is selected.

Peak

(QFX5000 Series switches only) Diplays the peak buffer occupancy for the queue while buffer-monitor-enable is enabled at the [edit chassis fpc slot-number traffic-manager] hierarchy level.

Last-packet enqueued

Starting with Junos OS Release 16.1, Last-packet enqueued output field is introduced. If packet-timestamp is enabled for an FPC, shows the day, date, time, and year in the format day-of-the-week month day-date hh:mm:ss yyyy when a packet was enqueued in the CoS queue. When the timestamp is aggregated across all active Packet Forwarding Engines, the latest timestamp for each CoS queue is reported.

Byte counts vary by interface hardware. Table 3 shows how the byte counts on the outbound interfaces vary depending on the interface hardware. Table 3 is based on the assumption that outbound interfaces are sending IP traffic with 478 bytes per packet.

Table 3: Byte Count by Interface Hardware

Interface Hardware

Output Level

Byte Count Includes

Comments

Gigabit Ethernet IQ and IQE PICs

Interface

Queued: 490 bytes per packet, representing 478 bytes of Layer 3 packet + 12 bytes

Transmitted: 490 bytes per packet, representing 478 bytes of Layer 3 packet + 12 bytes

RED dropped: 496 bytes per packet representing 478 bytes of Layer 3 packet + 18 bytes

The 12 additional bytes include 6 bytes for the destination MAC address + 4 bytes for the VLAN + 2 bytes for the Ethernet type.

For RED dropped, 6 bytes are added for the source MAC address.

Packet forwarding component

Queued: 478 bytes per packet, representing 478 bytes of Layer 3 packet

Transmitted: 478 bytes per packet, representing 478 bytes of Layer 3 packet

Non-IQ PIC

Interface

T Series, TX Series, T1600, and MX Series routers:

  • Queued: 478 bytes of Layer 3 packet.

  • Transmitted: 478 bytes of Layer 3 packet.

T4000 routers with Type 5 FPCs :

  • Queued: 478 bytes of Layer 3 packet + the full Layer 2 overhead including 4 bytes CRC + the full Layer 1 overhead 8 bytes preamble + 12 bytes Inter frame Gap.

  • Transmitted: 478 bytes of Layer 3 packet + the full Layer 2 overhead including 4 bytes CRC + the full Layer 1 overhead 8 bytes preamble + 12 bytes Interframe Gap.

M Series routers:

  • Queued: 478 bytes of Layer 3 packet.

  • Transmitted: 478 bytes of Layer 3 packet + the full Layer 2 overhead.

PTX Series Packet Transport Routers:

  • Queued: The sum of the transmitted bytes and the RED dropped bytes.

  • Transmitted: Full Layer 2 overhead (including all L2 encapsulation and CRC) + 12 inter-packet gap + 8 for the preamble.

  • RED dropped: Full Layer 2 overhead (including all L2 encapsulation and CRC) + 12 inter-packet gap + 8 for the preamble (does not include the VLAN header or MPLS pushed bytes).

The Layer 2 overhead is 14 bytes for non-VLAN traffic and 18 bytes for VLAN traffic.

IQ and IQE PICs with a SONET/SDH interface

Interface

Queued: 482 bytes per packet, representing 478 bytes of Layer 3 packet + 4 bytes

Transmitted: 482 bytes per packet, representing 478 bytes of Layer 3 packet + 4 bytes

RED dropped: 482 bytes per packet, representing 478 bytes of Layer 3 packet + 4 bytes

The additional 4 bytes are for the Layer 2 Point-to-Point Protocol (PPP) header.

Packet forwarding component

Queued: 478 bytes per packet, representing 478 bytes of Layer 3 packet

Transmitted: 486 bytes per packet, representing 478 bytes of Layer 3 packet + 8 bytes

For transmitted packets, the additional 8 bytes includes 4 bytes for the PPP header and 4 bytes for a cookie.

Non-IQ PIC with a SONET/SDH interface

Interface

T Series, TX Series, T1600, and MX Series routers:

  • Queued: 478 bytes of Layer 3 packet.

  • Transmitted: 478 bytes of Layer 3 packet.

M Series routers:

  • Queued: 478 bytes of Layer 3 packet.

  • Transmitted: 483 bytes per packet, representing 478 bytes of Layer 3 packet + 5 bytes

  • RED dropped: 478 bytes per packet, representing 478 bytes of Layer 3 packet

For transmitted packets, the additional 5 bytes includes 4 bytes for the PPP header and 1 byte for the packet loss priority (PLP).

Interfaces configured with Frame Relay Encapsulation

Interface

The default Frame Relay overhead is 7 bytes. If you configure the Frame Check Sequence (FCS) to 4 bytes, then the overhead increases to 10 bytes.

1-port 10-Gigabit Ethernet IQ2 and IQ2–E PICs

4-port 1G IQ2 and IQ2-E PICs

8-port 1G IQ2 and IQ2-E PICs

Interface

Queued: 478 bytes of Layer 3 packet + the full Layer 2 overhead including CRC.

Transmitted: 478 bytes of Layer 3 packet + the full Layer 2 overhead including CRC.

The Layer 2 overhead is 18 bytes for non-VLAN traffic and 22 bytes for VLAN traffic.

Packet forwarding component

Queued: 478 bytes of Layer 3 packet.

Transmitted: 478 bytes of Layer 3 packet.

Sample Output

show interfaces queue (Rate-Limited Interface on a Gigabit Ethernet MIC in an MPC)

The following example shows queue information for the rate-limited interface ge-4/2/0 on a Gigabit Ethernet MIC in an MPC. For rate-limited queues for interfaces hosted on MICs or MPCs, rate-limit packet drops occur prior to packet output queuing. In the command output, the nonzero statistics displayed in the RL-dropped packets and RL-dropped bytes fields quantify the traffic dropped to rate-limit queue 0 output to 10 percent of 1 gigabyte (100 megabits) per second. Because the RL-dropped traffic is not included in the Queued statistics, the statistics displayed for queued traffic are the same as the statistics for transmitted traffic.

show interfaces queue (Aggregated Ethernet on a T320 Router)

The following example shows that the aggregated Ethernet interface, ae1, has traffic on queues af1 and af12:

show interfaces queue (Gigabit Ethernet on a T640 Router)

show interfaces queue aggregate (Gigabit Ethernet Enhanced DPC)

show interfaces queue (Gigabit Ethernet IQ2 PIC)

show interfaces queue both-ingress-egress (Gigabit Ethernet IQ2 PIC)

show interfaces queue ingress (Gigabit Ethernet IQ2 PIC)

show interfaces queue egress (Gigabit Ethernet IQ2 PIC)

show interfaces queue remaining-traffic (Gigabit Ethernet Enhanced DPC)

show interfaces queue (Channelized OC12 IQE Type 3 PIC in SONET Mode)

show interfaces queue (QFX Series)

show interfaces queue l2-statistics (lsq interface)

show interfaces queue lsq (lsq-ifd)

show interfaces queue (Aggregated Ethernet on a MX series Router)

show interfaces queue ge-0/0/0 (EX2200 Switch)

show interfaces queue xe-6/0/39 (Line Card with Oversubscribed Ports in an EX8200 Switch)

show interfaces queue xe-0/0/2 buffer-occupancy (QFX5000 Series switch)

Release Information

Command introduced before Junos OS Release 7.4.

both-ingress-egress, egress, and ingress options introduced in Junos OS Release 7.6.

l2-statistics option introduced in Junos OS Release 12.1.

buffer-occupancy statement introduced in Junos OS Release 19.1R1 for QFX5000 Series switches.

Release History Table
Release
Description
18.3R1
Starting with Junos OS 18.3R1, the Tail-dropped packets counter is supported on PTX Series Packet Transport Routers.
16.1
Starting with Junos OS Release 16.1, Last-packet enqueued output field is introduced.