QoS Modular QoS Command-Line Interface Configuration Guide Cisco IOS XE Release 3S
QoS Packet Matching Statistics
Download this chapter
QoS Packet Matching StatisticsQoS Packet Matching Statistics
Download the complete book
QoS Modular QoS Command-Line Interface Configuration Guide Cisco IOS XE Release 3S QoS Modular QoS Command-Line Interface Configuration Guide Cisco IOS XE Release 3S (PDF - 3 MB)
 Feedback

QoS Packet Matching Statistics

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.

Finding Feature Information

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 Table at the end of this document.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/​go/​cfn. An account on Cisco.com is not required.

Prerequisites 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.

Restrictions for QoS Packet Matching Statistics

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.

Information About QoS Packet Matching Statistics

QoS Packet Matching Statistics Feature Overview

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.

How to Use QoS Packet Matching Statistics

Configuring QoS Packet Matching Statistics

Before You Begin

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.


Note

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.

>
SUMMARY STEPS

    1.    enable

    2.    configure terminal

    3.    platform qos match-statistics per-filter

    4.    end

    5.    show policy-map interface interface-name

    6.    configure terminal

    7.    no platform qos match-statistics per-filter

    8.    end


DETAILED STEPS
     Command or ActionPurpose
    Step 1 enable


    Example:
    Router> enable
     

    Enables privileged EXEC mode.

    • Enter your password if prompted.
     
    Step 2 configure terminal


    Example:
    Router# configure terminal
     

    Enters global configuration mode.

     
    Step 3 platform qos match-statistics per-filter


    Example:
    Router(config)# platform qos match-statistics per-filter
     

    Enables the QoS: Packet Matching Statistics feature.

     
    Step 4 end


    Example:
    Router# end
     

    Exits configuration mode.

     
    Step 5 show policy-map interface interface-name


    Example:
    [vc [vpi /] vci] [dlci dlci] [input | output]


    Example:
    Router# show policy-map interface serial4/0/0
     

    Displays the packet statistics of all classes that are configured for all service policies either on the specified interface or subinterface or on a specific permanent virtual circuit (PVC) on the interface.

     
    Step 6 configure terminal


    Example:
    Router# configure terminal
     

    Enters global configuration mode.

     
    Step 7 no platform qos match-statistics per-filter

    Example:
    Router(config)# no platform qos match-statistics per-filter
     

    Disables the QoS: Packet Matching Statistics feature.

     
    Step 8 end


    Example:
    Router# end
     

    Exits configuration mode.

     

    Example

    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

    Troubleshooting Tips

    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

    Configuration Examples for QoS Packet Matching Statistics

    Example Configuring a QoS Packet Matching Filter

    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

    Additional References

    Related Documents

    Related Topic

    Document Title

    Cisco IOS commands

    Cisco IOS Master Commands List, All Releases

    Quality of service commands

    Cisco IOS Quality of Service Command Reference

    Standards

    Standard

    Title

    No new or modified standards are supported, and support for existing standards has not been modified.

    --

    MIBs

    MIB

    MIBs Link

    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:

    http:/​/​www.cisco.com/​go/​mibs

    RFCs

    RFC

    Title

    No new or modified RFCs are supported, and support for existing RFCs has not been modified.

    --

    Technical Assistance

    Description

    Link

    The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password.

    http:/​/​www.cisco.com/​cisco/​web/​support/​index.html

    Feature Information for QoS Packet Matching Statistics

    The following table provides release information about the feature or features described in this module. This table 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.

    Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/​go/​cfn. An account on Cisco.com is not required.

    Table 1 Feature Information for QoS: Packet Matching Statistics

    Feature Name

    Releases

    Feature Information

    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 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.