Frame-based accounting
This chapter provides information to configure frame-based accounting using the CLI.
Overview of frame-based accounting
When enabled, frame-based accounting allows QoS policies account for the Ethernet frame overhead (for example, it accounts for the IFG (inter-frame gap) and the preamble). Typically, the IFG and preamble constitute about 20 bytes (12 + 8). The QoS meter/policer and shaper use this overhead for Ethernet ports when allocating bandwidth.
On 7210 SAS platforms, a configurable CLI command enables accounting of the frame overhead per port. This command affects the behavior of the SAP ingress FC meter, SAP ingress aggregate meter, ingress queue rate, and egress queue rate of all the SAPs configured on the port. When disabled, the SAP ingress FC meter, SAP ingress aggregate meter, ingress queue rate, and egress queue rate, along with the port egress rate, do not account for the Ethernet frame overhead. When enabled, the SAP ingress FC meter, SAP ingress aggregate meter, ingress queue rate, and egress queue rate, along with the port egress rate, account for the Ethernet frame overhead. By default, frame-based accounting is disabled for the port.
Accounting records and statistics account for frame overhead for SAPs configured on the port when FBA is enabled on the port.
On the 7210 SAS-K 2F1C2T, frame-based accounting is supported on both access ports and access-uplink ports.
On the 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C, frame-based accounting is supported on network ports, hybrid ports, access ports, and access-uplink ports.
Enabling and disabling frame-based accounting
On 7210 SAS platforms, frame-based accounting is supported per port with the capability to enable and disable it per port for both ingress and egress. In other words, it is not possible to enable or disable it only for ingress or for egress; both can be enabled together or disabled together.
To enable frame-based-accounting for both ingress and egress on a port, execute the command config>port>ethernet>frame-based-accounting.
To disable frame-based-accounting for both ingress and egress on a port, execute the command config>port>ethernet>no frame-based-accounting.
Enabling frame-based accounting
*A:Dut-1>config>port>ethernet>#info detail
----------------------------------------------
...snipped....
frame-based-accounting;
... snipped ...
---------------------------------------------
*A:Dut-1>config>port>ethernet #
Disabling frame-based accounting
*A:Dut-1>config>port>ethernet>#info detail
----------------------------------------------
...snipped....
no frame-based-accounting;
... snipped ...
---------------------------------------------
*A:Dut-1>config>port>ethernet #
For more information about the command, see the 7210 SAS-D, Dxp, K 2F1C2T, K 2F6C4T, K 3SFP+ 8C Interface Configuration Guide.
Frame-based accounting command reference
Command hierarchies
Configuration commands
config
- port
- ethernet
- frame-based-accounting
- no frame-based-accounting
Show commands
show
- qos
- network [policy-id] [detail]
- network-queue [network-queue-policy-name] [detail]
- sap-ingress [policy-id] [association | match-criteria | detail]
Command descriptions
Configuration commands
frame-based-accounting
Syntax
frame-based-accounting
no frame-based-accounting
Context
config>port>ethernet
Platforms
Supported on all 7210 SAS platforms as described in this document
Description
This command configure per port frame-based accounting. It can be enabled or disabled on each port.
When enabled, all SAP ingress FC meter rates, SAP ingress aggregate meter rates, shaper rates, meter statistics, and queue statistics on that port also account for the Ethernet Layer 1 overhead (of 20 bytes) in both ingress and egress directions. For example, all SAP ingress FC meter rates, SAP ingress aggregate meter rates, ingress queue shaper rates, egress queue shaper rates, and aggregate SAP shaper rates account for the Ethernet overhead.
The no form of this command disables frame-based-accounting.
Default
no frame-based-accounting
Show commands
network
Syntax
network [policy-id] [detail]
Context
show>qos
Platforms
Supported on all 7210 SAS platforms as described in this document
Description
This command displays the accounting status of a network QoS policy along with other details of the policy. When frame-based-accounting is enabled accounting is shown as frame-based otherwise packet-based.
Parameters
- policy-id
Displays information about the specific policy ID.
- detail
Displays the detail policy information.
Output
The following output is an example of QoS network policy information, and Output fields: network describes the output fields.
Sample output*A:dut-a>show>qos# network 1
===============================================================================
QoS Network Policy
===============================================================================
-------------------------------------------------------------------------------
Network Policy (1)
-------------------------------------------------------------------------------
Policy-id : 1
Egr Remark : False Egr Rem Plcy : N/A
Forward Class : be Profile : None
Scope : Template
DOT1P Class Poli*: 1 DSCP Class Polic*: 0
MPLS Lsp Exp Cla*: 0
Description : Default network-port QoS policy.
===============================================================================
* indicates that the corresponding row element may have been truncated.
*A:dut-a>show>qos#
*A:dut-a>show>qos# network 1
===============================================================================
QoS Network Policy
===============================================================================
-------------------------------------------------------------------------------
Network Policy (1)
-------------------------------------------------------------------------------
Policy-id : 1
Egr Remark : False Egr Rem Plcy : N/A
Forward Class : be Profile : None
Scope : Template
DOT1P Class Poli*: 1 DSCP Class Polic*: 0
MPLS Lsp Exp Cla*: 0
Description : Default network-port QoS policy.
===============================================================================
* indicates that the corresponding row element may have been truncated.
*A:dut-a>show>qos#
Label |
Description |
|---|---|
Policy-ID |
Displays the policy identifier |
Profile |
Out — Specifies the dot1p marking for the packets which are out-of-profile, egressing on this queue In — Specifies the dot1p markings for in-profile packets egressing this queue |
Scope |
Exclusive — Implies that this policy can only be applied to a single SAP Template — Implies that this policy can be applied to multiple SAPs on the router |
Description |
A text description of the port |
network-queue
Syntax
network-queue [network-queue-policy-name] [detail]
Context
show>qos
Platforms
Supported on all 7210 SAS platforms as described in this document
Description
This command displays accounting status of a network-queue policy along with other details of the policy. When frame-based-accounting is enabled, accounting is shown as frame-based; otherwise it is shown as packet-based.
Parameters
- network-queue-policy-name
Displays information about the specific Network queue policy.
- detail
Displays the detailed policy information.
Output
The following output is an example of QoS network-queue policy information, and Output fields: network queue describes the output fields.
Sample output*A:Dut-1# show qos network-queue default
===============================================================================
QoS Network Queue Policy
===============================================================================
-------------------------------------------------------------------------------
Network Queue Policy (default)
-------------------------------------------------------------------------------
Policy : default
Accounting : frame-based
Description : Default network queue QoS policy.
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
Port-id : 1/1/6
Port-id : 1/1/7
Port-id : 1/1/8
Port-id : 1/1/9
Port-id : 1/1/10
Port-id : 1/1/11
Port-id : 1/1/12
Port-id : 1/1/13
Port-id : 1/1/14
Port-id : 1/1/15
Port-id : 1/1/16
Port-id : 1/1/17
Port-id : 1/1/18
Port-id : 1/1/20
Port-id : 1/1/21
Port-id : 1/1/22
Port-id : 1/1/23
Port-id : 1/1/24
===============================================================================
*A:Dut-1#
Label |
Description |
|---|---|
Policy |
Displays the policy |
Accounting |
Packet-based — Specifies that the meters associated with this policy do not account for packet framing overheads (such as the Inter Frame Gap (IFG) and the preamble for Ethernet), while accounting for the bandwidth to be used by this flow Frame-based — Specifies that the meters associated with this policy account for the packet framing overheads (such as, for Ethernet, the IFG and preamble), while accounting the bandwidth to be used by the flow |
Description |
A text description of the port |
Port-Id |
Displays the specified port ID |
sap-ingress
Syntax
sap-ingress [policy-id] [association | match-criteria | detail]
Context
show>qos
Platforms
Supported on all 7210 SAS platforms as described in this document
Description
This command displays accounting status of a sap-ingress policy along with other details of the policy. When frame-based-accounting is enabled accounting is shown as frame-based otherwise packet-based.
Parameters
- policy-id
Displays information about the specific policy ID.
- associations
Displays the associations of the sap-ingress policy.
- match-criteria
Displays the match criteria of the sap-ingress policy.
- detail
Displays the detailed information of the sap-ingress policy.
Output
The following output is an example of QoS SAP ingress policy information, and Output fields: SAP-ingress QoS policy describes the output fields.
Sample output*A:dut-a>show>qos# sap-ingress 1
===============================================================================
QoS Sap Ingress
===============================================================================
-------------------------------------------------------------------------------
Sap Ingress Policy (1)
-------------------------------------------------------------------------------
Policy-id : 1 Scope : Template
Default FC : be
Criteria-type : None
Mac Sub-Criteria : None IP Sub-Criteria : None
IPv6 Enabled : False
DOT1P Class Policy Id : 0 DSCP Class Policy Id : 0
MPLS Lsp Exp Class Policy*: 0
Name : default
Description : Default SAP ingress QoS policy.
===============================================================================
* indicates that the corresponding row element may have been truncated.
*A:dut-a>show>qos#
Label |
Description |
|---|---|
Policy-Id |
The ID that uniquely identifies the policy |
Scope |
Exclusive — Implies that this policy can only be applied to a single SAP Template — Implies that this policy can be applied to multiple SAPs on the router |
Default FC |
Specifies the default forwarding class for the policy |
Criteria-type |
IP — Specifies that an IP criteria-based SAP ingress policy is used to select the appropriate ingress meter and corresponding forwarding class for matched traffic MAC — Specifies that a MAC criteria-based SAP is used to select the appropriate ingress meters and corresponding forwarding class for matched traffic |
MAC Sub-Criteria |
Displays the configured MAC sub-criteria |
IP Sub-Criteria |
Displays the configured IP sub-criteria |
Description |
A text string that helps identify the policy’s context in the configuration file |