Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show policer

Syntax

Description

Display the number of policed packets for a given policer or an aggregate policer. An aggregate policer is an aggregate of different policers on the same logical interface.

Options

detail

(Optional) Display additional statistics and counters. Requires the enhanced-policer statement to be enabled at the [edit chassis] hierarchy level.

Note:

show policer detail is not available for the following counters: three color policers, hierarchical policers, prefix-specific actions, LSP policers and other nexthop policers, and fast-update-filters on devices running MPC1 or MPC2 line cards.

policer-name

(Optional) Display the number of policed packets for the specified policer.

<null>

Displays the number of policed packets for all configured policers.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show policer command. Output fields are listed in the approximate order in which they appear.

Table 1: show policer Output Fields

Field Name

Field Description

Name

Name of the policer. Policier detail also includes the following statistics:

OOS

Packet statistics for packets that are marked out-of-specification by the policer. Changes to all packets that have out-of-specification actions, such as discard, color marking, or forwarding-class, are included in this counter.

Offered

Packet statistics for traffic subjected to policing.

Transmitted

Packet statistics for traffic that is not discarded by the policer. When the policer action is discard, the statistics are the same as the within-specification statistics; when the policer action is non-discard (loss-priority or forwarding-class), the statistics are included in this counter.

Bytes

  • (For two-color policers on MX Series routers, and for hierarchical policers on MS-DPC, MIC, and MPC interfaces on MX Series routers)—Total number of bytes policed by the specified policer.

    For other combinations of policer type, device, and line card type, this field is blank.

  • (T Series and M10i)—Not applicable. The Bytes information is not displayed.

Packets

Total number of packets policed by the specified policer.

Sample Output

show policer (Junos OS Evolved)

In Junos OS Evolved, the output of this command doesn't display the default Address Resolution Protocol (ARP) policer because it isn't needed. Distributed denial of service (DDoS) protection replaces the functionality of the default ARP policer.

show policer (MX Series)

show policer (non MX Series Router)

show policer (Aggregate Policer, non MX Series Router)

show policer detail (MX Series Router running MPC 1 or MPC 2 line cards)

Release Information

Command introduced before Junos OS Release 7.4.

The command show policer detail was introduced in Junos OS Release 12.3.