Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?




Hierarchy Level


Define a queue-length monitor to measure peak queue occupancy of a virtual output queue (VOQ).

In a typical deployment scenario that uses strict-priority scheduling, a HIGH priority queue can starve LOW priority queues. Thus the packets in such LOW priority queues can remain longer than desired. Use this VOQ queue-length monitoring feature, along with queue transmit statistics, to detect such stalled conditions.



(Required) Name of the monitoring profile.

Use the monitoring profile name to attach the monitoring profile to one or more interfaces. Each monitoring profile contains one or more export filters.


(Required) Name of the export filter.

Each export filter consists of an optional peak queue length percentage filter and one or more queues.

peak-queue-length percent

(Optional) The percentage of the peak queue length filter.

When configured, Junos exports VOQ telemetry only when the hardware-captured peak queue length exceeds the configured value. When not configured, Junos always exports VOQ telemetry.

  • Range: 0 through 100

  • Default: 0


(Required) The queue, or queues, for the export filter to monitor.

  • Range: 0 through 7

Required Privilege Level

interface—To view this statement in the configuration.

interface-control—To add this statement to the configuration.

Release Information

Statement introduced in Junos OS Evolved Release 22.2R1.