Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

monitoring-profile

date_range 16-Dec-24

Syntax

content_copy zoom_out_map
monitoring-profile profile-name {
    export-filters filter-name {
        peak-queue-length {
            percent percent;
        }
        queue [queue(s)];
    }
}

Hierarchy Level

content_copy zoom_out_map
[edit class-of-service],
[edit dynamic-profiles name class-of-service]

Description

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.

Options

monitoring-profile

(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.

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

queue

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

  • Range: 0 through 7

Attach the monitoring profile at the [edit class-of-service interfaces interface-name] hierarchy level. For example:

content_copy zoom_out_map
[edit class-of-service]
user@host# show
interfaces {

    ae0 {
        monitoring-profile mp1 shared;
    }
    et-0/0/1 {
        monitoring-profile mp1;
    }
}

By default, a monitoring profile that you assign to an aggregated Ethernet (ae-) interface replicates across all members of the ae- interface. The monitoring profile also reports virtual output queue (VOQ) depth individually on each interface. On large systems, this process can quickly consume the maximum supported hardware monitoring profile IDs. To conserve monitoring profile IDs, include the shared option at the [set class-of-service interfaces ae-interface monitoring-profile profile-name] hierarchy level. The configured shared option creates only one monitoring profile ID to share across all member interfaces. The option also reports the largest peak on a member interface as the common peak for the ae- interface.

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.

footer-navigation