Configures an ACL meter to provide ingress traffic rate shaping.
| 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.
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.
| 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.
This command is available on ExtremeSwitching 5320, 5420, 5520, and 5720 series switches.