configure meter

configure meter metername {committed-rate cir [Gbps | Mbps | Kbps | Pps]} {max-burst-size burst-size [Kb | Mb | packets]} {out-actions [{disable-port} {drop | set-drop-precedence {dscp [none | dscp-value]} {dot1p [ none | dot1p-value ]}} {log} {trap}]} {ports [port_group | port_list]}


Configures an ACL meter to provide ingress traffic rate shaping.

Syntax Description

metername Specifies the ACL meter name.
committed-rate Specifies the committed information rate in gigabits per second (Gbps), megabits per second (Mbps), or kilobits per second (Kbps).
max-burst-size Specifies the maximum burst size or peak burst size in kilobits (Kb) or megabits (Mb).
out-actions Specifies actions to take if traffic exceeds the profile.
drop Specifies to drop out of profile traffic.
set-drop-precedence Specifies to mark packet for high drop precedence.
dscp Specifies to set DSCP.
dscp-value DSCP value (0-63).
none Specifies to leave the DSCP or dot1p value unchanged.
dot1p Specifies dot1p value to be set.
dot1p-value Dot1p value (0-7).
log Generate log event if trafic exceeds configured rate.
trap Generate SNMP trap if traffic exceeds configured rate.
ports Meter configuration is applicable to ports in the specified port_group or port_list.
port_group Port group name.
port_list Port list separated by a comma.


By default, a newly committed meter has no maximum burst size, no committed rate, and a default action of drop.

Usage Guidelines

The meter configured with this command is associated with an ACL rule by specifying the meter name using the meter action modifier within the rule.

The committed-rate keyword specifies the traffic rate allowed for this meter, and the configured rate operates as described in Rate Configuration Notes. The rate you specify is rounded up to the next granularity increment value. For example, if you configure a 1 Mbps committed rate for a platform with a 64Kbps granularity increment, this value falls between the increment values of 960 Kbps and 1024 Kbps, so the effective committed rate is set to 1024 Kbps. Also, note that some platforms listed below require an adjustment to the expected rate to calculate the configured rate.

Table 1. Rate Configuration Notes
Platform Granularity Notes
All platforms 64Kbps

Specify the traffic rate in Kbps, Mbps, or Gbps.

The range is 64Kbps to 1 Gbps for GE ports and 1Mbps to 10 Gbps for 10GE ports.

Add 20 bytes per frame to the expected rate to determine the configured rate.

The max-burst-size keyword specifies the maximum number of consecutive bits that are allowed to be in-profile at wire-speed. The max-burst-size parameter can be specified in Kb, Mb, or Gb. The specified max-burst-size is rounded down to the nearest supported size. The max-burst-size range on ExtremeSwitching switches is 32Kb to 128Mb.

The keyword out-actions specifies the action that is taken when a packet is out-of-profile. The supported actions include dropping the packet, marking the drop precedence for the packet, setting the DSCP value in the packet, or setting the DOT1P value in the packet. The keyword drop indicates that any out-of-profile packet is immediately dropped. The keyword set-drop-precedence marks out-of-profile packets with high drop precedence. If the optional keyword set-dscp is specified, the DSCP value, as specified by the parameter dscp-value, is written into the out-of-profile packet. Setting the DSCP value to none leaves the DSCP value in the packet unchanged. If the optional keyword set-dot1p is specified, the DOT1P value, as specified by the parameter dot1p-value, is written into the out-of-profile packet. Setting the DOT1P value to none leaves the DOT1P value in the packet unchanged.


The following example configures the ACL meter maximum_bandwidth, assigns it a rate of 10 Mbps, and sets the out of profile action to drop:

configure meter maximum_bandwidth committed-rate 10 Mbps out-action drop

The following example uses the port_groups variable:

configure meter ingmeter0 committed-rate 50 Mbps out-actions drop log disable-port ports GroupA
configure meter ingmeter1 committed-rate 75 Mbps out-actions drop log disable-port ports GroupA
configure meter ingmeter0 committed-rate 100 Pps out-actions drop log disable-port ports GroupB
configure meter ingmeter1 committed-rate 150 Pps out-actions drop log disable-port ports GroupB


This command was available in ExtremeXOS 11.1.

The log, trap and ports keywords and port-group and port_list variables were added in ExtremeXOS 16.1

The dot1p keyword and variable were added in ExtremeXOS 21.1.

Platform Availability

This command is available on ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, X670-G2, X690, X695, X870, 5320, 5420, and 5520 series switches.