13-3. QoS Data Export QoS statistics data can be gathered from sources within a switch and sent to a data collection device. QoS data export is limited to the Catalyst 6000 family. Statistics data is exported using a specific UDP port or a syslog facility. The sources of QoS data can be one of the following. The data fields shown are separated by a delimiter character when data is exported: - - Switch port Data export type 1, slot/port, number of ingress packets, ingress bytes, egress packets, egress bytes, and a time stamp.
- - Aggregate policer Data export type 3, policer name, number of in-profile packets, out-of-profile packets exceeding the CIR, out-of-profile packets exceeding the PIR, and a time stamp.
- - QoS policy class map Data export type 4, class map name, port, VLAN, or port-channel number, number of in-profile packets, out-of-profile packets exceeding the CIR, out-of-profile packets exceeding the PIR, and a time stamp.
Configuration 1. | Specify how to send QoS statistics.
- a. Select a destination for statistic collection:
COS | [View full width] set qos statistics export destination host [{port | syslog [facility-name severity]}] | IOS | [View full width] (global) mls qos statistics-export destination {host-name | host-ip-address} [{port port-number | syslog [facility facility-name] [severity severity]}] |
By default, no statistics are sent to the destination. Statistics can be sent to the destination host (either IP address or host name) using a specific UDP port or through syslog (UDP port 514). If the syslog keyword is used, the syslog facility-name can be given as kern, user, mail, daemon, auth, lpr, news, uucp, cron, local0, local1, local2, local3, local4, local5, local6 (the default), or local7. The syslog severity is one of emerg, alert, crit, err, warning, notice, info, or debug (the default). See section "12-1: Logging" for more information about syslog.
- b. (Optional) Set the data export interval:
COS | set qos statistics export interval interval | IOS | (global) mls qos statistics-export interval interval |
QoS statistics are sent to the destination every interval seconds (30 to 65,535 seconds; COS default 30 seconds, IOS default 300 seconds).
TIP Be careful when choosing an interval value. If the time is too long, the QoS statistics counters could reach their maximum values and wrap back to 0. If the time chosen is too short, the switch CPU load increases significantly. Begin with the default and make adjustments, taking notice of the effects on both CPU and counters. - c. (Optional; IOS only) Set the statistics delimiter:
COS | N/A | IOS | (global) mls qos statistics-export delimiter character |
QoS statistics can be separated by a specific character (default pipe or |) if desired.
| 2. | Enable data gathering on the switch:
COS | set qos statistics export {enable | disable} | IOS | (global) mls qos statistics-export |
By default, no QoS statistics are gathered or exported.
| 3. | Gather QoS statistics from one or more sources.
- a. (Optional) Select a switch port:
COS | [View full width] set qos statistics export port mod/port {enable | disable} | IOS | (interface) mls qos statistics-export |
- b. (Optional) Select an aggregate policer:
COS | [View full width] set qos statistics export aggregate policer-name {enable | disable} | IOS | [View full width] (global) mls qos statistics-export aggregate-policer policer-name |
QoS statistics are gathered from the aggregate policer named policer-name (text string). The policer must be configured as described in section "13-2: QoS Configuration."
- c. (Optional; IOS only) Select a QoS class map:
COS | N/A | IOS | [View full width] (global) mls qos statistics-export class-map classmap-name |
You can gather statistics about a specific portion of a more complex QoS policy if needed. Statistics are gathered from the QoS class map named classmap-name (text string). The class map must be configured as described in section "13-2: QoS Configuration."
| QoS Data Export Example QoS statistics are gathered on a switch and are sent to a collection host at 192.168.111.14 using the local6 syslog facility and debug severity (the defaults). Data is collected and sent every 300 seconds. Statistics are gathered only for ports 3/1, 3/2, and the aggregate policer named MyPolicer: COS | [View full width] set qos statistics export destination 192.168.111 .14 syslog set qos statistics export interval 300 set qos statistics export enable set qos statistics export port 3/1-2 enable set qos statistics export aggregate MyPolicer enable | IOS | [View full width] (global) mls qos statistics-export destination 192.168.111.14 syslog (global) mls qos statistics-export interval 300 (global) mls qos statistics-export (global) interface gig 3/1 (interface) mls qos statistics-export (global) interface gig 3/2 (interface) mls qos statistics-export (global) mls qos statistics-export aggregate-policer MyPolicer |
Displaying Information About QoS Data Export You can use the following switch commands to display QoS statistic sources: COS | show qos statistics export info | IOS | (exec) show mls qos statistics-export info |
|