Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

show policer

 

Syntax

Release Information

Command introduced before Junos OS Release 7.4.

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

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

List of Sample Output

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)

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:

OOSPacket 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.
OfferedPacket statistics for traffic subjected to policing.
TransmittedPacket 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 (MX Series)

user@host> show policer

show policer (non MX Series Router)

user@host> show policer

show policer (Aggregate Policer, non MX Series Router)

user@host> show policer

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

user@host> show policer detail