Release 15.4SY Supervisor Engine 2T Software Configuration Guide

Bias-Free Language

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.

Book Contents

Find Matches in This Book

Results

Updated:: August 14, 2014

Chapter: PFC QoS Statistics Data Export

Prerequisites for PFC QoS Statistics Data Export
Restrictions for PFC QoS Statistics Data Export
Information About PFC QoS Statistics Data Export
Default Settings for PFC QoS Statistics Data Export
How to Configure PFC QoS Statistics Data Export

PFC QoS Statistics Data Export

Note ● For complete syntax and usage information for the commands used in this chapter, see these publications:

http://www.cisco.com/en/US/products/ps11846/prod_command_reference_list.html

Cisco IOS Release 15.4SY supports only Ethernet interfaces. Cisco IOS Release 15.4SY does not support any WAN features or commands.

Tip For additional information about Cisco Catalyst 6500 Series Switches (including configuration examples and troubleshooting information), see the documents listed on this page:

http://www.cisco.com/en/US/products/hw/switches/ps708/tsd_products_support_series_home.html

Participate in the Technical Documentation Ideas forum

Prerequisites for PFC QoS Statistics Data Export

None.

Restrictions for PFC QoS Statistics Data Export

None.

Information About PFC QoS Statistics Data Export

The PFC QoS statistics data export feature generates per-LAN-port and per-aggregate policer utilization information and forwards this information in UDP packets to traffic monitoring, planning, or accounting applications. You can enable PFC QoS statistics data export on a per-LAN-port or on a per-aggregate policer basis. The statistics data generated per port consists of counts of the input and output packets and bytes. The aggregate policer statistics consist of counts of allowed packets and counts of packets exceeding the policed rate.

The PFC QoS statistics data collection occurs periodically at a fixed interval, but you can configure the interval at which the data is exported. PFC QoS statistics collection is enabled by default, and the data export feature is disabled by default for all ports and all configured aggregate policers.

Note The PFC QoS statistics data export feature is completely separate from NetFlow Data Export and does not interact with it.

Default Settings for PFC QoS Statistics Data Export

Feature	Default Value
Global PFC QoS data export	Disabled
Per port PFC QoS data export	Disabled
Per named aggregate policer PFC QoS data export	Disabled
Per class map policer PFC QoS data export	Disabled
PFC QoS data export time interval	300 seconds
Export destination	Not configured
PFC QoS data export field delimiter	Pipe character ( \|)

How to Configure PFC QoS Statistics Data Export

Enabling PFC QoS Statistics Data Export Globally

To enable PFC QoS statistics data export globally, perform this task:

	Command	Purpose
Step 1	Router(config)# platform qos statistics-export	Enables PFC QoS statistics data export globally.
Step 2	Router(config)# end	Exits configuration mode.

This example shows how to enable PFC QoS statistics data export globally and verify the configuration:

Router# configure terminal

Router(config)# platform qos statistics-export

Router(config)# end

% Warning: Export destination not set.

% Use 'platform qos statistics-export destination' command to configure the export destination

Router# show platform qos statistics-export info

QoS Statistics Data Export Status and Configuration information

---------------------------------------------------------------

Export Status : enabled

Export Interval : 300 seconds

Export Delimiter : |

Export Destination : Not configured

Router#

Note You must enable PFC QoS statistics data export globally for other PFC QoS statistics data export configuration to take effect.

Enabling PFC QoS Statistics Data Export for a Port

To enable PFC QoS statistics data export for a port, perform this task:

	Command	Purpose
Step 1	Router(config)# interface type slot/port	Selects the interface to configure.
Step 2	Router(config-if)# platform qos statistics-export	Enables PFC QoS statistics data export for the port.
Step 3	Router(config)# end	Exits configuration mode.

This example shows how to enable PFC QoS statistics data export on GigabitEthernet port 5/24 and verify the configuration:

Router# configure terminal

Router(config)# interface gigabitethernet 5/24

Router(config-if)# platform qos statistics-export

Router(config-if)# end

Router# show platform qos statistics-export info

QoS Statistics Data Export Status and Configuration information

---------------------------------------------------------------

Export Status : enabled

Export Interval : 300 seconds

Export Delimiter : |

Export Destination : Not configured

QoS Statistics Data Export is enabled on following ports:

---------------------------------------------------------

GigabitEthernet5/24

Router#

When enabled on a port, PFC QoS statistics data export contains the following fields, separated by the delimiter character:

Export type (“1” for a port)
Slot/port
Number of ingress packets
Number of ingress bytes
Number of egress packets
Number of egress bytes
Time stamp

Enabling PFC QoS Statistics Data Export for a Named Aggregate Policer

To enable PFC QoS statistics data export for a named aggregate policer, perform this task:

	Command	Purpose
Step 1	Router(config)# platform qos statistics-export aggregate-policer aggregate_policer_name	Enables PFC QoS statistics data export for a named aggregate policer.
Step 2	Router(config)# end	Exits configuration mode.

This example shows how to enable PFC QoS statistics data export for an aggregate policer named aggr1M and verify the configuration:

Router# configure terminal

Router(config)# platform qos statistics-export aggregate-policer aggr1M

Router(config)# end

Router# show platform qos statistics-export info

QoS Statistics Data Export Status and Configuration information

---------------------------------------------------------------

Export Status : enabled

Export Interval : 300 seconds

Export Delimiter : |

Export Destination : Not configured

QoS Statistics Data Export is enabled on following ports:

---------------------------------------------------------

GigabitEthernet5/24

QoS Statistics Data export is enabled on following shared aggregate policers:

-----------------------------------------------------------------------------

aggr1M

Router#

When enabled for a named aggregate policer, PFC QoS statistics data export contains the following fields, separated by the delimiter character:

Export type (“3” for an aggregate policer)
Aggregate policer name
Direction (“in”)
PFC or DFC slot number
Number of in-profile bytes
Number of bytes that exceed the CIR
Number of bytes that exceed the PIR
Time stamp

Enabling PFC QoS Statistics Data Export for a Class Map

To enable PFC QoS statistics data export for a class map, perform this task:

	Command	Purpose
Step 1	Router(config)# platform qos statistics-export class-map classmap_name	Enables PFC QoS statistics data export for a class map.
Step 2	Router(config)# end	Exits configuration mode.

This example shows how to enable PFC QoS statistics data export for a class map named class3 and verify the configuration:

Router# configure terminal

Router(config)# platform qos statistics-export class-map class3

Router(config)# end

Router# show platform qos statistics-export info

QoS Statistics Data Export Status and Configuration information

---------------------------------------------------------------

Export Status : enabled

Export Interval : 300 seconds

Export Delimiter : |

Export Destination : Not configured

QoS Statistics Data Export is enabled on following ports:

---------------------------------------------------------

GigabitEthernet5/24

QoS Statistics Data export is enabled on following shared aggregate policers:

-----------------------------------------------------------------------------

aggr1M

QoS Statistics Data Export is enabled on following class-maps:

---------------------------------------------------------------

class3

Router#

When enabled for a class map, PFC QoS statistics data export contains the following fields, separated by the delimiter character:

For data from a physical port:

– Export type (“4” for a classmap and port)

– Class map name

– Direction (“in”)

– Slot/port

– Number of in-profile bytes

– Number of bytes that exceed the CIR

– Number of bytes that exceed the PIR

– Time stamp

For data from a VLAN interface:

– Export type (“5” for a class map and VLAN)

– Classmap name

– Direction (“in”)

– PFC or DFC slot number

– VLAN ID

– Number of in-profile bytes

– Number of bytes that exceed the CIR

– Number of bytes that exceed the PIR

– Time stamp

For data from a port channel interface:

– Export type (“6” for a class map and port channel)

– Class map name

– Direction (“in”)

– PFC or DFC slot number

– Port channel ID

– Number of in-profile bytes

– Number of bytes that exceed the CIR

– Number of bytes that exceed the PIR

– Time stamp

Setting the PFC QoS Statistics Data Export Time Interval

To set the time interval for the PFC QoS statistics data export, perform this task:

	Command	Purpose
Step 1	Router(config)# platform qos statistics-export interval interval_in_seconds	Sets the time interval for the PFC QoS statistics data export. Note The interval needs to be short enough to avoid counter wraparound with the activity in your configuration, but because exporting PFC QoS statistic creates a significant load on the switch, be careful when decreasing the interval.
Step 2	Router(config)# end	Exits configuration mode.

Command

Purpose

Step 1

Router(config)# platform qos statistics-export interval interval_in_seconds

Sets the time interval for the PFC QoS statistics data export.

Note The interval needs to be short enough to avoid counter wraparound with the activity in your configuration, but because exporting PFC QoS statistic creates a significant load on the switch, be careful when decreasing the interval.

Step 2

Router(config)# end

Exits configuration mode.

This example shows how to set the PFC QoS statistics data export interval and verify the configuration:

Router# configure terminal

Router(config)# platform qos statistics-export interval 250

Router(config)# end

Router# show platform qos statistics-export info

QoS Statistics Data Export Status and Configuration information

---------------------------------------------------------------

Export Status : enabled

Export Interval : 250 seconds

Export Delimiter : |

Export Destination : Not configured

QoS Statistics Data Export is enabled on following ports:

---------------------------------------------------------

GigabitEthernet5/24

QoS Statistics Data export is enabled on following shared aggregate policers:

-----------------------------------------------------------------------------

aggr1M

QoS Statistics Data Export is enabled on following class-maps:

---------------------------------------------------------------

class3

Router#

Configuring PFC QoS Statistics Data Export Destination Host and UDP Port

To configure the PFC QoS statistics data export destination host and UDP port number, perform this task:

	Command	Purpose
Step 1	Router(config)# platform qos statistics-export destination { host_name \| host_ip_address } { port port_number \| syslog [ facility facility_name ] [ severity severity_value ]}	Configures the PFC QoS statistics data export destination host and UDP port number.
Step 2	Router(config)# end	Exits configuration mode.

Note When the PFC QoS data export destination is a syslog server, the exported data is prefaced with a syslog header.

Table 70-1 Supported PFC QoS Data Export Facility Parameter Values
Name	Definition	Name	Definition
kern	kernel messages	cron	cron/at subsystem
user	random user-level messages	local0	reserved for local use
mail	mail system	local1	reserved for local use
daemon	system daemons	local2	reserved for local use
auth	security/authentication messages	local3	reserved for local use
syslog	internal syslogd messages	local4	reserved for local use
lpr	line printer subsytem	local5	reserved for local use
news	netnews subsytem	local6	reserved for local use
uucp	uucp subsystem	local7	reserved for local use

Table 70-2 Supported PFC QoS Data Export Severity Parameter Values
Severity Parameter
Name	Number	Definition
emerg	0	system is unusable
alert	1	action must be taken immediately
crit	2	critical conditions
err	3	error conditions
warning	4	warning conditions
notice	5	normal but significant condition
info	6	informational
debug	7	debug-level messages

This example shows how to configure 172.20.52.3 as the destination host and syslog as the UDP port number and verify the configuration:

Router# configure terminal

Router(config)# platform qos statistics-export destination 172.20.52.3 syslog

Router(config)# end

Router# show platform qos statistics-export info

QoS Statistics Data Export Status and Configuration information

---------------------------------------------------------------

Export Status : enabled

Export Interval : 250 seconds

Export Delimiter : |

Export Destination : 172.20.52.3, UDP port 514 Facility local6, Severity debug

QoS Statistics Data Export is enabled on following ports:

---------------------------------------------------------

GigabitEthernet5/24

QoS Statistics Data export is enabled on following shared aggregate policers:

-----------------------------------------------------------------------------

aggr1M

QoS Statistics Data Export is enabled on following class-maps:

---------------------------------------------------------------

class3

Setting the PFC QoS Statistics Data Export Field Delimiter

To set the PFC QoS statistics data export field delimiter, perform this task:

	Command	Purpose
Step 1	Router(config)# platform qos statistics-export delimiter delimiter_character	Sets the PFC QoS statistics data export field delimiter.
Step 2	Router(config)# end	Exits configuration mode.

This example shows how to set the PFC QoS statistics data export field delimiter and verify the configuration:

Router# configure terminal

Router(config)# platform qos statistics-export delimiter,

Router(config)# end

Router# show platform qos statistics-export info

QoS Statistics Data Export Status and Configuration information

---------------------------------------------------------------

Export Status : enabled

Export Interval : 250 seconds

Export Delimiter :,

Export Destination : 172.20.52.3, UDP port 514 Facility local6, Severity debug

QoS Statistics Data Export is enabled on following ports:

---------------------------------------------------------

GigabitEthernet5/24

QoS Statistics Data export is enabled on following shared aggregate policers:

-----------------------------------------------------------------------------

aggr1M

QoS Statistics Data Export is enabled on following class-maps:

---------------------------------------------------------------

class3

Tip For additional information about Cisco Catalyst 6500 Series Switches (including configuration examples and troubleshooting information), see the documents listed on this page:

http://www.cisco.com/en/US/products/hw/switches/ps708/tsd_products_support_series_home.html

Participate in the Technical Documentation Ideas forum

Was this Document Helpful?

Feedback

Contact Cisco

Open a Support Case
(Requires a Cisco Service Contract)