The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
The QoS: Packet Matching Statistics feature allows you to define a quality of service (QoS) packet filter, then display the number of packets and bytes matching that filter.
Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the "Feature Information for QoS: Packet Matching Statistics" section.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
•Prerequisites for QoS: Packet Matching Statistics
•Restrictions for QoS: Packet Matching Statistics
•Information About QoS: Packet Matching Statistics
•How to Use QoS: Packet Matching Statistics
•Configuration Examples for QoS: Packet Matching Statistics
•Feature Information for QoS: Packet Matching Statistics
You cannot enable or disable the QoS: Packet Matching Statistics feature if a policy map is associated with any interface on the system.
Enabling the Qos: Packet Matching Statistics feature may increase CPU utilization on a scaled configuration. Before enabling the Qos: Packet Matching Statistics feature, weigh the benefits of the statistics information against the increased CPU utilization for your system.
The QoS: Packet Matching Statistics feature allows you to define a QoS packet filter, then display the number of packets and bytes matching that filter.
To define a filter, use the class-map command with the match-any keyword, for example:
class-map match-any my_class match ip precedence 4 <-------- User-defined filter match qos-group 10 <-------- User-defined filter
Using this information you can do the following:
•Compare the amount of voice traffic to data traffic on a segment of your network
•Adjust bandwidth availability
•Accurately determine billing
•Troubleshoot service problems
The system collects packet matching statistics on a 10-second cycle. If there are many interfaces or sessions then the system collects statistics for about 8000 of them during each cycle. In a scaled configuration several 10-second cycles may be required to gather all statistics.
Before enabling the QoS: Packet Matching Statistics feature, ensure no policy maps are associated with interfaces on the system. If there are, the system returns the following message:
Either a) A system RELOAD or
b) Remove all service-policies, re-apply the change
to the statistics, re-apply all service-policies
is required before this command will be activated.
Before enabling the QoS: Packet Matching Statistics feature, ensure you have defined a filter is using class-map command with the match-any keyword.
Enabling the Qos: Packet Matching Statistics feature may increase CPU utilization on a scaled configuration. Before enabling the Qos: Packet Matching Statistics feature, weigh the benefits of the statistics information against the increased CPU utilization for your system.
1. enable
2. configure terminal
3. platform qos match-statistics per-filter
4. end
5. show policy-map interface interface-name [vc [vpi/] vci] [dlci dlci] [input | output]
6. configure terminal
7. no platform qos match-statistics per-filter
8. end
Use the show policy-map interface command to display the packet statistics of all classes that are configured for all service policies either on the specified interface or subinterface or on a specific PVC on the interface:
Router# show policy-map interface gig1/1/0
GigabitEthernet1/1/0
Service-policy input: pol1 ! target = gig1/1/0,input
Class-map: class1 (match-any)
1000 packets, 40000 bytes
5 minute offered rate 0000 bps, drop rate 0000 bps
Match: ip precedence 1 <-------- User-defined filter
800 packets, 32000 bytes <-------- Filter matching results
Match: ip precedence 2 <-------- User-defined filter
200 packets, 8000 bytes <-------- Filter matching results
QoS Set
ip precedence 7
No packet marking statistics available
Class-map: class-default (match-any)
500 packets, 20000 bytes
5 minute offered rate 0000 bps, drop rate 0000 bps
Match: any <-------- User-defined filter
500 packets, 20000 bytes <-------- Filter matching results
To confirm that the QoS: Packet Matching Statistics feature is enabled, use the show platform hardware qfp active feature qos config global command. If the feature is disabled, you should see a message similar to the following:
Router#
show platform hardware qfp active feature qos config global
Marker statistics are: enabled
Match per filter statistics are: enabled
This example shows how to do the following:
•Define a QoS packet matching filter
•Display the show policy-map interface command output
Router# show policy-map interface Tunnel1
Service-policy output: DATA-OUT-PARENT
Class-map: class-default (match-any)
4469 packets, 4495814 bytes
5 minute offered rate 0000 bps, drop rate 0000 bps
Match: any <-------- User-defined filter
Queueing
queue limit 416 packets
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 4469/4558380
shape (average) cir 100000000, bc 400000, be 400000
target shape rate 100000000
Service-policy : DATA-OUT
queue stats for all priority classes:
Queueing
queue limit 200 packets
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 4469/4558380
Class-map: ATM-VTI-RIP-SPK1-DATA (match-any)
4469 packets, 4495814 bytes <-------- Filter matching results
5 minute offered rate 0000 bps, drop rate 0000 bps
Match: access-group 121 <-------- User-defined filter
4469 packets, 4495814 bytes <-------- Filter matching results
5 minute rate 0 bps
QoS Set
ip precedence 3
Packets marked 4469
Priority: 100 kbps, burst bytes 2500, b/w exceed drops: 0
|
|
---|---|
Cisco IOS commands |
|
Quality of service commands |
Cisco IOS Quality of Service Command Reference |
|
|
---|---|
No new or modified standards are supported, and support for existing standards has not been modified. |
— |
|
|
---|---|
CISCO-CLASS-BASED-QOS-MIB |
To locate and download MIBs for selected platforms, Cisco software releases, and feature sets, use Cisco MIB Locator found at the following URL: |
|
|
---|---|
No new or modified RFCs are supported, and support for existing RFCs has not been modified. |
— |
Table 1 lists the features in this module and provides links to specific configuration information.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note Table 1 lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.
|
|
|
---|---|---|
QoS: Packet Matching Statistics |
Cisco IOS XE Release 3.3S |
The QoS: Packet Matching Statistics feature allows you to display the number of packets that have: •Modified headers •Been classified into a category for local router processing The following sections provide information about this feature: •Information About QoS: Packet Matching Statistics •How to Use QoS: Packet Matching Statistics The following commands were introduced or modified: platform qos match-statistics per-filter, no platform qos match-statistics per-filter, and show platform hardware qfp active feature qos config global. |