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]}} {log} {trap}]} {ports [port_group | port_list]}

Description

Configures an ACL meter to provide ingress traffic rate shaping on BlackDiamond X8 series switches, BlackDiamond 8800 series switches, E4G-200 and E4G-400 switches, SummitStack, and Summit family switches. On BlackDiamond c-, xl-, and xm-series modules, you can use this command to configure meters for ingress and egress rate limiting.

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) on BlackDiamond X8 series switches, BlackDiamond 8800 series switches, E4G-200 and E4G-400 switches, SummitStack, and Summit family switches.
out-actions Specifies actions to take if traffic exceeds the profile.
drop Specifies to drop out of profile traffic on BlackDiamond X8 series switches, BlackDiamond 8800 series switches, E4G-200 and E4G-400 switches, SummitStack, and Summit family switches.
set-drop-precedence Specifies to mark packet for high drop precedence on BlackDiamond X8 series switches, BlackDiamond 8800 series switches, E4G-200 and E4G-400 switches, SummitStack, and Summit family switches.
dscp Specifies to set DSCP on BlackDiamond X8 series switches, BlackDiamond 8800 series switches, E4G-200 and E4G-400 switches, SummitStack, and Summit family switches.
none Specifies to leave the DSCP value unchanged on BlackDiamond X8 series switches, BlackDiamond 8800 series switches, E4G-200 and E4G-400 switches, SummitStack, and Summit family switches.
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.

Default

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.

Click to expand in new window

Rate Configuration Notes

Platform Granularity Notes
BlackDiamond X8 series switches, BlackDiamond 8000 c-, e-, xl-, and xm-series modules, E4G-200 and E4G-400 switches, and Summit family switches 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 BlackDiamond X8 series switches, BlackDiamond 8000 series switches, E4G-200 and E4G-400 switches, and Summit 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, or setting the DSCP 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.

On BlackDiamond X8 series switches, BlackDiamond 8900 xm-series modules and Summit X670 series switches, the meters behave as follows:
  • QP1-4 support one unicast queue and one multicast queue for each QoS profile. The metering configuration for each of these QoS profiles applies to both the unicast and the multicast traffic for the profile.
  • Configuration of maximum bandwidth metering on QP5-8 causes the configuration of the maximum meter on the supporting multicast queue to be set to the maximum bandwidth configured on QP5-8.

Example

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

History

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

Platform Availability

This command is available on all platforms.