![]() |
Cisco IOS Media Monitoring Command Reference
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cisco Performance Monitor
![]() |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Contents
Cisco Performance Monitor action (policy-react and policy-inline-react)To configure which applications which will receive an alarm or notification, use the actioncommand in policy react configuration mode and policy inline react configuration mode. To disable the sending alarms or notifications, use the no form of this command. Command Modes
Usage GuidelinesYou can configure multiple action commands to allow more than one recipients to receive an alarm or notification. ExamplesThe following example shows how to specify that SNMP MIB variables will receive an alarm or notification, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# react 2000 rtp-jitter-average Router(config-pmap-c-react)# action snmp The following example shows how to specify that SNMP MIB variables will receive an alarm or notification, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# react 2000 rtp-jitter-average Router(config-spolicy-inline-react)# action snmp alarm severity (policy-react and policy-inline-react)To configure the severity of alarms sent for a Performance Monitor policy, use the alarm severitycommand in policy react configuration mode and policy inline react configuration mode. To return to the default and send all alarms, use the no form of this command.
alarm
severity
{alert | critical | emergency | error | info}
no
alarm
severity
{alert | critical | emergency | error | info}
Command Modes
Usage GuidelinesThe definition of the alarms types are listed below in order of severity:
ExamplesThe following example shows how to specify that only emergency alarms will be sent, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# react 2000 rtp-jitter-average Router(config-pmap-c-react)# alarm severity emergency The following example shows how to specify that only emergency alarms will be sent, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# react 2000 rtp-jitter-average Router(config-spolicy-inline-react)# alarm severity emergency alarm type (policy-react and policy-inline-react)To configure the types of alarms sent for a Performance Monitor policy, use the alarm typecommand in policy react configuration mode and policy inline react configuration mode. To return to the default and send all alarms, use the no form of this command.
alarm type
{discrete | grouped {count number | percent number}}
no alarm type
{discrete | grouped {count number | percent number}}
Command Modes
Usage GuidelinesThe monitored event is specified by the react command. You can group alarms by whether they exceed a specified percentage or count. ExamplesThe following example shows how to specify that only percentage type alarms will be sent, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# react 2000 rtp-jitter-average Router(config-pmap-c-react)# alarm type percent 80 The following example shows how to specify that only percentage type alarms will be sent, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# react 2000 rtp-jitter-average Router(config-spolicy-inline-react)# alarm type percent 80 class-mapTo create a class map to be used for matching packets to a specified class, use the class-mapcommand in global configuration mode. To remove an existing class map from the router, use the no form of this command. The class-map command enters class-map configuration mode in which you can enter one of the match commands to configure the match criteria for this class. Cisco 2600, 3660, 3845, 6500, 7200, 7401, and 7500 Series Routers
class-map
[type {stack | access-control | port-filter | queue-threshold | logging log-class}]
[match-all | match-any]
class-map-name
no
class-map
[type {stack | access-control | port-filter | queue-threshold | logging log-class}]
[match-all | match-any]
class-map-name
Cisco 7600 Series Routers
class-map
class-map-name
[match-all | match-any]
no
class-map
class-map-name
[match-all | match-any]
Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE
class-map
class-map-name
no
class-map
class-map-name
Syntax DescriptionCommand History
Usage GuidelinesCisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE Only the class-map-name argument is available. Cisco 2600, 3660, 3845, 6500, 7200, 7401, 7500, and ASR 1000 Series Routers Use the class-mapcommand to specify the class that you will create or modify to meet the class-map match criteria. This command enters class-map configuration mode in which you can enter one of the match commands to configure the match criteria for this class. Packets that arrive at either the input interface or the output interface (determined by how the service-policycommand is configured) are checked against the match criteria configured for a class map to determine if the packets belong to that class. When configuring a class map, you can use one or more match commands to specify match criteria. For example, you can use the matchaccess-group command, the matchprotocol command, or thematchinput-interface command. The match commands vary according to the Cisco IOS release. For more information about match criteria and match commands, see the "Modular Quality of Service Command-Line Interface (CLI) (MQC)" chapter of the Cisco IOS Quality of Service Solutions Configuration Guide . Cisco 7600 Series Routers You apply the class-map command and its commands on a per-interface basis to define packet classification, marking, aggregate, and flow policing as part of a globally named service policy. You can attach a service policy to an EtherChannel. Do not attach a service policy to a port that is a member of an EtherChannel. After the router is in class-map configuration mode, the following configuration commands are available:
The following commands appear in the CLI help but are not supported on LAN interfaces or WAN interfaces on the Optical Service Modules (OSMs):
OSMs are not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 32. Policy Feature Card (PFC) QoS does not support the following commands:
If you enter these commands, PFC QoS does not detect the unsupported keywords until you attach a policy map to an interface. When you try to attach the policy map to an interface, you get an error message. For additional information, see the Cisco 7600 Series Router Cisco IOS Software Configuration Guide and the Cisco IOS command references. After you have configured the class-map name and are in class-map configuration mode, you can enter the matchaccess-groupand matchipdscp commands. The syntax for these commands is as follows: match [[access-group {acl-index | acl-name}] | [ipdscp | precedence} value]] See the table below for a syntax description of the match commands.
ExamplesThe following example specifies class101 as the name of a class, and it defines a class map for this class. The class named class101 specifies policy for traffic that matches access control list 101. Router(config)# class-map class101 Router(config-cmap)# match access-group 101 The following example shows how to define FPM traffic classes for slammer and UDP packets. The match criteria defined within the class maps are for slammer and UDP packets with an IP length not to exceed 404 bytes, UDP port 1434, and pattern 0x4011010 at 224 bytes from the start of the IP header. Router(config)# load protocol disk2:ip.phdf Router(config)# load protocol disk2:udp.phdf Router(config)# class-map type stack match-all ip-udp Router(config-cmap)# description "match UDP over IP packets" Router(config-cmap)# match field ip protocol eq 0x11 next udp Router(config)# class-map type access-control match-all slammer Router(config-cmap)# description "match on slammer packets" Router(config-cmap)# match field udp dest-port eq 0x59A Router(config-cmap)# match field ip length eq 0x194 Router(config-cmap)# match start 13-start offset 224 size 4 eq 0x 4011010 The following example shows how to configure a port-filter policy to drop all traffic that is destined to closed or "nonlistened" ports except SNMP. Router(config)# class-map type port-filter pf-class Router(config-cmap)# match not port udp 123 Router(config-cmap)# match closed-ports Router(config-cmap)# exit Router(config)# policy-map type port-filter pf-policy Router(config-pmap)# class pf-class Router(config-pmap-c)# drop Router(config-pmap-c)# end The following example shows how to configure a class map named ipp5, and enter a match statement for IPprecedence5: Router(config)# class-map ipp5 Router(config-cmap)# match ip precedence 5 Example of the class-map Command for Setting Up a Class Map Inside an 802.1p Domain in Cisco IOS Release 12.2(33)SCFThe following example shows how to set up a class map and match traffic classes for the 802.1p domain with packet CoS values: Router> enable Router# configure terminal Router(config)# class-map cos1 Router(config-cmap)# match cos 0 Router(config-pmap-c)# end Example of the class-map Command for Setting Up a Class Map Inside an MPLS Domain in Cisco IOS Release 12.2(33)SCFThe following example shows how to set up a class map and match traffic classes for the MPLS domain with packet EXP values: Router> enable Router# configure terminal Router(config)# class-map exp7 Router(config-cmap)# match mpls experimental topmost 2 Router(config-pmap-c)# end Related Commands
clear fm performance-monitor countersTo clear counters for the Performance Monitor component of Feature Monitor, use the clear fm performance-monitor counterscommand in privileged EXEC mode. ExamplesThe following example shows the how to clear counters for the Performance Monitor component of Feature Monitor:
Router# clear fm performance-monitor counters
Related Commands
clock-rate (policy RTP)To configure the rate for the RTP packet time-stamp clock, use the clock-ratecommand in policy RTP configuration mode. To remove the configuration, use the no form of this command. Syntax Description
Command Modes
Usage GuidelinesFor more information about how the clock rate for RTP packet time-stamp clock is used to calculate the packet arrival latency, see RFC 3550, RTP, A Transport Protocol for Real-Time Applications . The clock rate has to be synchronized with the routers along the path of the flow. Because the clock rate can vary depending on the payload codec type, a keyword is provided to set the expected clock rate. The available values for type-name and type-numberare celb (25), cn (13), dvi4 (5) (8000 Hz as described in RFC 3551, RTP Profile for Audio and Video Conferences with Minimal Control ), dvi4-2 (6) (8000 Hz as described in RFC 3551), dvi4-3 (16) (DVI4 Dipol 11025 Hz), dvi4-4 (17) DVI4 Dipol 22050 Hz), g722 (9), g723 (4), g728 (15), g729 (18), gsm (3), h261 (31), h263 (34), jpeg (26), l16 (11) (L16 channel 1), l16-2 (10) (L16 channel 2), lpc (7), mp2t (33), mpa (14), mpv (32), nv (28), pcma (8), pcmu (0), qcelp (12). ExamplesThe following example shows how to set the rate for the RTP packet time-stamp clock,while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# monitor metric rtp Router(config-pmap-c-mrtp)# clock-rate 8 9600 The following example shows how to set the rate for the RTP packet time-stamp clock, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# monitor metric rtp Router(config-spolicy-inline-mrtp)# clock-rate 8 9600 collect application descriptionTo configure one or more of the application description field as a nonkey field for a flow record, use the collect application description command in flow record configuration mode. To disable the use the application fields as a key field for a flow record, use the no form of this command. Usage GuidelinesThe collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect application mediaTo configure one of the application media fields as a nonkey field for a flow record, use the collect application media command in flow record configuration mode. To disable the use of one of the application media field as a nonkey field for a flow record, use the no form of this command.
collect
application
media
{bytes {rate | counter [long] } | packets {rate [variation] | counter [long] } | events}
no
collect
application
media
{bytes | packets | events}
Syntax Description
Command DefaultThe application media field is not configured as a nonkey field for a user-defined flow record. Usage GuidelinesThe collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect application nameTo configure the use of the application name as a nonkey field for a flow record, use the collect application name command in flow record configuration mode. To disable the use of the application name as a nonkey field for a flow record, use the no form of this command. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the application name as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect application name Cisco Performance Monitor in Cisco IOS Release 15.2(2)T and XE 3.5SThe following example configures the application name as a nonkey field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# collect application name Related Commands
collect application vendorTo configure one or more of the application vendor field as a nonkey field for a flow record, use the collect application vendor command in flow record configuration mode. To disable the use the application fields as a key field for a flow record, use the no form of this command. Usage GuidelinesThe collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect application versionTo configure one or more of the application version field as a nonkey field for a flow record, use the collect application version command in flow record configuration mode. To disable the use the application fields as a key field for a flow record, use the no form of this command. Usage GuidelinesThe Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect connectionTo configure various connection information fields as a nonkey field for a flow record, use the collect connection command in flow record configuration mode. To disable the use of the connection information fields as a nonkey field for a flow record, use the no form of this command.
collect
connection
{initiator | new-translations | sum-duration}
no
collect
connection
{initiator | new-translations | sum-duration}
Syntax Description
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The initiator keyword provides the following information about the direction of the flow.
For the new-translations and sum-duration keywords, the observation period can be specified by the start and end timestamps for the flow. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. ExamplesThe following example configures information about the direction of the flow as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect connections initiator collect counterTo configure the number of bytes or packets in a flow as a nonkey field for a Flexible NetFlow flow record, use the collect counter command in Flexible NetFlow flow record configuration mode. To disable the use of the number of bytes or packets in a flow (counters) as a nonkey field for a Flexible NetFlow flow record, use the no form of this command.
collect
counter
{bytes [long | replicated [long] | squared long] | packets [long | replicated [long] ]}
no
collect
counter
{bytes [long | replicated [long] | squared long] | packets [long | replicated [long] ]}
Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE
collect
counter
{bytes [long | rate] | packets [dropped [long] | long]}
no
collect
counter
{bytes [long | rate] | packets [dropped [long] | long]}
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode. For Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. Here we refer to them both as flow record configuration mode. The Flexible NetFlow and Performance Monitor collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE The rate and droppedkeywords were added and the replicated and squared longkeywords are not available. You must first enter the flow record type performance-monitor command. collect counter bytes This command configures a 32-bit counter for the number of bytes seen in a flow. collect counter packets This command configures a 32-bit counter that is incremented for each packet seen in the flow. For extremely long flows it is possible for this counter to restart at 0 (wrap) when it reaches the limit of approximately 4 billion packets. On detection of a situation that would cause this counter to restart at 0, a flow monitor with a normal cache type exports the flow and starts a new flow. collect counter packets long This command configures a 64-bit counter that will be incremented for each packet seen in the flow. It is unlikely that a 64-bit counter will ever restart at 0. collect counter bytes squared long This counter can be used in conjunction with the byte and packet counters in order to calculate the variance of the packet sizes. Its value is derived from squaring each of the packet sizes in the flow and adding the results. This value can be used as part of a standard variance function. The variance and standard deviation of the packet sizes for the flow can be calculated with the following formulas: cbs: value from the counter bytes squared field pkts: value from the counter packets field bytes: value from the counter bytes field Variance = (cbs/pkts) - (bytes/pkts)2 Standard deviation = square root of Variance Example 1: Packet sizes of the flow: 100, 100, 100, 100 Counter packets: 4 Counter bytes: 400, mean packet size = 100 Counter bytes squared: 40,000 Variance = (40,000/4) - (400/4)2 = 0 Standard Deviation = 0 Size = 100 +/- 0 Example 2: Packet sizes of the flow: 50, 150, 50, 150 Counter packets: 4 Counter bytes: 400, mean packet size = 100 Counter bytes squared: 50,000 Variance = (50,000/4) - (400/4)2 = 2500 Standard deviation = 50 Size = 100 +/- 50 ExamplesThe following example configures the total number of bytes in the flows as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect counter bytes The following example configures the total number of bytes in the flows as a nonkey field using a 64-bit counter: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect counter bytes long The following example configures the sum of the number of bytes of each packet in the flow squared as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect counter bytes squared long The following example configures the total number of packets from the flows as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect counter packets The following example configures the total number of packets from the flows as a nonkey field using a 64-bit counter: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect counter packets long Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example configuresthe total number of packets from the flows as a nonkey field using a 64-bit counter: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# collect counter packets long collect datalink macTo configure the use of MAC addresses as a nonkey field for a Flexible NetFlow flow record, use the collectdatalinkmac command in Flexible NetFlow flow record configuration mode. To disable the use of Layer 2 MAC addresses as a non-key field for a Flexible NetFlow flow record, use the no form of this command.
collect datalink mac
{destination | source}
address
{input | output}
no collect datalink mac
{destination | source}
address
{input | output}
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitorcommand before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. The input and output keywords of the collectdatalinkmac command are used to specify the observation point that is used by the collectdatalinkmac command to capture the MAC addressees from network traffic. For example, when you configure a flow record with the collectdatalinkmacdestinationaddressinputcommand to monitor the simulated denial of service (DoS) attack in the figure below and apply the flow monitor to which the flow record is assigned in either input (ingress) mode on interface Ethernet 0/0.1 on R3 or output (egress) mode on interface Ethernet 1/0.1 on R3, the observation point is always Ethernet 0/0.1 on R3. The destination MAC address that is collected is aaaa.bbbb.cc04. When the destination output mac address is configured, the value is the destination mac address of the output packet, even if the monitor the flow record is applied to is input only. When the destination input mac address is configured, the value is the destination mac address of the input packet, even if the monitor the flow record is applied to is output only. When the source output mac address is configured, the value is the source mac address of the output packet, even if the monitor the flow record is applied to is input only. When the source input mac address is configured, the value is the source mac address of the input packet, even if the monitor the flow record is applied to is output only. ExamplesThe following example configures the use of the destination MAC address of packets that are received by the router as a nonkey field for a Flexible NetFlow flow record: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect datalink mac destination address input The following example configures the use of the source MAC addresses of packets that are transmitted by the router as a nonkey field for a Flexible NetFlow flow record: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect datalink mac source address output Cisco Performance Monitor in Cisco IOS Release 15.2(2)TThe following example configures the use of the source MAC addresses of packets that are transmitted by the router as a nonkey field for a Performance Monitor flow record: : Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# collect datalink mac source address output collect flowTo configure the flow direction, the flow sampler ID number, or reason why the flow ended as a nonkey field for a flow record, use the collect flow command in flow record configuration mode. To disable the use of the flow direction and the flow sampler ID number as a nonkey field for a flow record, use the no form of this command.
collect
flow
{direction | sampler}
no
collect
flow
{direction | sampler}
Cisco IOS Release 15.1(4)M1
collect
flow
direction
no
collect
flow
direction
Command DefaultThe flow direction and the flow sampler ID number are not configured as nonkey fields. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode. For Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. Here we refer to them both as flow record configuration mode. The Flexible NetFlow and Performance Monitor collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect flow direction This field indicates the direction of the flow. This is of most use when a single flow monitor is configured for input and output flows. It can be used to find and eliminate flows that are being monitored twice, once on input and once on output. This field may also be used to match up pairs of flows in the exported data when the two flows are flowing in opposite directions. collect flow sampler This field contains the ID of the flow sampler used to monitor the flow. This is useful when more than one flow sampler is being used with different sampling rates. The flow exporter option sampler-table command exports options records with mappings of the flow sampler ID to sampling rate so the collector can calculate the scaled counters for each flow. ExamplesThe following example configures the ID of the flow sampler that is assigned to the flow as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect flow sampler collect interfaceTo configure the input and output interface as a nonkey field for a flow record, use the collect interface command in flow record configuration mode. To disable the use of the input and output interface as a nonkey field for a flow record, use the no form of this command. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode. For Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. Here we refer to them both as flow record configuration mode. The Flexible NetFlow and Performance Monitor collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the flow record type performance-monitor command. ExamplesThe following example configures the input interface as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect interface input The following example configures the output interface as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect interface output collect ipv4To configure one or more of the IPv4 fields as a nonkey field for a flow record, use the collect ipv4 command in flow record configuration mode. To disable the use of one or more of the IPv4 fields as a nonkey field for a flow record, use the no form of this command.
collect
ipv4
{dscp | header-length | id | option map | precedence | protocol | tos | version}
no
collect
ipv4
{dscp | header-length | id | option map | precedence | protocol | tos | version}
Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE
collect
ipv4
dscp
no
collect
ipv4
dscp
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode. For Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. Here we refer to them both as flow record configuration mode. The Flexible NetFlow and Performance Monitor collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow.
Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE Only the the dscp keyword is available. You must first enter the flow record type performance-monitor command. ExamplesThe following example configures the DSCP field as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv4 dscp collect ipv4 destinationTo configure the IPv4 destination address as a nonkey field for a flow record, use the collect ipv4 destination command in flow record configuration mode. To disable the use of an IPv4 destination address field as a nonkey field for a flow record, use the no form of this command.
collect
ipv4
destination
{address | {mask | prefix} [minimum-mask mask]}
no
collect
ipv4
destination
{address | {mask | prefix} [minimum-mask mask]}
Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE
collect ipv4 destination mask
[minimum-mask mask]
no collect ipv4 destination mask
[minimum-mask mask]
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode. For Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. Here we refer to them both as flow record configuration mode. The Flexible NetFlow and Performance Monitor collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE Only the maskand minimum-maskkeywords are available. You must first enter the flow record type performance-monitor command. ExamplesThe following example configures the IPv4 destination address prefix from the flows that have a prefix of 16 bits as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv4 destination prefix minimum-mask 16 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example configures the IPv4 destination address prefix from the flows that have a prefix of 16 bits as a nonkey field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# collect ipv4 destination prefix minimum-mask 16 collect ipv4 fragmentationTo configure the IPv4 fragmentation flags and the IPv4 fragmentation offset as a nonkey field for a flow record, use the collect ipv4 fragmentation command in flow record configuration mode. To disable the use of the IPv4 fragmentation flags and the IPv4 fragmentation offset as a nonkey field for a flow record, use the no form of this command. Syntax Description
Command DefaultThe IPv4 fragmentation flags and the IPv4 fragmentation offset are not configured as nonkey fields. Command History
Usage GuidelinesThe Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect ipv4 fragmentation flags This field collects the "don't fragment" and "more fragments" flags. Bit 0: reserved, must be zero. Bit 1: (DF) 0 = May Fragment, 1 = Don't Fragment Bit 2: (MF) 0 = Last Fragment, 1 = More Fragments Bits 3-7: (DC) Don't Care, value is irrelevant
0 1 2 3 4 5 6 7
+---+---+---+---+---+---+---+---+
| | D | M | D | D | D | D | D |
| 0 | F | F | C | C | C | C | C |
+---+---+---+---+---+---+---+---+
For more information on IPv4 fragmentation flags, see RFC 791 Internet Protocol at the following URL: http://www.ietf.org/rfc/rfc791.txt . ExamplesThe following example configures the IPv4 fragmentation flags as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv4 fragmentation flags collect ipv4 sectionTo configure a section of an IPv4 packet as a nonkey field for a flow record, use the collect ipv4 section command in flow record configuration mode. To disable the use of a section of an IPv4 packet as a nonkey field for a flow record, use the no form of this command.
collect
ipv4
section
{header size header-size | payload size payload-size}
no
collect
ipv4
section
{header size header-size | payload size payload-size}
Syntax Description
Command History
Usage GuidelinesThe Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. It is recommended that you configure both header size and payload size so that you know how much data is going to be captured. collect ipv4 section header This command causes the first IPv4 header to be copied into the flow record for this flow. Only the configured size in bytes will be copied and part of the payload will also be captured if the configured size is larger than the size of the header.
collect ipv4 section payload This command results in a copy of the first IPv4 payload being put into the flow record for this flow. Only the configured size in bytes will be copied and may end in a series of 0's if the configured size is greater than the size of the payload.
ExamplesThe following example configures the first eight bytes from the IP header of the packets in the flows as a non-key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv4 section header size 8 The following example configures the first 16 bytes from the payload of the packets in the flows as a non-key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv4 section payload size 16 Cisco Performance Monitor in Cisco IOS Release 15.2(2)T and XE 3.5SThe following example configures the first 16 bytes from the payload of the packets in the flows as a nonkey field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# collect ipv4 section payload size 16 collect ipv4 sourceTo configure the IPv4 source address as a nonkey field for a flow record, use the collect ipv4 source command in flow record configuration mode. To disable the use of the IPv4 source address field as a nonkey field for a flow record, use the no form of this command.
collect
ipv4
source
{address | {mask | prefix} [minimum-mask mask]}
no
collect
ipv4
source
{address | {mask | prefix} [minimum-mask mask]}
Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE
collect ipv4 source mask
[minimum-mask mask]
no collect ipv4 source mask
[minimum-mask mask]
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode. For Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. Here we refer to them both as flow record configuration mode. The Flexible NetFlow and Performance Monitor collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE Only the maskand minimum-maskkeywords are available. You must first enter the flow record type performance-monitor command. collect ipv4 source prefix minimum-mask The source address prefix is the network part of an IPv4 source address. The optional minimum mask allows more information to be gathered about large networks. collect ipv4 source mask minimum-mask The source address mask is the number of bits that make up the network part of the source address. The optional minimum mask allows a minimum value to be configured. This command is useful when there is a minimum mask configured for the source prefix field and the mask is to be used with the prefix. In this case, the values configured for the minimum mask should be the same for the prefix and mask fields. Alternatively, if the collector is aware of the minimum mask configuration of the prefix field, the mask field can be configured without a minimum mask so that the true mask and prefix can be calculated. ExamplesThe following example configures the IPv4 source address prefix from the flows that have a prefix of 16 bits as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv4 source prefix minimum-mask 16 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example configures the IPv4 source address prefix from the flows that have a prefix of 16 bits as a nonkey field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# collect ipv4 source prefix minimum-mask 16 collect ipv4 total-lengthTo configure the IPv4 total-length field as a nonkey field for a flow record, use the collect ipv4 total-length command in flow record configuration mode. To disable the use of the IPv4 total-length field as a nonkey field for a flow record, use the no form of this command. Syntax Description
Command History
Usage GuidelinesThe Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect ipv4 total-length [minimum | maximum] This command is used to collect the lowest and highest IPv4 total length values seen in the lifetime of the flow. Configuring this command results in more processing than is needed to simply collect the first total length value seen using the collect ipv4 total-length command. ExamplesThe following example configures total-length value as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv4 total-length The following example configures minimum total-length value seen in the flows as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv4 total-length minimum collect ipv4 ttlTo configure the IPv4 time-to-live (TTL) field as a nonkey field for a flow record, use the collect ipv4 ttl command in flow record configuration mode. To disable the use of the IPv4 TTL field as a nonkey field for a flow record, use the no form of this command. Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode. For Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. Here we refer to them both as flow record configuration mode. The Flexible NetFlow and Performance Monitor collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the flow record type performance-monitor command. collect ipv4 ttl [minimum | maximum] This command is used to collect the lowest and highest IPv4 TTL values seen in the lifetime of the flow. Configuring this command results in more processing than is needed to simply collect the first TTL value seen using the collect ipv4 ttl command. ExamplesThe following example configures the largest value for IPv4 TTL seen in the flows as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv4 ttl maximum The following example configures the smallest value for IPv4 TTL seen in the flows as a nonkey field Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv4 ttl minimum collect ipv6To configure one or more of the IPv6 fields as a nonkey field for a flow record, use the collect ipv6 command in flow record configuration mode. To disable the use of one or more of the IPv6 fields as a nonkey field for a flow record, use the no form of this command.
collect
ipv6
{dscp | flow-label | next-header | payload-length | precedence | protocol | traffic-class | version}
no
collect
ipv6
{dscp | flow-label | next-header | payload-length | precedence | protocol | traffic-class | version}
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow.
ExamplesThe following example configures the IPv6 DSCP field as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv6 dscp collect ipv6 destinationTo configure the IPv6 destination address as a nonkey field for a flow record, use the collect ipv6 destination command in flow record configuration mode. To disable the use of an IPv6 destination address field as a nonkey field for a flow record, use the no form of this command.
collect
ipv6
destination
{address | {mask | prefix} [minimum-mask mask]}
no
collect
ipv6
destination
{address | {mask | prefix} [minimum-mask mask]}
Command Syntax on Cisco Catalyst 6500 Switches running Cisco IOS Release 12.2(50)SY
collect
ipv6
destination
{mask | prefix}
no
collect
ipv6
destination
{mask | prefix}
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. ExamplesThe following example configures the IPv6 destination address prefix from the flows that have a prefix of 16 bits as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv6 destination prefix minimum-mask 16 Cisco Performance Monitor in Cisco IOS Release 15.2(2)T and XE 3.5SThe following example configures the IPv6 destination address prefix from the flows that have a prefix of 16 bits as a nonkey field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# collect ipv6 destination prefix minimum-mask 16 collect ipv6 extension mapTo configure the bitmap of the IPv6 extension header map as a nonkey field for a flow record, use the collect ipv6 extension map command in flow record configuration mode. To disable the use of the IPv6 bitmap of IPv6 extension header map as a nonkey field for a flow record, use the no form of this command. Command DefaultThe use of the bitmap of the IPv6 extension header map is not configured as a nonkey field. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. Bitmap of the IPv6 Extension Header Map The bitmap of IPv6 extension header map is made up of 32 bits.
0 1 2 3 4 5 6 7
+-----+-----+-----+-----+-----+-----+-----+-----+
| Res | FRA1| RH | FRA0| UNK | Res | HOP | DST |
+-----+-----+-----+-----+-----+-----+-----+-----+
8 9 10 11 12 13 14 15
+-----+-----+-----+-----+-----+-----+-----+-----+
| PAY | AH | ESP | Reserved |
+-----+-----+-----+-----+-----+-----+-----+-----+
16 17 18 19 20 21 22 23
+-----+-----+-----+-----+-----+-----+-----+-----+
| Reserved |
+-----+-----+-----+-----+-----+-----+-----+-----+
24 25 26 27 28 29 30 31
+-----+-----+-----+-----+-----+-----+-----+-----+
| Reserved |
+-----+-----+-----+-----+-----+-----+-----+-----+
0 Res Reserved
1 FRA1 Fragmentation header - not first fragment
2 RH Routing header
3 FRA0 Fragment header - first fragment
4 UNK Unknown Layer 4 header
(compressed, encrypted, not supported)
5 Res Reserved
6 HOP Hop-by-hop option header
7 DST Destination option header
8 PAY Payload compression header
9 AH Authentication Header
10 ESP Encrypted security payload
11 to 31 Reserved
For more information on IPv6 headers, refer to RFC 2460 Internet Protocol, Version 6 (IPv6) at the following URL: http://www.ietf.org/rfc/rfc2460.txt . ExamplesThe following example configures the bitmap of IPv6 extension header map as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv6 extension map collect ipv6 fragmentationTo configure one or more of the IPv6 fragmentation fields as a nonkey field for a flow record, use the collect ipv6 fragmentation command in flow record configuration mode. To disable the use one or more of the IPv6 fragmentation fields as a nonkey field for a flow record, use the no form of this command.
collect
ipv6
fragmentation
{flags | id | offset}
no
collect
ipv6
fragmentation
{flags | id | offset}
Syntax Description
Command DefaultThe use of one or more of the IPv6 fragmentation fields is not configured as a nonkey field. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. ExamplesThe following example configures the IPv6 fragmentation flags field as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv6 fragmentation flags collect ipv6 hop-limitTo configure the IPv6 hop limit as a nonkey field for a flow record, use the collect ipv6 hop-limit command in flow record configuration mode. To disable the use of the IPv6 hop limit field as a nonkey field for a flow record, use the no form of this command. Syntax Description
Command History
Usage Guidelinescollect ipv6 hop-limit [minimum | maximum] This command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. This command is used to collect the lowest and highest IPv6 hop limit values seen in the lifetime of the flow. Configuring this command results in more processing than is needed to simply collect the first hop limit value seen using the collect ipv6 hop-limit command. ExamplesThe following example configures the IPv6 maximum hop limit from the flows as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv6 hop-limit maximum collect ipv6 lengthTo configure one or more of the IPv6 length fields as a nonkey field for a flow record, use the collect ipv6 lengthcommand in flow record configuration mode. To disable the use of one or more of the IPv6 length fields as a nonkey field for a flow record, use the no form of this command.
collect
ipv6
length
{header | payload | total [maximum] [minimum] }
no
collect
ipv6
length
{header | payload | total [maximum] [minimum] }
Syntax Description
Command History
Usage Guidelinescollect ipv6 length [minimum | maximum] This command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. This command is used to collect the lowest and highest IPv6 length values seen in the lifetime of the flow. Configuring this command results in more processing than is needed to simply collect the length value seen using the collect ipv6 length command. ExamplesThe following example configures the length of the IPv6 header, not including any extension headers, in bytes as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv6 length header Cisco Performance Monitor in Cisco IOS Release 15.2(2)T and XE 3.5SThe following example configures the length of the IPv6 header, not including any extension headers, in bytes as a nonkey field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# collect ipv6 length header collect ipv6 sectionTo configure a section of an IPv6 packet as a nonkey field for a flow record, use the collect ipv6 section command in flow record configuration mode. To disable the use of a section of an IPv6 packet as a nonkey field for a flow record, use the no form of this command.
collect
ipv6
section
{header size header-size | payload size payload-size}
no
collect
ipv6
section
{header size header-size | payload size payload-size}
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. It is recommended that you configure both header size and payload size so that you know how much data is going to be captured.
collect ipv6 section header This command causes a copy of the first IPv6 header to be put into the flow record for this flow. Only the configured size in bytes will be copied, and part of the payload will also be captured if the configured size is larger than the size of the header.
collect ipv6 section payload This command causes a copy of the first IPv6 payload to be put into the flow record for this flow. Only the configured size in bytes will be copied, and it may end in a series of zeros if the configured size is smaller than the size of the payload.
ExamplesThe following example configures the first eight bytes from the IPv6 header of the packets in the flows as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv6 section header size 8 The following example configures the first 16 bytes from the payload of the IPv6 packets in the flows as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv6 section payload size 16 Cisco Performance Monitor in Cisco IOS Release 15.2(2)T and XE 3.5SThe following example configures the first 16 bytes from the payload of the IPv6 packets in the flows as a nonkey field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# collect ipv6 section payload size 16 collect ipv6 sourceTo configure the IPv6 source address as a nonkey field for a flow record, use the collect ipv6 source command in flow record configuration mode. To disable the use of the IPv6 source address field as a nonkey field for a flow record, use the no form of this command.
collect
ipv6
source
{address | {mask | prefix} [minimum-mask mask]}
no
collect
ipv6
source
{address | {mask | prefix} [minimum-mask mask]}
Cisco Catalyst 6500 Switches in Cisco IOS Release 12.2(50)SY
collect
ipv6
source
{mask | prefix}
no
collect
ipv6
source
{mask | prefix}
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect IPv6 source prefix minimum mask The source address prefix field is the network part of the source address. The optional minimum mask allows more information to be gathered about large networks. collect IPv6 source mask minimum mask The source address mask is the number of bits that make up the network part of the source address. The optional minimum mask allows a minimum value to be configured. This command is useful when there is a minimum mask configured for the source prefix field and the mask is to be used with the prefix. In this case, the values configured for the minimum mask should be the same for the prefix and mask fields. Alternatively, if the collector is aware of the minimum mask configuration of the prefix field, the mask field can be configured without a minimum mask so that the true mask and prefix can be calculated. ExamplesThe following example configures the IPv6 source address prefix from the flows that have a prefix of 16 bits as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect ipv6 source prefix minimum-mask 16 Cisco Performance Monitor in Cisco IOS Release 15.2(2)T and XE 3.5SThe following example configures the IPv6 source address prefix from the flows that have a prefix of 16 bits as a nonkey field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# collect ipv6 source prefix minimum-mask 16 collect metadataTo configure one or more of the metadata fields as a nonkey field for a flow record, use the collect metadata command in flow record configuration mode. To disable the use the metadata fields as a key field for a flow record, use the no form of this command.
collect
metadata
{global-session-id | multi-party-session-id}
no collect
metadata
{global-session-id | multi-party-session-id}
Syntax Description
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. ExamplesThe following example configures the global session ID of an end-to-end flow as a nonkey field for Flexible Netflow: Router(config)# flow record RECORD-1 Router(config-flow-record)# collect metadata global-session-id Cisco Performance Monitor in Cisco IOS Release 15.2(2)S and 15.2(3)TThe following example configures the global session ID of an end-to-end flow as a nonkey field for Performance Monitor: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# collect metadata global-session-id collect monitor eventTo configure the monitor event field as a nonkey field for a flow record, use the collect monitor event command in flow record configuration mode. To disable the use of a monitor event field as a nonkey field for a flow record, use the no form of this command. Command DefaultThe monitor event field is not configured as a nonkey field for a user-defined flow record. Usage GuidelinesMonitor events are recorded using two bits. Bit 1 is not used. Bit 2 indicates that no media application packets were seen, in other words, a Media Stop Event occured. The collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect routingTo configure one or more of the routing attributes as a nonkey field for a flow record, use the collect routing command in flow record configuration mode. To disable the use of one or more of the routing attributes as a nonkey field for a flow record, use the no form of this command.
collect
routing
{{destination | source} {as [ [4octet] ] [{peer [4-octet]}] | trafficindex} | forwardingstatus | nexthop address {ipv4 | ipv6} [ [bgp] ] | vrf input}
no collect
routing
{{destination | source} {as [ [4octet] ] [{peer [4-octet]}] | trafficindex} | forwardingstatus | nexthop address {ipv4 | ipv6} [ [bgp] ] | vrf input}
Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE
collect
routing
forwarding-status
[reason]
no
collect
routing
forwarding-status
[reason]
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode. For Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. Here we refer to them both as flow record configuration mode. The Flexible NetFlow and Performance Monitor collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE The reason keywordwas added and only the forwarding-statu s keyword is available. You must first enter the flow record type performance-monitor command. collect routing source as [peer] This command collects the 16-bit autonomous system number based on a lookup of the router's routing table using the source IP address. The optional peer keyword provides the expected next network, as opposed to the originating network. collect routing source as 4-octet [peer 4-octet] This command collects the 32-bit autonomous system number based on a lookup of the router's routing table using the source IP address. The optional peer keyword provides the expected next network, as opposed to the originating network. collect routing destination as [peer] This command collects the 16-bit autonomous system number based on a lookup of the router's routing table using the destination IP address. The optional peer keyword provides the expected next network as opposed to the destination network. collect routing destination as 4-octet [peer 4-octet] This command collects the 32-bit autonomous system number based on a lookup of the router's routing table using the destination IP address. The peer keyword will provide the expected next network as opposed to the destination network. collect routing destination traffic-index This command collects the traffic-index field based on the destination autonomous system for this flow. The traffic-index field is a value propagated through BGP. This command is not supported for IPv6. collect routing source traffic-index This command collects the traffic-index field based on the source autonomous system for this flow. The traffic-index field is a value propagated through BGP. This command is not supported for IPv6. collect routing forwarding-status This command collects a field to indicate if the packets were successfully forwarded. The field is in two parts and may be up to 4 bytes in length. For the releases specified in the Command History table, only the status field is used:
+-+-+-+-+-+-+-+-+
| S | Reason |
| t | codes |
| a | or |
| t | flags |
| u | |
| s | |
+-+-+-+-+-+-+-+-+
0 1 2 3 4 5 6 7
Status:
00b=Unknown, 01b = Forwarded, 10b = Dropped, 11b = Consumed
collect routing vrf input This command collects the VRF ID from incoming packets on a router. In the case where VRFs are associated with an interface via methods such as VRF Selection Using Policy Based Routing/Source IP Address, a VRF ID of 0 will be recorded. If a packet arrives on an interface that does not belong to a VRF, a VRF ID of 0 is recorded. ExamplesThe following example configures the 16-bit autonomous system number based on a lookup of the router's routing table using the source IP address as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect routing source as The following example configures the 16-bit autonomous system number based on a lookup of the router's routing table using the destination IP address as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect routing destination as The following example configures the value in the traffic-index field based on the source autonomous system for a flow as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect routing source traffic-index The following example configures the forwarding status as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect routing forwarding-status The following example configures the VRF ID for incoming packets as a nonkey field for a Flexible NetFlow flow record: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect routing vrf input Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example configures the forwarding status as a nonkey field for a Performance Monitor flow record: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# collect routing forwarding-status reason collect routing is-multicastTo configure the use of the is-multicast field (indicating that the IPv4 traffic is multicast traffic) as a nonkey field, use the collect routing is-multicastcommand in flow record configuration mode. To disable the use of the is-multicast field as a nonkey field for a flow record, use the no form of this command. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. ExamplesThe following example configures the is-multicast field as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect routing is-multicast collect routing multicast replication-factorTo configure the multicast replication factor value for IPv4 traffic as a nonkey field for a flow record, use the collect routing multicast replication-factorcommand in flow record configuration mode. To disable the use of the multicast replication factor value as a nonkey field for a flow record, use the no form of this command. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. When the replication-factor field is used in a flow record, it will only have a non-zero value in the cache for ingress multicast traffic that is forwarded by the router. If the flow record is used with a flow monitor in output (egress) mode or to monitor unicast traffic or both, the cache data for the replication factor field is set to 0. ExamplesThe following example configures the multicast replication factor value as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect routing multicast replication-factor collect timestamp intervalTo configure the start time of the monitoring interval as a nonkey field for a flow record, use the collect timestamp interval command in flow record configuration mode. To disable the use of the start time of the monitoring interval as a nonkey field for a flow record, use the no form of this command. Usage GuidelinesThe collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect timestamp sys-uptimeTo configure the system uptime of the first seen or last seen packet in a flow as a nonkey field for a flow record, use the collect timestamp sys-uptime command in flow record configuration mode. To disable the use of the first seen or last seen packet in a flow as a nonkey field for a flow record, use the no form of this command. Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. ExamplesThe following example configures time stamps based on the system uptime for the time the first packet was seen from the flows as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect timestamp sys-uptime first The following example configures the time stamps based on the system uptime for the time the most recent packet was seen from the flows as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect timestamp sys-uptime last Cisco Performance Monitor in Cisco IOS Release 15.2(2)T and XE 3.5SThe following example configures the time stamps based on the system uptime for the time the most recent packet was seen from the flows as a nonkey field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# collect timestamp sys-uptime last collect transportTo configure one or more of the transport layer fields as a nonkey field for a flow record, use the collect transport command in flow record configuration mode. To disable the use of one or more of the transport layer fields as a nonkey field for a flow record, use the no form of this command.
collect
transport
{destination-port | igmp type | source-port}
no
collect
transport
{destination-port | igmp type | source-port}
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. ExamplesThe following example configures the transport destination port as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport destination-port The following example configures the transport source port as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport source-port collect transport event packet-loss counterTo configure the event packet-loss counter field as a nonkey field for a flow record, use the collect transport event packet-loss countercommand in flow record configuration mode. To disable the use of the event packet-loss counter field as a nonkey field for a flow record, use the no form of this command. Command DefaultThe event packet-loss counter field is not configured as a nonkey field for a user-defined flow record. Usage GuidelinesThe event packet-loss counter is incremented when a lost RTP packet is detected. However, the counter is also incremented when a reorder occurs, in other words, when packets are received out of order. The collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect transport icmp ipv4To configure the internet control message protocol (ICMP) IPv4 type field and the code field as nonkey fields for a flow record, use the collect transport icmp ipv4 command in flow record configuration mode. To disable the use of the ICMP IPv4 type field and code field as nonkey fields for a flow record, use the no form of this command. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. ExamplesThe following example configures the ICMP IPv4 code field as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport icmp ipv4 code The following example configures the ICMP IPv4 type field as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport icmp ipv4 type collect transport icmp ipv6To configure the Internet Control Message Protocol (ICMP) IPv6 type field and code field as nonkey fields for a flow record, use the collect transport icmp ipv6 command in flow record configuration mode. To disable the use of the ICMP IPv6 type field and code field as nonkey fields for a flow record, use the no form of this command. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. ExamplesThe following example configures the ICMP IPv6 code field as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport icmp ipv6 code The following example configures the ICMP IPv6 type field as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport icmp ipv6 type collect transport packetsTo configure various packet fields as a nonkey field for a flow record, use the collect transport packetscommand in flow record configuration mode. To disable the use of a packet field as a nonkey field for a flow record, use the no form of this command.
collect
transport
packets
{lost counter | lost rate | expected counter | out-of-order | round-trip-time}
no
collect
transport
packets
{lost counter | lost rate | expected counter | out-of-order | round-trip-time}
Syntax Description
Command DefaultThe packet fields are not configured as a nonkey field for a user-defined flow record. Usage GuidelinesYou can retrieve different transport packet counters for RTP and TCP. The following transport packet counters as available:
The collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect transport rtp jitterTo configure one of the RTP jitter fields as a nonkey field for a flow record, use the collect transport rtp jittercommand in flow record configuration mode. To disable the use of a jitter field as a nonkey field for a flow record, use the no form of this command.
collect
transport
rtp
jitter
{mean | maximum | minimum}
no
collect
transport
rtp
jitter
{mean | maximum | minimum}
Command DefaultThe RTP jitter field is not configured as a nonkey field for a user-defined flow record. Usage GuidelinesThe collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect transport tcpTo configure one or more of the TCP fields as a nonkey field for a flow record, use the collect transport tcp command in flow record configuration mode. To disable the use of one or more of the TCP fields as a nonkey field for a flow record, use the no form of this command.
collect
transport
tcp
{acknowledgement-number | destination-port | flags [ack | cwr | ece | fin | psh | rst | syn | urg] | header-length | maximum-segment-size | sequence-number | source-port | urgent-pointer | window-size | window-size-average | window-size-maximum | window-size-minimum}
no
collect
transport
tcp
{acknowledgement-number | destination-port | flags [ack | cwr | ece | fin | psh | rst | syn | urg] | header-length | maximum-segment-size | sequence-number | source-port | urgent-pointer | window-size | window-size-average | window-size-maximum | window-size-minimum}
Cisco Catalyst 6500 Switches in Cisco IOS Release 12.2(50)SY
collect
transport
tcp
flags
[ack | cwr | ece | fin | psh | rst | syn | urg]
no
collect
transport
tcp
flags
[ack | cwr | ece | fin | psh | rst | syn | urg]
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. collect transport tcp flags ece For more information about ECN echo, refer to RFC 3168 The Addition of Explicit Congestion Notification (ECN) to IP , at the following URL: http://www.ietf.org/rfc/rfc3168.txt . ExamplesThe following example configures the TCP acknowledgment number as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport tcp acknowledgement-number The following example configures the TCP source port as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport tcp source-port The following example configures the TCP acknowledgment flag as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport tcp flags ack The following example configures the TCP finish flag as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport tcp flags fin The following example configures the TCP reset flag as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport tcp flags rst collect transport udpTo configure one or more of the user datagram protocol UDP fields as a nonkey field for a flow record, use the collect transport udp command in flow record configuration mode. To disable the use of one or more of the UDP fields as a nonkey field for a flow record, use the no form of this command.
collect transport udp
{destination-port | message-length | source-port}
no collect transport udp
{destination-port | message-length | source-port}
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The Flexible NetFlow collect commands are used to configure nonkey fields for the flow monitor record and to enable capturing the values in the fields for the flow created with the record. The values in nonkey fields are added to flows to provide additional information about the traffic in the flows. A change in the value of a nonkey field does not create a new flow. In most cases the values for nonkey fields are taken from only the first packet in the flow. ExamplesThe following example configures the UDP destination port as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport udp destination-port The following example configures the UDP message length as a nonkey field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport udp message-length The following example configures the UDP source port as a non-key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# collect transport udp source-port debug fm performance-monitorTo enable the display of debugging information for the Performance Monitor component of Feature Manager, use the debug fm performance-monitorcommand in privileged EXEC mode. To disable debugging output, use the no form of this command.
debug
fm
performance-monitor
{all | dynamic | event | unusual | verbose | vmr}
no
debug
fm
performance-monitor
{all | dynamic | event | unusual | verbose | vmr}
Syntax Description
ExamplesThe following example shows how to enable debugging for dynamic policy configuration.
Router# debug fm performance dynamic
Related Commands
debug performance monitorTo enable debugging for performance monitor, use the debug performance monitorcommand in privileged EXEC mode. To disable debugging, use the no form of this command.
debug
performance
monitor
{database | dynamic | event | export | flow-monitor | metering | provision | sibling | snmp | tca | timer}
no
debug
performance
monitor
{database | dynamic | event | export | flow-monitor | metering | provision | sibling | snmp | tca | timer}
Syntax Description
description (Performance Monitor)To configure a description for a flow exporter, flow record, flow monitor, or policy map use the descriptioncommand in the appropriate configuration mode. To remove the description, use the no form of this command. Command Modes
Usage GuidelinesThe description command is meant solely as a comment to be put in the configuration to help you remember information about the flow exporter, flow record, flow monitor, or policy map, such as which packets are included within the policy map. ExamplesThe following example shows how to configuration a description for a flow record: Router(config)# flow record type performance-monitor Router(config-flow-record)# description collect the number of IPV4 packet dropped Router(config-flow-record)# match ipv4 protocol Router(config-flow-record)# collect counter packets dropped destinationTo configure an export destination for a flow exporter, use the destination command in flow exporter configuration mode. To remove an export destination for a flow exporter, use the no form of this command. Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. Each flow exporter can have only one destination address or hostname. With Flexible Netflow, you can export to a either an IPv4 or IPv6 address. When you configure a hostname instead of the IP address for the device, the hostname is resolved immediately and the IP address is stored in the running configuration. If the hostname-to-IP-address mapping that was used for the original domain name system (DNS) name resolution changes dynamically on the DNS server, the router does not detect this, and the exported data continues to be sent to the original IP address, resulting in a loss of data. Resolving the hostname immediately is a prerequisite of the export protocol, to ensure that the templates and options arrive before the data ExamplesThe following example shows how to configure the networking device to export the Flexible NetFlow or Performance Monitorcache entry to a destination system using an IPv4 address: Router(config)# flow exporter FLOW-EXPORTER-1 Router(config-flow-exporter)# destination 10.0.0.4 The following example shows how to configure the networking device to export the Flexible NetFlow cache entry to a destination system using an IPv6 address: Router(config)# flow exporter FLOW-EXPORTER-1 Router(config-flow-exporter)# destination 10:0:0:4:4 The following example shows how to configure the networking device to export the Flexible NetFlow or Performance Monitor cache entry to a destination system using a VRF named VRF-1: Router(config)# flow exporter FLOW-EXPORTER-1 Router(config-flow-exporter)# destination 172.16.10.2 vrf VRF-1 dscp (Flexible NetFlow)To configure a differentiated services code point (DSCP) value for flow exporter datagrams, use the dscp command in flow exporter configuration mode. To remove a DSCP value for flow exporter datagrams, use the no form of this command. Command History
export-protocolTo configure the export protocol for a flow exporter, use the export-protocol command in flow exporter configuration mode. To restore the use of the default export protocol for a flow exporter, use the no form of this command. Command History
Usage GuidelinesThe NetFlow Version 5 export protocol is supported only for flow monitors that use the Flexible NetFlow predefined records. exporterTo configure a flow exporter for a flow monitor, use the exporter command in the appropriate configuration mode. To remove a flow exporter for a flow monitor, use the no form of this command. Command Modes
Command History
Usage GuidelinesYou must have already created a flow exporter by using the flow exporter command before you can apply the flow exporter to a flow monitor with the exporter command. For Performance Monitor, you can associate a flow exporter with a flow monitor while configuring either a flow monitor, policy map, or service policy. ExamplesThe following example configures an exporter for a flow monitor: Router(config)# flow monitor FLOW-MONITOR-1 Router(config-flow-monitor)# exporter EXPORTER-1 The following example shows one of the ways to configure a flow exporter for Performance Monitor: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class class-4 Router(config-pmap-c)# flow monitor monitor-4 Router(config-pmap-c-flowmon)# exporter exporter-4 Related Commands
flow monitor type performance-monitorTo configure a flow monitor for Performance Monitor, use the flow monitor type performance-monitorcommand in global configuration mode. To remove flow monitor, use the no form of this command.
flow
monitor
type
performance-monitor
monitor-name
no
flow
monitor
type
performance-monitor
monitor-name
Usage Guidelines.Before you configure flow monitor, you should first configure a flow record and an optional flow exporter. flow record type performance-monitorTo configure a flow record for Performance Monitor, use the flow record type performance-monitorcommand in global configuration mode. To remove the flow record, use the no form of this command.
flow
record
type
performance-monitor
record-name
no
flow
record
type
performance-monitor
record-name
Usage GuidelinesA flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the collect command. flowsTo configure the maximum number of flows for each Performance Monitor cache, use the flowscommand in monitor parameters configuration mode. To remove the configuration, use the no form of this command. history (monitor parameters)To configure the number of historical collections to keep for a Performance Monitor policy, use the historycommand in monitor parameters configuration mode. To remove the configuration, use the no form of this command. ExamplesThe following example shows how to set the number of historical collections to keep for a Performance Monitor policy to four: Router(config)# policy-map type performance-monitor PM-POLICY-4 Router(config-pamp)# class class-6 Router(config-pmap-c)# monitor parameters Router(config-pmap-c-mparam)# history 4 interval durationTo configure the duration of the collection interval for a Performance Monitor policy, use the interval durationcommand in monitor parameters configuration mode. To remove the configuration, use the no form of this command. Usage GuidelinesYou can configure the collection interval in a range of one to 120 seconds, in increments of one second. ExamplesThe following example shows how to set the collection interval for a Performance Monitor policy to twenty: Router(config)# policy-map type performance-monitor PM-POLICY-4 Router(config-pamp)# class class-6 Router(config-pmap-c)# monitor parameters Router(config-pmap-c-mparam)# interval duration 20 match access-groupTo configure the match criteria for a class map on the basis of the specified access control list (ACL), use the match access-group command in class-map configuration or policy inline configuration mode. To remove ACL match criteria from a class map, use the no form of this command. Syntax Description
Command ModesClass-map configuration (config-cmap) Policy inline configuration (config-if-spolicy-inline) Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. For class-based weighted fair queueing (CBWFQ), you define traffic classes based on match criteria including ACLs, protocols, input interfaces, quality of service (QoS) labels, and experimental (EXP) field values. Packets satisfying the match criteria for a class constitute the traffic for that class.
The match access-group command specifies a numbered or named ACL whose contents are used as the match criteria against which packets are checked to determine if they belong to the class specified by the class map. When packets are matched to an access group, a traffic rate is generated for these packets. In Zone-Based Policy Firewall, only the first packet that creates a session matches the policy. Subsequent packets in the flow do not match the filters in the configured policy, but instead match the session directly. The statistics related to subsequent packets are shown as part of the inspect action. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE To use the match access-group command, you must enter the service-policy type performance-monitor inline command. Supported Platforms Other than Cisco 10000 Series Routers To use the match access-group command, you must enter the class-map command to specify the name of the class whose match criteria you want to establish. After you identify the class, you can use one of the following commands to configure its match criteria: Zone-Based Policy Firewall supports only match access-group, match protocol, and match class-map commands. If you specify more than one command in a class map, only the last command you entered will be applied. The last command overrides the previously entered commands.
Cisco 10000 Series Routers To use the match access-group command, you must first enter the class-map command to specify the name of the class whose match criteria you want to establish.
Cisco ASR 1000 Series Aggregation Services Routers When a service policy that is applied to an interface has a class map of more than 16 match statements, the service policy is rejected. This is because Cisco ASR 1000 Series Aggregation Services Routers do not support match statements of more than 16 per class map. ExamplesThe following example shows how to specify a class map named acl144 and shows how to configure the ACL numbered 144 to be used as the match criterion for that class: Router(config)# class-map acl144 Router(config-cmap)# match access-group 144 The following example pertains to Zone-Based Policy Firewall. The example shows how to define a class map named c1 and configure the ACL numbered 144 to be used as the match criterion for that class.
Router(config)# class-map type inspect match-all c1 Router(config-cmap)# match access-group 144 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the flow sampler ID will be monitored based on the parameters specified in the flow monitor configuration named fm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match flow sampler Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit Related Commands
match anyTo configure the match criteria for a class map to be successful match criteria for all packets, use the matchany command in class-map configuration or policy inline configuration mode. To remove all criteria as successful match criteria, use the no form of this command. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. ExamplesIn the following configuration, all packets traversing Ethernet interface 1/1 will be policed based on the parameters specified in policy-map class configuration mode: Router(config)# class-map matchany Router(config-cmap)# match any Router(config-cmap)# exit Router(config)# policy-map policy1 Router(config-pmap)# class class4 Router(config-pmap-c)# police 8100 1500 2504 conform-action transmit exceed-action set-qos-transmit 4 Router(config-pmap-c)# exit Router(config)# interface ethernet1/1 Router(config-if)# service-policy output policy1 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that all packets traversing Ethernet interface 0/0 will be matched and monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match any Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit Related Commands
match application nameTo configure the use of the application name as a key field for a flow record, use the match application name command in flow record configuration mode. To disable the use of the application name as a key field for a flow record, use the no form of this command. Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the application name as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match application name Cisco Performance Monitor in Cisco IOS Release 15.2(2)T and XE 3.5SThe following example configures the application name as a key field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# match application name Related Commands
match application vendorTo configure the application vendor field as a key field for a flow record, use the match application vendor command in flow record configuration mode. To disable the use the application fields as a key field for a flow record, use the no form of this command. Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the application ID (name) as a key field for Flexible Netflow: Router(config)# flow record RECORD-1 Router(config-flow-record)# match application name match application versionTo configure the application version field as a key field for a flow record, use the match application version command in flow record configuration mode. To disable the use the application fields as a key field for a flow record, use the no form of this command. Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the application ID (name) as a key field for Flexible Netflow: Router(config)# flow record RECORD-1 Router(config-flow-record)# match application name match cosTo match a packet on the basis of a Layer 2 class of service (CoS)/Inter-Switch Link (ISL) marking, use the matchcos command in class-map configuration or policy inline configuration mode. To remove a specific Layer 2 CoS/ISL marking as a match criterion, use the no form of this command.
match
cos
cos-value
[cos-value [cos-value [cos-value] ]]
no
match
cos
cos-value
[cos-value [cos-value [cos-value] ]]
Syntax Description
Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. ExamplesIn the following example, the CoS values of 1, 2, and 3 are successful match criteria for the interface that contains the classification policy named cos: Router(config)# class-map cos Router(config-cmap)# match cos 1 2 3 In the following example, classes named voice and video-n-data are created to classify traffic based on the CoS values. QoS treatment is then given to the appropriate packets in the CoS-based-treatment policy map (in this case, the QoS treatment is priority 64 and bandwidth 512). The service policy configured in this example is attached to all packets leaving Fast Ethernet interface 0/0.1. The service policy can be attached to any interface that supports service policies. Router(config)# class-map voice Router(config-cmap)# match cos 7 Router(config)# class-map video-n-data Router(config-cmap)# match cos 5 Router(config)# policy-map cos-based-treatment Router(config-pmap)# class voice Router(config-pmap-c)# priority 64 Router(config-pmap-c)# exit Router(config-pmap)# class video-n-data Router(config-pmap-c)# bandwidth 512 Router(config-pmap-c)# exit Router(config-pmap)# exit Router(config)# interface fastethernet0/0.1 Router(config-if)# service-policy output cos-based-treatment Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the criteria of a CoS value of 2 will be monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match cos 2 Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit Example of the match cos Command for Matching Traffic Classes Inside a 802.1p Domain by CoS values in Cisco IOS Release 12.2(33)SCFThe following example shows how to match traffic classes for the 802.1p domain with packet CoS values: Router> enable Router# config terminal Router(config)# class-map cos7 Router(config-cmap)# match cos 2 Router(config-cmap)# exit Related Commands
match connection transaction-idTo configure the transaction ID as a key field for a flow record, use the match transaction-id command in flow record configuration mode. To disable the use of a transaction ID field as a key field for a flow record, use the no form of this command. Command DefaultThe use of the transaction ID as a key field for a user-defined flow record is not enabled. Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. The transaction ID identifies a transaction within a connection. A transaction is a meaningful exchange of application data between two network devices or a client and server. A transaction ID is assigned the first time a flow is reported, so that later reports for the same flow will have the same transaction ID. A different transaction ID is used for each transaction within a TCP or UDP connection. The identifiers are not required to be sequential. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. The transaction ID field is used to specify the transaction within the connection, for protocols where multiple transactions are used. The field is composed of the CFT-flow ID/pointer (the most significant bit) and the transaction counter within the connection specified by NBAR (least significant bit). ExamplesThe following example configures the transaction ID as a key field: Router(config)# flow record RECORD-4 Router(config-flow-record)# match connection transaction-id match destination-address macTo use the destination MAC address as a match criterion, use the matchdestination-addressmaccommand in class-map configuration or policy inline configuration mode. To remove a previously specified destination MAC address as a match criterion, use the noform of this command. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. ExamplesThe following example specifies a class map named macaddress and specifies the destination MAC address to be used as the match criterion for this class: Router(config)# class-map macaddress Router(config-cmap)# match destination-address mac 00:00:00:00:00:00 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the specified destination MAC address will be monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match destination-address mac 00:00:00:00:00:00 Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit match discard-classTo specify a discard class as a match criterion, use the matchdiscard-class command in class-map configuration or policy inline configuration mode. To remove a previously specified discard class as a match criterion, use the no form of this command. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. A discard-class value has no mathematical significance. For example, the discard-class value 2 is not greater than 1. The value simply indicates that a packet marked with discard-class 2 should be treated differently than a packet marked with discard-class 1. Packets that match the specified discard-class value are treated differently from packets marked with other discard-class values. The discard-class is a matching criterion only, used in defining per hop behavior (PHB) for dropping traffic. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. ExamplesThe following example shows that packets in discard class 2 are matched:
Router(config)# class-map d-class-2
Router(config-cmap)# match discard-class 2
Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the criteria specified by discard-class 2 will be monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match discard-class 2 Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit match dscpTo identify one or more differentiated service code point (DSCP), Assured Forwarding (AF), and Certificate Server (CS) values as a match criterion, use the match dscpcommand in class-map configuration or policy inline configuration mode. To remove a specific DSCP value from a class map, use the no form of this command.
match
[ip]
dscp
dscp-value
[dscp-value dscp-value dscp-value dscp-value dscp-value dscp-value dscp-value]
no
match
[ip]
dscp
dscp-value
Command DefaultNo match criteria are configured. If you do not enter the ip keyword, matching occurs on both IPv4 and IPv6 packets. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policy type performance-monitor inlinecommand. DSCP Values You must enter one or more differentiated service code point (DSCP) values. The command may include any combination of the following:
For example, if you wanted the DCSP values of 0, 1, 2, 3, 4, 5, 6, or 7 (note that only one of the IP DSCP values must be a successful match criterion, not all of the specified DSCP values), enter the match dscp 0 1 2 3 4 5 6 7 command. This command is used by the class map to identify a specific DSCP value marking on a packet. In this context, dscp-value arguments are used as markings only and have no mathematical significance. For instance, the dscp-value of 2 is not greater than 1. The value simply indicates that a packet marked with the dscp-value of 2 is different than a packet marked with the dscp-value of 1. The treatment of these marked packets is defined by the user through the setting of Quality of Service (QoS) policies in policy-map class configuration mode. Match Packets on DSCP Values To match DSCP values for IPv6 packets only, the match protocol ipv6 command must also be used. Without that command, the DSCP match defaults to match both IPv4 and IPv6 packets. To match DSCP values for IPv4 packets only, use the ip keyword. Without the ip keyword the match occurs on both IPv4 and IPv6 packets. Alternatively, the match protocol ip command may be used with match dscp to classify only IPv4 packets. After the DSCP bit is set, other QoS features can then operate on the bit settings. The network can give priority (or some type of expedited handling) to marked traffic. Typically, you set the precedence value at the edge of the network (or administrative domain); data is then queued according to the precedence. Weighted fair queueing (WFQ) can speed up handling for high-precedence traffic at congestion points. Weighted Random Early Detection (WRED) can ensure that high-precedence traffic has lower loss rates than other traffic during times of congestion. Cisco 10000 Series Routers The Cisco 10000 series routers support DSCP matching of IPv4 packets only. You must include the ip keyword when specifying the DSCP values to use as match criterion. You cannot use the set ip dscp command with the set ip precedence command to mark the same packet. DSCP and precedence values are mutually exclusive. A packet can have one value or the other, but not both. ExamplesThe following example shows how to set multiple match criteria. In this case, two IP DSCP value and one AF value. Router(config)# class-map map1 Router(config-cmap)# match dscp 1 2 af11 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the criteria specified by DSCP value 2 will be monitored based on the parameters specified in the flow monitor configuration named fm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match dscp 2 Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit Related Commands
match flowTo configure the flow direction and the flow sampler ID number as key fields for a flow record, use the match flow command in flow record configuration or policy inline configuration mode. To disable the use of the flow direction and the flow sampler ID number as key fields for a flow record, use the no form of this command. Command DefaultThe use of the flow direction and the flow sampler ID number as key fields for a user-defined flow record is not enabled by default. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policy type performance-monitor inlinecommand. match flow direction This field indicates the direction of the flow. This is of most use when a single flow monitor is configured for input and output flows. It can be used to find and eliminate flows that are being monitored twice, once on input and once on output. This field may also be used to match up pairs of flows in the exported data when the two flows are flowing in opposite directions. match flow sampler This field contains the ID of the flow sampler used to monitor the flow. This is useful when more than one flow sampler is being used with different sampling rates. The flow exporter option sampler-table command will export options records with mappings of the flow sampler ID to the sampling rate so the collector can calculate the scaled counters for each flow. ExamplesThe following example configures the direction the flow was monitored in as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match flow direction The following example configures the flow sampler ID as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match flow sampler Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the flow sampler ID will be monitored based on the parameters specified in the flow monitor configuration named fm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match flow sampler Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit match fr-deTo match packets on the basis of the Frame Relay discard eligibility (DE) bit setting, use the match fr-decommand in class-map configuration or policy inline configuration mode. To remove the match criteria, use the no form of this command. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policy type performance-monitor inlinecommand. ExamplesThe following example creates a class named match-fr-de and matches packets on the basis of the Frame Relay DE bit setting. Router(config)# class-map match-fr-de Router(config-cmap)# match fr-de Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the Frame Relay DE bit setting will be monitored based on the parameters specified in the flow monitor configuration named fm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match fr-de Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit Related Commands
match fr-dlciTo specify the Frame Relay data-link connection identifier (DLCI) number as a match criterion in a class map, use the matchfr-dlcicommand in class-map configuration or policy inline configuration mode. To remove a previously specified DLCI number as a match criterion, use the no form of this command. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. This match criterion can be used in main interfaces and point-to-multipoint subinterfaces in Frame Relay networks, and it can also be used in hierarchical policy maps. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. ExamplesIn the following example a class map named "class1" has been created and the Frame Relay DLCI number of 500 has been specified as a match criterion. Packets matching this criterion are placed in class1. Router(config)# class-map class1 Router(config-cmap)# match fr-dlci 500 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the Frame Relay DLCI number of 500 will be monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match fr-dlci 500 Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit Related Commands
match input-interfaceTo configure a class map to use the specified input interface as a match criterion, use the matchinput-interface command in class-map configuration or policy inline configuration mode. To remove the input interface match criterion from a class map, use the no form of this command. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. Supported Platforms Other Than Cisco 10000 Series Routers For class-based weighted fair queueing (CBWFQ), you define traffic classes based on match criteria including input interfaces, access control lists (ACLs), protocols, quality of service (QoS) labels, and experimental (EXP) field values. Packets satisfying the match criteria for a class constitute the traffic for that class. The matchinput-interface command specifies the name of an input interface to be used as the match criterion against which packets are checked to determine if they belong to the class specified by the class map. To use the matchinput-interface command, you must first enter the class-map command to specify the name of the class whose match criteria you want to establish. After you identify the class, you can use one of the following commands to configure its match criteria: If you specify more than one command in a class map, only the last command entered applies. The last command overrides the previously entered commands. Cisco 10000 Series Routers For CBWFQ, you define traffic classes based on match criteria including input interfaces, ACLs, protocols, QoS labels, and EXP field values. Packets satisfying the match criteria for a class constitute the traffic for that class. To use the matchinput-interface command, you must first enter the class-map command to specify the name of the class whose match criteria you want to establish. ExamplesThe following example specifies a class map named ethernet1 and configures the input interface named ethernet1 to be used as the match criterion for this class: Router(config)# class-map ethernet1 Router(config-cmap)# match input-interface ethernet1 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the criteria of the input interface named ethernet1 will be monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match input-interface ethernet 1 Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit Related Commands
match interface (Flexible NetFlow)To configure the input and output interfaces as key fields for a flow record, use the match interface command in flow record configuration mode. To disable the use of the input and output interfaces as key fields for a flow record, use the no form of this command.
match
interface
{input | output}
no
match
interface
{input | output}
Cisco Catalyst 6500 Switches in Cisco IOS Release 12.2(50)SY
match
interface
{input [physical] | output}
[snmp]
no
match
interface
{input [physical] | output}
[snmp]
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the input interface as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match interface input The following example configures the output interface as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match interface output match ip rtpTo configure a class map to use the Real-Time Protocol (RTP) port as the match criterion, use the matchiprtpcommand in class-map configuration or policy inline configuration mode. To remove the RTP port match criterion, use the no form of this command. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. This command is used to match IP RTP packets that fall within the specified port range. It matches packets destined to all even User Datagram Port (UDP) port numbers in the range from the starting port number argument to the starting port number plus the port range argument. Use of an RTP port range as the match criterion is particularly effective for applications that use RTP, such as voice or video. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. ExamplesThe following example specifies a class map named ethernet1 and configures the RTP port number 2024 and range 1000 to be used as the match criteria for this class: Router(config)# class-map ethernet1 Router(config-cmap)# match ip rtp 2024 1000 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the criteria of RTP port number 2024 and range 1000 will be monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match ip rtp 2024 1000 Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit Related Commands
match ipv4To configure one or more of the IPv4 fields as a key field for a flow record, use the match ipv4 command in flow record configuration mode. To disable the use of one or more of the IPv4 fields as a key field for a flow record, use the no form of this command.
match
ipv4
{dscp | header-length | id | option map | precedence | protocol | tos | version}
no
match
ipv4
{dscp | header-length | id | option map | precedence | protocol | tos | version}
Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE
match
ipv4
protocol
no
match
ipv4
protocol
Syntax Description
Command DefaultThe use of one or more of the IPv4 fields as a key field for a user-defined flow record is not enabled by default. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command.
Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE Only the protocolkeyword is available. You must first enter the flow record type performance-monitor command. ExamplesThe following example configures the IPv4 DSCP field as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv4 dscp match ipv4 destinationTo configure the IPv4 destination address as a key field for a flow record, use the match ipv4 destination command in flow record configuration mode. To disable the IPv4 destination address as a key field for a flow record, use the no form of this command.
match
ipv4
destination
{address | {mask | prefix} [[minimum-mask mask]]}
no match
ipv4
destination
{address | {mask | prefix} [[minimum-mask mask]]}
Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE
match
ipv4
destination
{address | prefix [[minimum-mask mask]]}
no match
ipv4
destination
{address | prefix [[minimum-mask mask]]}
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE The maskkeyword is not available. You must first enter the flow record type performance-monitor command. ExamplesThe following example configures a 16-bit IPv4 destination address prefix as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv4 destination prefix minimum-mask 16 The following example specifies a 16-bit IPv4 destination address mask as a key field: Router(config)# flow recor d F LOW-RECORD-1 Router(config-flow-record)# match ipv4 destination mask minimum-mask 16 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example specifies a 16-bit IPv4 destination address mask as a key field for Cisco Performance Monitor: Router(config)# flow recor d type performance-monitor F LOW-RECORD-1 Router(config-flow-record)# match ipv4 destination mask minimum-mask 16 match ipv4 fragmentationTo configure the IPv4 fragmentation flags and the IPv4 fragmentation offset as key fields for a flow record, use the match ipv4 fragmentation command in flow record configuration mode. To disable the use of the IPv4 fragmentation flags and the IPv4 fragmentation offset as key fields for a flow record, use the no form of this command. Command DefaultThe IPv4 fragmentation flags and the IPv4 fragmentation offset arenot configured as key fields. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. match ipv4 fragmentation flags This field matches the "don't fragment" and "more fragments" flags. Bit 0: reserved, must be zero Bit 1: (DF) 0 = May Fragment, 1 = Don't Fragment Bit 2: (MF) 0 = Last Fragment,1 = More Fragments Bits 3-7: (DC) Don't Care, value is irrelevant
0 1 2 3 4 5 6 7
+---+---+---+---+---+---+---+---+
| | D | M | D | D | D | D | D |
| 0 | F | F | C | C | C | C | C |
+---+---+---+---+---+---+---+---+
For more information on IPv4 fragmentation flags, see RFC 791, Internet Protocol at the following URL: http://www.ietf.org/rfc/rfc791.txt . ExamplesThe following example configures the IPv4 fragmentation flags as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv4 fragmentation flags The following example configures the IPv4 offset flag as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv4 fragmentation offset match ipv4 sectionTo configure a section of an IPv4 packet as a key field for a flow record, use the match ipv4 section command in flow record configuration mode. To disable the use of a section of an IPv4 packet as a key field for a flow record, use the no form of this command.
match
ipv4
section
{header size header-size | payload size payload-size}
no
match
ipv4
section
{header size header-size | payload size payload-size}
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. match ipv4 section header This command uses the section of the IPv4 header indicated by the header sizeheader-size keyword and argument as a key field. Only the configured size in bytes will be matched, and part of the payload will also be matched if the configured size is larger than the size of the header.
match ipv4 section payload This command uses the section of the IPv4 payload indicated by the payload sizepayload-size keyword and argument as a key field.
ExamplesThe following example configures the first four bytes (the IPv4 version field) as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv4 section header size 4 The following example configures the first 16 bytes from the payload of the IPv4 packets in the flow as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv4 section payload size 16 Cisco Performance Monitor in Cisco IOS Release 15.2(2)T and XE 3.5SThe following example configures the first 16 bytes from the payload of the IPv4 packets in the flow as a key field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# match ipv4 section payload size 16 match ipv4 sourceTo configure the IPv4 source address as a key field for a flow record, use the match ipv4 sourcecommand in flow record configuration mode. To disable the use of the IPv4 source address as a key field for a flow record, use the no form of this command.
match
ipv4
source
{address | {mask | prefix} [[minimum-mask mask]]}
no match
ipv4
source
{address | {mask | prefix} [[minimum-mask mask]]}
Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE
match
ipv4
source
{address | prefix [[minimum-mask mask]]}
no match
ipv4
source
{address | prefix [[minimum-mask mask]]}
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE The maskkeyword is not available. You must first enter the flow record type performance-monitor command. match ipv4 source prefix minimum-mask The source address prefix field is the network part of the source address. The optional minimum mask allows a more information to be gathered about large networks. match ipv4 source mask minimum-mask The source address mask is the number of bits that make up the network part of the source address. The optional minimum mask allows a minimum value to be configured. This command is useful when there is a minimum mask configured for the source prefix field and the mask is to be used with the prefix. In this case, the values configured for the minimum mask should be the same for the prefix and mask fields. Alternatively, if the collector knows the minimum mask configuration of the prefix field, the mask field can be configured without a minimum mask so that the true mask and prefix can be calculated. ExamplesThe following example configures a 16-bit IPv4 source address prefix as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv4 source prefix minimum-mask 16 The following example specifies a 16-bit IPv4 source address mask as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv4 source mask minimum-mask 16 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example specifies a 16-bit IPv4 source address mask as a key field for Cisco Performance Monitor: Router(config)# flow recor d type performance-monitor F LOW-RECORD-1 Router(config-flow-record)# match ipv4 source mask minimum-mask 16 match ipv4 total-lengthTo configure the IPv4 total-length field as a key field for a flow record, use the match ipv4 total-length command in flow record configuration mode. To disable the use of the IPv4 total-length field as a key field for a flow record, use the no form of this command. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the total-length value as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv4 total-length match ipv4 ttlTo configure the IPv4 time-to-live (TTL) field as a key field for a flow record, use the match ipv4 ttl command in flow record configuration mode. To disable the use of the IPv4 TTL field as a key field for a flow record, use the no form of this command. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures IPv4 TTL as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv4 ttl match ipv6To configure one or more of the IPv6 fields as a key field for a flow record, use the match ipv6 command in flow record configuration mode. To disable the use of one or more of the IPv6 fields as a key field for a flow record, use the no form of this command.
match
ipv6
{dscp | flow-label | next-header | payload-length | precedence | protocol | traffic-class | version}
no
match
ipv6
{dscp | flow-label | next-header | payload-length | precedence | protocol | traffic-class | version}
Cisco Catalyst 6500 Switches in Cisco IOS Release 12.2(50)SY
match
ipv6
{dscp | precedence | protocol | tos}
no
match
ipv6
{dscp | precedence | protocol | tos}
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command.
ExamplesThe following example configures the IPv6 DSCP field as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv6 dscp match ipv6 destinationTo configure the IPv6 destination address as a key field for a flow record, use the match ipv6 destination command in flow record configuration mode. To disable the IPv6 destination address as a key field for a flow record, use the no form of this command.
match
ipv6
destination
{address | {mask | prefix} [minimum-mask mask]}
no
match
ipv6
destination
{address | {mask | prefix} [minimum-mask mask]}
Cisco Catalyst 6500 Switches in Cisco IOS Release 12.2(50)SY
match
ipv6
destination
address
no
match
ipv6
destination
address
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures a 16-bit IPv6 destination address prefix as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv6 destination prefix minimum-mask 16 The following example specifies a 16-bit IPv6 destination address mask as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv6 destination mask minimum-mask 16 match ipv6 extension mapTo configure the bitmap of the IPv6 extension header map as a key field for a flow record, use the match ipv6 extension map command in flow record configuration mode. To disable the use of the IPv6 bitmap of the IPv6 extension header map as a key field for a flow record, use the no form of this command. Command DefaultThe use of the bitmap of the IPv6 extension header map as a key field for a user-defined flow record is not enabled by default. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. Bitmap of the IPv6 Extension Header Map The bitmap of IPv6 extension header map is made up of 32 bits.
0 1 2 3 4 5 6 7
+-----+-----+-----+-----+-----+-----+-----+-----+
| Res | FRA1| RH | FRA0| UNK | Res | HOP | DST |
+-----+-----+-----+-----+-----+-----+-----+-----+
8 9 10 11 12 13 14 15
+-----+-----+-----+-----+-----+-----+-----+-----+
| PAY | AH | ESP | Reserved |
+-----+-----+-----+-----+-----+-----+-----+-----+
16 17 18 19 20 21 22 23
+-----+-----+-----+-----+-----+-----+-----+-----+
| Reserved |
+-----+-----+-----+-----+-----+-----+-----+-----+
24 25 26 27 28 29 30 31
+-----+-----+-----+-----+-----+-----+-----+-----+
| Reserved |
+-----+-----+-----+-----+-----+-----+-----+-----+
0 Res Reserved
1 FRA1 Fragmentation header - not first fragment
2 RH Routing header
3 FRA0 Fragment header - first fragment
4 UNK Unknown Layer 4 header
(compressed, encrypted, not supported)
5 Res Reserved
6 HOP Hop-by-hop option header
7 DST Destination option header
8 PAY Payload compression header
9 AH Authentication Header
10 ESP Encrypted security payload
11 to 31 Reserved
For more information on IPv6 headers, refer to RFC 2460 Internet Protocol, Version 6 (IPv6) at the following URL: http://www.ietf.org/rfc/rfc2460.txt . ExamplesThe following example configures the IPv6 bitmap of the IPv6 extension header map of the packets in the flow as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv6 extension map Cisco Performance Monitor in Cisco IOS Release 15.2(2)T and XE 3.5SThe following example configures the IPv6 bitmap of the IPv6 extension header map of the packets in the flow as a key field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# match ipv6 extension map match ipv6 fragmentationTo configure one or more of the IPv6 fragmentation fields as a key field for a flow record, use the match ipv6 fragmentation command in flow record configuration mode. To disable the use of the IPv6 fragmentation field as a key field for a flow record, use the no form of this command. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the IPv6 fragmentation flags a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv6 fragmentation flags The following example configures the IPv6 offset value a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv6 fragmentation offset match ipv6 hop-limitTo configure the IPv6 hop limit as a key field for a flow record, use the match ipv6 hop-limit command in flow record configuration mode. To disable the use of a section of an IPv6 packet as a key field for a flow record, use the no form of this command. Command DefaultThe use of the IPv6 hop limit as a key field for a user-defined flow record is not enabled by default. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the hop limit of the packets in the flow as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv6 hop-limit match ipv6 lengthTo configure one or more of the IPv6 length fields as a key field for a flow record, use the match ipv6 length command in flow record configuration mode. To disable the use of the IPv6 length field as a key field for a flow record, use the no form of this command. Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the length of the IPv6 header in bytes, not including any extension headers, as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv6 length header Cisco Performance Monitor in Cisco IOS Release 15.2(2)T and XE 3.5SThe following example configures the length of the IPv6 header in bytes, not including any extension headers, as a key field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# match ipv6 length header match ipv6 sectionTo configure a section of an IPv6 packet as a key field for a flow record, use the match ipv6 section command in flow record configuration mode. To disable the use of a section of an IPv6 packet as a key field for a flow record, use the no form of this command.
match
ipv6
section
{header size header-size | payload size payload-size}
no
match
ipv6
section
{header size header-size | payload size payload-size}
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. match ipv6 section header This command uses the section of the IPv6 header indicated by the headersizeheader-size keyword and argument as a key field. Only the configured size in bytes will be matched, and part of the payload will also be matched if the configured size is larger than the size of the header.
match ipv6section payload This command uses the section of the IPv6 payload indicated by the payloadsizepayload-size keyword and argument as a key field.
ExamplesThe following example configures the first four bytes (the IP version field) from the IPv6 header of the packets in the flows as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv6 section header size 4 The following example configures the first 16 bytes from the payload of the IPv6 packets in the flows as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv6 section payload size 16 Cisco Performance Monitor in Cisco IOS Release 15.2(2)T and XE 3.5SThe following example configures the first 16 bytes from the payload of the IPv6 packets in the flows as a key field: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# match ipv6 section payload size 16 match ipv6 sourceTo configure the IPv6 source address as a key field for a flow record, use the match ipv6 sourcecommand in flow record configuration mode. To disable the use of the IPv6 source address as a key field for a flow record, use the no form of this command.
match
ipv6
source
{address | {mask | prefix} [minimum-mask mask]}
no
match
ipv6
source
{address | {mask | prefix} [minimum-mask mask]}
Cisco Catalyst 6500 Switches in Cisco IOS Release 12.2(50)SY
match
ipv6
source
address
no
match
ipv6
source
address
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures a 16-bit IPv6 source address prefix as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv6 source prefix minimum-mask 16 The following example specifies a 16-bit IPv6 source address mask as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match ipv6 source mask minimum-mask 16 match metadataTo configure one or more of the metadata fields as a key field for a flow record, use the match metadata command in flow record configuration mode. To disable the use the metadata fields as a key field for a flow record, use the no form of this command.
match
metadata
{global-session-id | multi-party-session-id}
no match
metadata
{global-session-id | multi-party-session-id}
Syntax Description
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the global session ID of an end-to-end flow as a key field for Flexible Netflow: Router(config)# flow record RECORD-1 Router(config-flow-record)# match metadata global-session-id Cisco Performance Monitor in Cisco IOS Release 15.2(2)S and 15.2(3)TThe following example configures the global session ID of an end-to-end flow as a key field for Performance Monitor: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# match metadata global-session-id match mpls experimental topmostTo match the experimental (EXP) value in the topmost label header, use the matchmplsexperimentaltopmostcommand in class-map configuration or policy inline configuration mode. To remove the EXP match criterion, use the no form of this command. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. You can enter this command on the input interfaces and the output interfaces. It will match only on MPLS packets. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. ExamplesThe following example shows that the EXP value 3 in the topmost label header is matched: Router(config)# class-map mpls exp Router(config-cmap)# match mpls experimental topmost 3 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the criteria of a EXP value of 3 in the topmost label header will be monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match mpls experimental topmost 3 Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit Related Commands
match notTo specify the single match criterion value to use as an unsuccessful match criterion, use the matchnotcommand inclass-map configuration or policy inline configuration mode. To remove a previously specified source value to not use as a match criterion, use the noform of this command. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. The matchnotcommand is used to specify a quality of service (QoS) policy value that is not used as a match criterion. When thematchnot command is used, all other values of that QoS policy become successful match criteria. For instance, if the matchnotqos-group4 command is issued in QoS class-map configuration mode, the specified class will accept all QoS group values except 4 as successful match criteria. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. ExamplesIn the following traffic class, all protocols except IP are considered successful match criteria: Router(config)# class-map noip Router(config-cmap)# match not protocol ip Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 for all protocols except IP will be monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match not protocol ip Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit match packet length (class-map)To specify the Layer 3 packet length in the IP header as a match criterion in a class map, use the matchpacketlength command in class-map configuration or policy inline configuration mode. To remove a previously specified Layer 3 packet length as a match criterion, use the no form of this command.
match
packet
length
{max maximum-length-value [min minimum-length-value] | min minimum-length-value [max maximum-length-value]}
no
match
packet
length
{max maximum-length-value [min minimum-length-value] | min minimum-length-value [max maximum-length-value]}
Syntax Description
Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. This command considers only the Layer 3 packet length in the IP header. It does not consider the Layer 2 packet length in the IP header. When using this command, you must at least specify the maximum or minimum value. However, you do have the option of entering both values. If only the minimum value is specified, a packet with a Layer 3 length greater than the minimum is viewed as matching the criterion. If only the maximum value is specified, a packet with a Layer 3 length less than the maximum is viewed as matching the criterion. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. ExamplesIn the following example a class map named "class 1" has been created, and the Layer 3 packet length has been specified as a match criterion. In this example, packets with a minimum Layer 3 packet length of 100 bytes and a maximum Layer 3 packet length of 300 bytes are viewed as meeting the match criteria. Router(config)# class-map match-all class1 Router(config-cmap)# match packet length min 100 max 300 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the criteria of a minimum Layer 3 packet length of 100 bytes and a maximum Layer 3 packet length of 300 bytes will be monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match packet length min 100 max 300 Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit Related Commands
match precedenceTo identify IP precedence values to use as the match criterion, use the matchprecedencecommand in class-map configuration or policy inline configuration mode. To remove IP precedence values from a class map, use the no form of this command.
match
[ip]
precedence
{precedence-criteria1 | precedence-criteria2 | precedence-criteria3 | precedence-criteria4}
no
match
[ip]
precedence
{precedence-criteria1 | precedence-criteria2 | precedence-criteria3 | precedence-criteria4}
Syntax Description
Command DefaultNo match criterion is configured. If you do not enter the ip keyword, matching occurs on both IPv4 and IPv6 packets. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. You can enter up to four matching criteria, as number abbreviation (0 to 7) or criteria names (critical, flash, and so on), in a single match statement. For example, if you wanted the precedence values of 0, 1, 2, or 3 (note that only one of the precedence values must be a successful match criterion, not all of the specified precedence values), enter the matchipprecedence0123command. The precedence-criteria numbers are not mathematically significant; that is, the precedence-criteria of 2 is not greater than 1. The way that these different packets are treated depends upon quality of service (QoS) policies, set in the policy-map configuration mode. You can configure a QoS policy to include IP precedence marking for packets entering the network. Devices within your network can then use the newly marked IP precedence values to determine how to treat the packets. For example, class-based weighted random early detection (WRED) uses IP precedence values to determine the probability that a packet is dropped. You can also mark voice packets with a particular precedence. You can then configure low-latency queueing (LLQ) to place all packets of that precedence into the priority queue. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. Matching Precedence for IPv6 and IPv4 Packets on the Cisco 10000 and 7600 Series Routers On the Cisco 7600 series and 10000 series routers, you set matching criteria based on precedence values for only IPv6 packets using the matchprotocolcommandwiththeipv6 keyword. Without that keyword, the precedence match defaults to match both IPv4 and IPv6 packets. You set matching criteria based on precedence values for IPv4 packets only, use the ip keyword. Without the ip keyword the match occurs on both IPv4 and IPv6 packets. Precedence Values and Names The following table lists all criteria conditions by value, name, binary value, and recommended use. You may enter up to four criteria, each separated by a space. Only one of the precedence values must be a successful match criterion. The table below lists the IP precedence values.
Do not use IP precedence 6 or 7 to mark packets, unless you are marking control packets. IPv4-Specific Traffic MatchThe following example shows how to configure the service policy named priority50 and attach service policy priority50 to an interface, matching for IPv4 traffic only. In a network where both IPv4 and IPv6 are running, you might find it necessary to distinguish between the protocols for matching and traffic segregation. In this example, the class map named ipprec5 will evaluate all IPv4 packets entering Fast Ethernet interface 1/0/0 for a precedence value of 5. If the incoming IPv4 packet has been marked with the precedence value of 5, the packet will be treated as priority traffic and will be allocated with bandwidth of 50 kbps. Router(config)# class-map ipprec5 Router(config-cmap)# match ip precedence 5 Router(config)# exit Router(config)# policy-map priority50 Router(config-pmap)# class ipprec5 Router(config-pmap-c)# priority 50 Router(config-pmap-c)# exit Router(config-pmap)# exit Router(config)# interface fa1/0/0 Router(config-if)# service-policy input priority50 IPv6-Specific Traffic MatchThe following example shows the same service policy matching on precedence for IPv6 traffic only. Notice that the matchprotocol command with the ipv6 keyword precedes the matchprecedence command. The matchprotocol command is required to perform matches on IPv6 traffic alone. Router(config)# class-map ipprec5 Router(config-cmap)# match protocol ipv6 Router(config-cmap)# match precedence 5 Router(config)# exit Router(config)# policy-map priority50 Router(config-pmap)# class ipprec5 Router(config-pmap-c)# priority 50 Router(config-pmap-c)# exit Router(config-pmap)# exit Router(config)# interface fa1/0/0 Router(config-if)# service-policy input priority50 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the criteria of a match precedence of 4 will be monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match precedence 4 Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit Related Commands
match protocolTo configure the match criterion for a class map on the basis of a specified protocol, use the matchprotocol command in class-map configuration or policy inline configuration mode. To remove the protocol-based match criterion from the class map, use the no form of this command. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. Supported Platforms Other Than Cisco 7600 Routers and Cisco 10000 Series Routers For class-based weighted fair queueing (CBWFQ), you define traffic classes based on match criteria protocols, access control lists (ACLs), input interfaces, quality of service (QoS) labels, and Experimental (EXP) field values. Packets satisfying the match criteria for a class constitute the traffic for that class. The matchprotocol command specifies the name of a protocol to be used as the match criteria against which packets are checked to determine if they belong to the class specified by the class map. The matchprotocolipx command matches packets in the output direction only. To use the matchprotocol command, you must first enter the class-map command to specify the name of the class whose match criteria you want to establish. After you identify the class, you can use one of the following commands to configure its match criteria: If you specify more than one command in a class map, only the last command entered applies. The last command overrides the previously entered commands. To configure NBAR to match protocol types that are supported by NBAR traffic, use the matchprotocol(NBAR)command. Cisco 7600 Series Routers The matchprotocol command in QoS class-map configuration configures NBAR and sends all traffic on the port, both ingress and egress, to be processed in the software on the Multilayer Switch Feature Card 2 (MSFC2). For CBWFQ, you define traffic classes based on match criteria like protocols, ACLs, input interfaces, QoS labels, and Multiprotocol Label Switching (MPLS) EXP field values. Packets satisfying the match criteria for a class constitute the traffic for that class. The matchprotocolcommand specifies the name of a protocol to be used as the match criteria against which packets are checked to determine if they belong to the class specified by the class map. If you want to use the matchprotocolcommand, you must first enter the class-map command to specify the name of the class to which you want to establish the match criteria. If you specify more than one command in a class map, only the last command entered applies. The last command overrides the previously entered commands. This command can be used to match protocols that are known to the NBAR feature. For a list of protocols supported by NBAR, see the "Classification" part of the Cisco IOS Quality of Service Solutions Configuration Guide. Cisco 10000 Series Routers For CBWFQ, you define traffic classes based on match criteria including protocols, ACLs, input interfaces, QoS labels, and EXP field values. Packets satisfying the match criteria for a class constitute the traffic for that class. The matchprotocol command specifies the name of a protocol to be used as the match criteria against which packets are checked to determine if they belong to the class specified by the class map. The matchprotocolipx command matches packets in the output direction only. To use the matchprotocol command, you must first enter the class-map command to specify the name of the class whose match criteria you want to establish. If you are matching NBAR protocols, use the matchprotocol(NBAR) command. Match Protocol Command Restrictions (Catalyst 6500 Series Switches Only) Policy maps contain traffic classes. Traffic classes contain one or more match commands that can be used to match packets (and organize them into groups) on the basis of a protocol type or application. You can create as many traffic classes as needed. Cisco IOS Release 12.2(18)ZY includes software intended for use on the Catalyst 6500 series switch that is equipped with a Supervisor 32/PISA engine. For this release and platform, note the following restrictions for using policy maps and matchprotocol commands:
Supported Protocols The table below lists the protocols supported by most routers. Some routers support a few additional protocols. For example, the Cisco 7600 router supports the AARP and DECnet protocols, while the Cisco 7200 router supports the directconnect and PPPOE protocols. For a complete list of supported protocols, see the online help for the matchprotocol command on the router that you are using.
* This protocol is not supported on the Catalyst 6500 series switch that is equipped with a Supervisor 32/PISA engine. ExamplesThe following example specifies a class map named ftp and configures the FTP protocol as a match criterion: Router(config)# class-map ftp Router(config-cmap) # match protocol ftp Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE The following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 for the IP protocol will be monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match protocol ip Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit Related Commands
match qos-groupTo identify a specific quality of service (QoS) group value as a match criterion, use the matchqos-groupcommand in class-map configuration or policy inline configuration mode. To remove a specific QoS group value from a class map, use the no form of this command. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. The matchqos-group command is used by the class map to identify a specific QoS group value marking on a packet. This command can also be used to convey the received Multiprotocol Label Switching (MPLS) experimental (EXP) field value to the output interface. The qos-group-value argument is used as a marking only. The QoS group values have no mathematical significance. For instance, the qos-group-value of 2 is not greater than 1. The value simply indicates that a packet marked with the qos-group-value of 2 is different than a packet marked with the qos-group-value of 1. The treatment of these packets is defined by the user through the setting of QoS policies in QoS policy-map class configuration mode. The QoS group value is local to the router, meaning that the QoS group value that is marked on a packet does not leave the router when the packet leaves the router. If you need a marking that resides in the packet, use IP precedence setting, IP differentiated services code point (DSCP) setting, or another method of packet marking. This command can be used with the random-detectdiscard-class-basedcommand. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. ExamplesThe following example shows how to configure the service policy named priority50 and attach service policy priority50 to an interface. In this example, the class map named qosgroup5 will evaluate all packets entering Fast Ethernet interface 1/0/0 for a QoS group value of 5. If the incoming packet has been marked with the QoS group value of 5, the packet will be treated with a priority level of 50. Router(config)# class-map qosgroup5 Router(config-cmap) # match qos-group 5 Router(config)# exit Router(config)# policy-map priority50 Router(config-pmap)# class qosgroup5 Router(config-pmap-c)# priority 50 Router(config-pmap-c)# exit Router(config-pmap)# exit Router(config)# interface fastethernet1/0/0 Router(config-if)# service-policy output priority50 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the criteria of a QoS value of 4 will be monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match qosgroup 4 Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit Related Commands
match routingTo configure one or more of the routing fields as a key field for a flow record, use the match routing command in flow record configuration mode. To disable the use of one or more of the routing fields as a key field for a flow record, use the no form of this command.
match routing
{{destination | source} {as [4-octet] peer [4-octet] traffic-index} forwarding-status next-hop address {ipv4 | ipv6} [bgp] | vrf input}
no match routing
{{destination | source} {as [4-octet] peer [4-octet] traffic-index} forwarding-status next-hop address {ipv4 | ipv6} [bgp] | vrf input}
Cisco Catalyst 6500 Switches in Cisco IOS Release 12.2(50)SY
match
routing
vrf
input
no
match
routing
vrf
input
Syntax Description
Command DefaultThe use of one or more of the routing fields as a key field for a user-defined flow record is disabled. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. match routing source as [peer] This command matches the 16-bit autonomous system number based on a lookup of the router's routing table using the source IP address. The optional peer keyword provides the expected next network, as opposed to the originating network. match routing source as 4-octet [ 4-octet peer] This command matches the 32-bit autonomous system number based on a lookup of the router's routing table using the source IP address. The optional peer keyword provides the expected next network, as opposed to the originating network. match routing destination as [peer] This command matches the 16-bit autonomous system number based on a lookup of the router's routing table using the destination IP address. The peer keyword will provide the expected next network as opposed to the destination network. match routing destination as 4-octet [ 4-octet peer] This command matches the 32-bit autonomous system number based on a lookup of the router's routing table using the destination IP address. The peer keyword will provide the expected next network as opposed to the destination network. match routing destination traffic-index This command matches the traffic-index field based on the destination autonomous system for this flow. The traffic-index field is a value propagated through BGP. This command is not supported for IPv6. match routing source traffic-index This command matches the traffic-index field based on the source autonomous system for this flow. The traffic-index field is a value propagated through BGP. This command is not supported for IPv6. match routing forwarding-status This command matches a field to indicate if the packets were successfully forwarded. The field is in two parts and may be up to 4 bytes in length. For the releases specified in the Command History table, only the status field is used:
+-+-+-+-+-+-+-+-+
| S | Reason |
| t | codes |
| a | or |
| t | flags |
| u | |
| s | |
+-+-+-+-+-+-+-+-+
0 1 2 3 4 5 6 7
Status:
00b=Unknown, 01b = Forwarded, 10b = Dropped, 11b = Consumed
match routing vrf input This command matches the VRF ID from incoming packets on a router. In the case where VRFs are associated with an interface via methods such as VRF Selection Using Policy Based Routing/Source IP Address, a VRF ID of 0 will be recorded. If a packet arrives on an interface that does not belong to a VRF, a VRF ID of 0 is recorded. ExamplesThe following example configures the source autonomous system as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match routing source as The following example configures the destination autonomous system as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match routing destination as The following example configures the BGP source traffic index as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match routing source traffic-index The following example configures the forwarding status as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match routing forwarding-status The following example configures the VRF ID for incoming packets as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match routing vrf input match routing is-multicastTo configure the use of the is-multicast field (indicating that the IPv4 traffic is multicast traffic) as a key field for a flow record, use the match routing is-multicast command in flow record configuration mode. To disable the use of the is-multicast field as a key field for a flow record, use the no form of this command. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. ExamplesThe following example configures the is-multicast field as a key field for a flow record: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match routing is-multicast Cisco Performance Monitor in Cisco IOS Release 15.2(2)T and XE 3.5SThe following example configures the is-multicast field as a key field for a Performance Monitor flow record: Router(config)# flow record type performance-monitor RECORD-1 Router(config-flow-record)# match routing multicast replication-factor match routing multicast replication-factorTo configure the multicast replication factor value for IPv4 traffic as a key field for a flow record, use the match multicast replication-factorcommand in flow record configuration mode. To disable the use of the multicast replication factor value as a key field for a flow record, use the no form of this command. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. When the replication-factor field is used in a flow record, it will only have a non-zero value in the cache for ingress multicast traffic that is forwarded by the router. If the flow record is used with a flow monitor in output (egress) mode or to monitor unicast traffic or both, the cache data for the replication factor field is set to 0. ExamplesThe following example configures the multicast replication factor value as a key field for a flow record: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match routing multicast replication-factor match source-address macTo use the source MAC address as a match criterion, use the matchsource-addressmaccommand in class-map configuration or policy inline configuration mode. To remove a previously specified source MAC address as a match criterion, use the noform of this command. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. This command can be used only on an input interface with a MAC address; for example, Fast Ethernet and Ethernet interfaces. This command cannot be used on output interfaces with no MAC address, such as serial and ATM interfaces. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policytypeperformance-monitorinlinecommand. ExamplesThe following example uses the MAC address mac 0.0.0 as a match criterion: Router(config)# class-map matchsrcmac Router(config-cmap) # match source-address mac 0.0.0 Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the specified MAC source address will be monitored based on the parameters specified in the flow monitor configuration namedfm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match source-address mac 0.0.0 Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit match transportTo configure one or more of the transport fields as a key field for a flow record, use the match transport command in flow record configuration mode. To disable the use of one or more of the transport fields as a key field for a flow record, use the no form of this command.
match
transport
{destination-port | igmp type | source-port}
no
match
transport
{destination-port | igmp type | source-port}
Cisco Catalyst 6500 Switches in Cisco IOS Release 12.2(50)SY
match
transport
{destination-port | source-port}
no
match
transport
{destination-port | source-port}
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the destination port as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport destination-port The following example configures the source port as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport source-port match transport destination-portTo configure the destination port as a key field for a flow record, use the match transport destination-portcommand in flow record configuration mode. To disable the use of the destination port as a key field for a flow record, use the no form of this command. Command DefaultThe use of the destination port as a key field for a user-defined flow record is not enabled by default. Usage GuidelinesA flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. match transport icmp ipv4To configure the ICMP IPv4 type field and the code field as key fields for a flow record, use the match transport icmp ipv4 command in flow record configuration mode. To disable the use of the ICMP IPv4 type field and code field as key fields for a flow record, use the no form of this command. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the IPv4 ICMP code field as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport icmp ipv4 code The following example configures the IPv4 ICMP type field as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport icmp ipv4 type match transport icmp ipv6To configure the internet control message protocol ICMP IPv6 type field and the code field as key fields for a flow record, use the match transport icmp ipv6 command in flow record configuration mode. To disable the use of the ICMP IPv6 type field and code field as key fields for a flow record, use the no form of this command. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A Flow Record requires at least one key field before it can be used in a Flow Monitor. The Key fields differentiate Flows, with each flow having a unique set of values for the key fields. The Key fields are defined using the match command. ExamplesThe following example configures the IPv6 ICMP code field as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport icmp ipv6 code The following example configures the IPv6 ICMP type field as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport icmp ipv6 type match transport rtp ssrcTo configure the SSRC field in RTP packet header as a key field for a flow record, use the match transport rtp ssrccommand in flow record configuration mode. To disable the use of the SSRC field as a key field for a flow record, use the no form of this command. Command DefaultThe use of the SSRC field in RTP packet header as a key field for a user-defined flow record is not enabled by default. Usage GuidelinesA flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. The SSRC field in RTP packet header is used to identify a different stream source which is using the same protocol and source and destination IP address and port. match transport source-portTo configure the source port as a key field for a flow record, use the match transport source-portcommand in flow record configuration mode. To disable the use of the source port as a key field for a flow record, use the no form of this command. Command DefaultThe use of the source port as a key field for a user-defined flow record is not enabled by default. Usage GuidelinesA flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. match transport tcpTo configure one or more of the TCP fields as a key field for a flow record, use the match transport tcp command in flow record configuration mode. To disable the use of a TCP field as a key field for a flow record, use the no form of this command. see collect
match
transport
tcp
{acknowledgement-number | bytes out-of-order | destination-port | flags { [ack] | [cwr] | [ece] | [fin] | [psh] | [rst] | [syn] | [urg] } | header-length | maximum-segment-size | packets out-of-order | sequence-number | source-port | urgent-pointer | window-size | window-size-average | window-size-maximum | window-size-minimum}
no match
transport
tcp
{acknowledgement-number | bytes out-of-order | destination-port | flags { [ack] | [cwr] | [ece] | [fin] | [psh] | [rst] | [syn] | [urg] } | header-length | maximum-segment-size | packets out-of-order | sequence-number | source-port | urgent-pointer | window-size | window-size-average | window-size-maximum | window-size-minimum}
Syntax Description
Command DefaultThe use of one or more of the TCP fields as a key field for a user-defined flow record is not enabled by default. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the TCP acknowledgement flag as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport tcp flags ack The following example configures the TCP finish flag as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport tcp flags fin The following example configures the TCP reset flag as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport tcp flags rst The following example configures the transport destination port as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport tcp destination-port The following example configures the transport source port as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport tcp source-port match transport udpTo configure one or more of the user datagram protocol UDP fields as a key field for a Flexible NetFlow flow record, use the match transport udp command in Flexible NetFlow flow record configuration mode. To disable the use of a UDP field as a key field for a Flexible NetFlow flow record, use the no form of this command.
match
transport
udp
{destination-port | message-length | source-port}
no
match
transport
udp
{destination-port | message-length | source-port}
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command, however the mode prompt is the same for both products. For Performance Monitor, you must first enter the flow record type performance-monitor command before you can use this command. Because the mode prompt is the same for both products, here we refer to the command mode for both products as flow record configuration mode. However, for Flexible NetFlow, the mode is also known as Flexible NetFlow flow record configuration mode; and for Performance Monitor, the mode is also known as Performance Monitor flow record configuration mode. A flow record requires at least one key field before it can be used in a flow monitor. The key fields differentiate flows, with each flow having a unique set of values for the key fields. The key fields are defined using the match command. ExamplesThe following example configures the UDP destination port as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport udp destination-port The following example configures the UDP message length as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport udp message-length The following example configures the UDP source port as a key field: Router(config)# flow record FLOW-RECORD-1 Router(config-flow-record)# match transport udp source-port match vlanTo define the VLAN match criteria, use the match vlan command in class-map configuration or policy inline configuration mode. To remove the match criteria, use the no form of this command. Command Modes
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. These products use different commands to enter the configuration mode in which you issue this command. Use the match vlan command to specify which fields in the incoming packets are examined to classify the packets. Only the IP access group or the MAC access group matching the Ether Type/Len field are supported. Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SE You must first enter the service-policy type performance-monitor inlinecommand. ExamplesThe following example uses the VLAN ID as a match criterion:
Router(config)# class-map matchsrcmac
Router(config-cmap)# match vlan 2
Cisco Performance Monitor in Cisco IOS Release 15.1(3)T and 12.2(58)SEThe following example shows how to use the policy inline configuration mode to configure a service policy for Performance Monitor. The policy specifies that packets traversing Ethernet interface 0/0 that match the criteria of a VLAN ID of 2 will be monitored based on the parameters specified in the flow monitor configuration named fm-2: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# match vlan 2 Router(config-if-spolicy-inline)# flow monitor fm-2 Router(config-if-spolicy-inline)# exit max-dropout (policy RTP)To configure the maximum dropout metric for a Performance Monitor policy, use the max-dropoutcommand in policy RTP configuration mode. To remove the configuration, use the no form of this command. Command Modes
ExamplesThe following example shows how to set the maximum RTP dropout, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# monitor metric rtp Router(config-pmap-c-mrtp)# max-dropout 20 The following example shows how to set the maximum RTP dropout, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# monitor metric rtp Router(config-spolicy-inline-mrtp)# max-dropout 20 max-reorder (policy RTP)To configure the maximum reorder metric for a Performance Monitor policy, use the max-reordercommand in policy RTP configuration mode. To remove the configuration, use the no form of this command. Command Modes
ExamplesThe following example shows how to set the maximum RTP reorder, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# monitor metric rtp Router(config-pmap-c-mrtp)# max-reorder 20 The following example shows how to set the maximum RTP reorder, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# monitor metric rtp Router(config-spolicy-inline-mrtp)# max-reorder 20 min-sequential (policy RTP)To configure the mimimum number of packets in a sequence used to classify an RTP flow, use the min-sequentialcommand in policy RTP configuration mode. To remove the configuration, use the no form of this command. Command Modes
ExamplesThe following example shows how to set the mimimum number of packets in a sequence used to classify an RTP flow, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# monitor metric rtp Router(config-pmap-c-mrtp)# min-sequential 20 The following example shows how to set the mimimum number of packets in a sequence used to classify an RTP flow, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# monitor metric rtp Router(config-spolicy-inline-mrtp)# min-sequential 20 monitor metric ip-cbrTo configure IP-CBR monitor metrics for a Performance Monitor policy, use the monitor metric ip-cbrcommand in policy configuration mode. To remove the configuration, use the no form of this command. Command Modes
ExamplesThe following example shows how to set the layer 3 transmission rate to 10 gbps, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# monitor metric ip-cbr Router(config-pmap-c-mipcbr)# rate layer3 10 gbps The following example shows how to set the layer 3 transmission rate to 10 gbps, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# monitor metric ip-cbr Router(config-spolicy-inline-mipcbr)# rate layer3 10 gbps monitor metric rtpTo configure RTP monitor metrics for a Performance Monitor policy, use the monitor metric rtpcommand in policy configuration mode. To remove the configuration, use the no form of this command. Command Modes
ExamplesThe following example shows how to set the RTP monitor metrics, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# monitor metric rtp The following example shows how to set the RTP monitor metrics, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# monitor metric rtp monitor parametersTo configure monitor parameters for a Performance Monitor policy, use the monitor parameterscommand in policy configuration mode. To remove the configuration, use the no form of this command. Command Modes
ExamplesThe following example shows how to set the amount of time wait for a response when collecting data to 20 seconds, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# monitor parameters Router(config-pmap-c-mparam)# timeout 20 The following example shows how to set the amount of time wait for a response when collecting data to 20 seconds, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# monitor parameters Router(config-spolicy-inline-mparam)# timeout 20 option (Flexible NetFlow)To configure options data parameters for a flow exporter for Flexible NetFlow or Performance Monitor, use the option command in flow exporter configuration mode. To remove options for a flow exporter, use the no form of this command.
option
{application-table | exporter-stats | interface-table | sampler-table | vrf-table}
[timeout seconds]
no
option
{application-table | exporter-stats | interface-table | sampler-table | vrf-table}
Syntax Description
Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. option application-table This command causes the periodic sending of an options table, which will allow the collector to map the Network Based Application Recognition (NBAR) application IDs provided in the flow records to application names. The optional timeout can alter the frequency at which the reports are sent. option exporter-stats This command causes the periodic sending of the exporter statistics, including the number of records, bytes, and packets sent. This command allows your collector to estimate packet loss for the export records it is receiving. The optional timeout alters the frequency at which the reports are sent. option interface-table This command causes the periodic sending of an options table, which will allow the collector to map the interface SNMP indexes provided in the flow records to interface names. The optional timeout can alter the frequency at which the reports are sent. option sampler-table This command causes the periodic sending of an options table, which details the configuration of each sampler and allows the collector to map the sampler ID provided in any flow record to a configuration that it can use to scale up the flow statistics. The optional timeout can alter the frequency at which the reports are sent. option vrf-table This command causes the periodic sending of an options table, which will allow the collector to map the VRF IDs provided in the flow records to VRF names. The optional timeout can alter the frequency at which the reports are sent. ExamplesThe following example causes the periodic sending of the exporter statistics, including the number of records, bytes, and packets sent: Router(config)# flow exporter FLOW-EXPORTER-1 Router(config-flow-exporter)# option exporter-stats The following example causes the periodic sending of an options table, which allows the collector to map the interface SNMP indexes provided in the flow records to interface names: Router(config)# flow exporter FLOW-EXPORTER-1 Router(config-flow-exporter)# option interface-table The following example causes the periodic sending of an options table, which details the configuration of each sampler and allows the collector to map the sampler ID provided in any flow record to a configuration that it can use to scale up the flow statistics: Router(config)# flow exporter FLOW-EXPORTER-1 Router(config-flow-exporter)# option sampler-table The following example causes the periodic sending of an options table, which allows the collector to map the NBAR application IDs provided in the flow records to application names: Router(config)# flow exporter FLOW-EXPORTER-1 Router(config-flow-exporter)# option application-table The following example causes the periodic sending of an options table, which allows the collector to map the VRF IDs provided in the flow records to VRF names: Router(config)# flow exporter FLOW-EXPORTER-1 Router(config-flow-exporter)# option vrf-table output-featuresTo enable sending export packets for Flexible NetFlow or Performance Monitor using quality of service (QoS) or encryption, use the output-features command in flow exporter configuration mode. To disable sending export packets using QoS or encryption, use the no form of this command. Command DefaultIf QoS or encryption is configured on the router, neither QoS or encryption is run on Flexible NetFlow or Performance Monitor export packets. Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. If the router has the output feature quality of service (QoS) or encryption configured, the output-features command causes the output features to be run on Flexible NetFlow or Performance Monitor export packets. platform performance-monitor rate-limitTo set the rate limit for the Performance Monitor component of Feature Monitor, use the platform performance-monitorrate-limitcommand in global configuration mode. To return to the default value for the rate limit, use the no form of this command.
platform
performance-monitor
rate-limit
pps number
no platform
performance-monitor
rate-limit
pps number
ExamplesThe following example shows the how to set the rate limit for the Performance Monitor component of Feature Monitor.
Router(config)# platform performance-monitor rate-limit pps 2000
Related Commands
policy-map type performance-monitorTo configure a policy for Performance Monitor, use the policy-map type performance-monitorcommand in global configuration mode. To remove the policy, use the no form of this command. Usage GuidelinesIf you do not have an existing flow monitor, you can still configure a flow policy by using the flow monitor inline command to create a new flow monitor. rate layer3To configure a Layer 3 transmission rate for a Performance Monitor policy, use the rate layer3command in policy IP-CBR configuration mode. To remove the configuration, use the no form of this command.
rate
layer3
{rate-byte {bps | kbps | mbps | gbps} | packet}
no
rate
layer3
{rate-byte {bps | kbps | mbps | gbps} | packet}
Syntax Description
Command Modes
ExamplesThe following example shows how to set the Layer 3 transmission rate to 10 gbps, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# monitor metric ip-cbr Router(config-pmap-c-mipcbr)# rate layer3 10 gbps The following example shows how to set the Layer 3 transmission rate to 10 gbps, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# monitor metric ip-cbr Router(config-spolicy-inline-mipcbr)# rate layer3 10 gbps react (policy)To configure threshold parameters for a Performance Monitor policy, use the reactcommand in policy configuration mode. To disable all threshold monitoring or to disable individual monitored elements, use the no form of this command.
react
ID
{media-stop | mrv | rtp-jitter-average | transport-packets-lost-rate}
no
react
ID
{media-stop | mrv | rtp-jitter-average | transport-packets-lost-rate}
Syntax Description
Command Modes
ExamplesThe following example shows how to specify that SNMP MIB variables will receive an alarm or notification, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# react 2000 rtp-jitter-average Router(config-pmap-c-react)# action snmp The following example shows how to specify that SNMP MIB variables will receive an alarm or notification, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# react 2000 rtp-jitter-average Router(config-spolicy-inline-react)# action snmp record (Performance Monitor)To associate a flow record with a flow monitor for Performance Monitor, use the recordcommand in the appropriate Performance Monitor configuration mode. To remove the association, use the no form of this command.
record
{record-name | default-rtp | default-tcp}
no
record
{record-name | default-rtp | default-tcp}
Command Modes
Usage GuidelinesYou can associate a flow record with a flow monitor for Performance Monitor while configuring either a flow monitor, policy map, or service policy. rename (policy)service-policy type performance-monitorTo configure the association of a Performance Monitor policy to an interface, use the service-policy type performance-monitorcommand in interface configuration mode. To remove the association, use the no form of this command.
service-policy
type
performance-monitor
{{input | output} policy-name | inline {input | output}}
no
service-policy
type
performance-monitor
{{input | output} policy-name | inline {input | output}}
Syntax Description
Usage GuidelinesIf you do not have an existing flow policy, you can still association a flow policy to an interface by using the inline option to create a new flow policy. show performance monitor cacheTo display the contnet of the cache for Performance Monitor, use the show performance monitor cachecommand in privileged EXEC mode.
show
performance
monitor
cache
[policy policy map name class class map name]
[interface interface name]
Usage GuidelinesIf no flow policy or interface is specified, all for all flow policies and interfaces are shown. ExamplesThe following example shows the output for this command:
Router # show performance monitor cache
MMON Metering Layer Stats:
static pkt cnt: 3049
static cce sb cnt: 57
dynamic pkt cnt: 0
Cache type: Permanent
Cache size: 2000
Current entries: 8
High Watermark: 9
Flows added: 9
Updates sent ( 1800 secs) 0
IPV4 SRC ADDR IPV4 DST ADDR IP PROT TRNS SRC PORT TRNS DST PORT
ipv4 ttl ipv4 ttl min ipv4 ttl max ipv4 dscp bytes long perm pktslong perm user space vm
==========================================================================================
10.1.1.1 10.1.2.3 17 4000 1967
0 0 0 0x00 80
1 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000
10.1.1.1 10.1.2.3 17 6000 1967
0 0 0 0x00 80
1 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000
10.1.1.1 10.1.2.3 17 4000 2000
0 0 0 0x00 44
1 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000
10.1.1.1 10.1.2.3 6 6000 3000
0 0 0 0x00 84
2 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000
10.1.1.1 10.1.2.3 17 1967 6001
0 0 0 0x00 36
1 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000
10.1.1.1 10.1.2.3 17 1967 4001
0 0 0 0x00 36
1 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000
10.1.1.1 10.1.2.3 6 3001 6001
0 0 0 0x00 124
3 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000
10.1.1.1 10.1.2.3 17 2001 4001
0 0 0 0x00 44
1 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000
The table below describes the significant fields shown in the display.
show performance monitor clock rateTo display information about clock rates for performance monitor classes, use the show performance monitor clock ratecommand in privileged EXEC mode. Usage GuidelinesYou must have at least one active session before clock information can be displayed. ExamplesThe following example displays performance monitor clock rate information:
Router# show performance monitor clock rate
Load for five secs: 6%/2%; one minute: 5%; five minutes: 5% Time source is NTP, 17:41:35.508 EST Wed Feb 16 2011
RTP clock rate for Policy: all-apps-w-mask, Class: IPTV
Payload type Clock rate(Hz)
pcmu (0 ) 8000
gsm (3 ) 8000
g723 (4 ) 8000
dvi4 (5 ) 8000
dvi4-2 (6 ) 16000
lpc (7 ) 8000
pcma (8 ) 8000
g722 (9 ) 8000
l16-2 (10 ) 44100
l16 (11 ) 44100
qcelp (12 ) 8000
cn (13 ) 8000
mpa (14 ) 90000
g728 (15 ) 8000
dvi4-3 (16 ) 11025
dvi4-4 (17 ) 22050
g729 (18 ) 8000
celb (25 ) 90000
jpeg (26 ) 90000
nv (28 ) 90000
h261 (31 ) 90000
mpv (32 ) 90000
mp2t (33 ) 90000
h263 (34 ) 90000
default 90000
RTP clock rate for Policy: all-apps, Class: telepresence-CS4
Payload type Clock rate(Hz)
pcmu (0 ) 8000
gsm (3 ) 8000
g723 (4 ) 8000
dvi4 (5 ) 8000
dvi4-2 (6 ) 16000
lpc (7 ) 8000
pcma (8 ) 8000
g722 (9 ) 8000
l16-2 (10 ) 44100
l16 (11 ) 44100
qcelp (12 ) 8000
cn (13 ) 8000
mpa (14 ) 90000
g728 (15 ) 8000
dvi4-3 (16 ) 11025
dvi4-4 (17 ) 22050
g729 (18 ) 8000
celb (25 ) 90000
jpeg (26 ) 90000
nv (28 ) 90000
h261 (31 ) 90000
mpv (32 ) 90000
mp2t (33 ) 90000
h263 (34 ) 90000
(96 ) 48000
(112) 90000
default 90000
RTP clock rate for Policy: all-apps, Class: IPVS-traffic-rtp
Payload type Clock rate(Hz)
pcmu (0 ) 8000
gsm (3 ) 8000
g723 (4 ) 8000
dvi4 (5 ) 8000
dvi4-2 (6 ) 16000
lpc (7 ) 8000
pcma (8 ) 8000
g722 (9 ) 8000
l16-2 (10 ) 44100
l16 (11 ) 44100
qcelp (12 ) 8000
cn (13 ) 8000
mpa (14 ) 90000
g728 (15 ) 8000
dvi4-3 (16 ) 11025
dvi4-4 (17 ) 22050
g729 (18 ) 8000
celb (25 ) 90000
jpeg (26 ) 90000
nv (28 ) 90000
h261 (31 ) 90000
mpv (32 ) 90000
mp2t (33 ) 90000
h263 (34 ) 90000
(96 ) 30000
default 90000
The table below describes the significant fields shown in the display.
show performance monitor clientsTo display information about clients for performance monitor, use the show performance monitor clientscommand in privileged EXEC mode. Usage GuidelinesYou must have Cisco Mediatrace configured and at least one active session before client information can be displayed. ExamplesThe following example displays a list of performance monitor clients:
Router# show performance monitor clients list
Dynamic Video Monitor Client database list:
Total number of active clients: 1
ID name age(secs) flow(src,dst,src-port, dst-port)
1 Mediatrace-158244661 7498 10.10.10.1 1000 10.10.12.2 2000 17
The tables below describes the significant fields shown in the display. The following example displays details for all performance monitor clients:
Router# show performance monitor clients detail all
Client name for ID 1 : Mediatrace-131419052
Type: Mediatrace
Age: 443 seconds
Monitor Object: _MMON_DYN_-class-map-69
Flow spec: (dvmc-acl#47) 10.10.130.2 1000 10.10.132.2 2000 17
monitor parameters
interval duration 60
timeout 2
history 1
flows 100
monitor metric rtp
min-sequential 10
max-dropout 5
max-reorder 5
clock-rate 112 90000
clock-rate default 90000
ssrc maximum 20
monitor metric ip-cbr
rate layer3 packet 20
Flow record: dvmc_fnf_fdef_47
Key fields:
ipv4 source address
ipv4 destination address
transport source-port
transport destination-port
ip protocol
Non-key fields:
monitor event
application media event
routing forwarding-status
ip dscp
ip ttl
counter bytes rate
application media bytes rate
transport rtp jitter mean
transport packets lost counter
transport packets expected counter
transport event packet-loss counter
transport packets lost rate
timestamp interval
counter packets dropped
counter bytes
counter packets
application media bytes counter
application media packets counter
Monitor point: _MMON_DYN_-policy-map-70 GigabitEthernet0/3 output
Classification Statistic:
matched packet: 545790
matched byte: 64403220
The tables below describes the significant fields shown in the display.
show performance monitor historyTo display historical sets of statistics collected by Performance Monitor, use the flow performance monitor historycommand in privileged EXEC mode.
show
performance
monitor
history
[intervals {all | num}]
[policy policy map name class class map name]
[interface intf]
[filter]
Syntax Description
Command History
Usage GuidelinesIf no flow policy or interface is specified, statistics for all flow policies and interfaces are shown. For the Cisco IOS Release 15.2(2)T and Cisco IOS XE Release 3.5S, when you use the interface keyword, the output will usually be empty. This is because flows are not associated with an interface in these releases unless there is a user-defined record that includes the match interface command. The filter argument in the syntax = {[{any| network mask}][{eq| lt| gt number| range min max}][{any| network mask}][{eq| lt| gt number| range min max}] } ExamplesThe following example shows the output for this command:
Router # show performance monitor history
Codes: * - field is not configurable under flow record
NA - field is not applicable for configured parameters
Match: ipv4 source address = 21.21.21.1, ipv4 destination address = 1.1.1.1,
transport source-port = 10240, transport destination-port = 80, ip protocol = 6,
Policy: RTP_POL, Class: RTP_CLASS
start time 14:57:34
============
*history bucket number : 1
routing forwarding-status : Unknown
transport packets expected counter : NA
transport packets lost counter : NA
transport round-trip-time (msec) : 4
transport round-trip-time sum (msec) : 8
transport round-trip-time samples : 2
transport event packet-loss counter : 0
interface input : Null
interface output : Null
counter bytes : 8490
counter packets : 180
counter bytes rate : 94 counter client bytes : 80
counter server bytes : 200
counter client packets : 6
counter server packets : 6
transport tcp window-size minimum : 1000
transport tcp window-size maximum : 2000
transport tcp window-size average : 1500
transport tcp maximum-segment-size : 0
application media bytes counter : 1270
application media bytes rate : 14
application media packets counter : 180
application media event : Stop
monitor event : false
[data set,id=257] Global session ID|Multi-party session ID|
[data] 11 |22
The table below describes the significant fields shown in the display.
show performance monitor statusTo display the cumulative statistics collected by Performance Monitor during the specified number of most recent intervals, use the show performance monitor statuscommand in privileged EXEC mode.
show
performance
monitor
status
[interface interface name [ [filter] ] | policy policy map name class class map name [ [filter] ] | filter]
Syntax Description
Command History
Usage GuidelinesThis command displays the cumulative statistics for the specified number of most recent intervals. The number of intervals is configured using the history command. The default settings for this commands is 10 of the most recent collection intervals. The duration of collection intervals is specified by the interval durationcommand. For the Cisco IOS Release 15.2(2)T and Cisco IOS XE Release 3.5S, when you use the interface keyword, the output will usually be empty. This is because flows are not associated with an interface in these releases unless there is a user-defined record that includes the match interface command. If no flow policy or interface is specified, statistics for all flow policies and interfaces are shown. In the command syntax, the filter argument = {ip {source-addr source-prefix | any} {dst-addr dst-prefix | any} | {tcp | udp} {source-addr source-prefix | any} {[eq| lt| gt number| range min max| ssrc {ssrc-number | any} | {{dst-addr dst-prefix | any} eq| lt| gt number| range min max| ssrc {ssrc-number | any}} ExamplesThe following example shows the output for this command:
Router # show performance monitor status
Codes: * - field is not configurable under flow record
NA - field is not applicable for configured parameters
Match: ipv4 source address = 21.21.21.1, ipv4 destination address = 1.1.1.1,
transport source-port = 10240, transport destination-port = 80, ip protocol = 6,
Policy: RTP_POL, Class: RTP_CLASS
routing forwarding-status : Unknown
transport packets expected counter : NA
transport packets lost counter : NA
transport round-trip-time (msec) : 4
transport round-trip-time sum (msec) : 8
transport round-trip-time samples : 2
transport event packet-loss counter : 0
interface input : Null
interface output : Null
counter bytes : 8490
counter packets : 180
counter bytes rate : 94
application media bytes counter : 1270
application media bytes rate : 14
application media packets counter : 180
application media event : Stop
monitor event : false
The table below describes the significant fields shown in the display.
show platform hardware acl entry interfaceTo display information about inbound and outbound access control list (ACL) ternary content addressable memory (TCAM) interface entries, use the show platform hardware acl entry interface command in privileged EXEC mode.
show
platform
hardware
acl
entry interface
interface-type interface-number{security}{in | out}
{ip | ipv6}[detail]
Syntax Description
Usage GuidelinesThis command is available only on the Catalyst 6500 platform. This command is used primarily for troubleshooting purposes. It displays information about inbound and outbound access control list (ACL) ternary content addressable memory (TCAM) interface entries. If no interface is specified, information for all and interfaces are shown. Cisco IOS-based switches support the wire-rate ACL with use of the TCAM. Enabling ACLs and policies does not decrease the switching or routing performance of the switch as long as the ACLs are fully loaded in the TCAM. To implement the various types of ACLs in hardware, the Cisco IOS-based switches use hardware lookup tables (TCAM) and various hardware registers in the Supervisor Engine. When a packet arrives, the switch performs a hardware table lookup (TCAM lookup) and decides to either permit or deny the packet. ExamplesThe following example shows detailed IP information for the specified interface:
Router # show platform hardware acl entry interface FastEthernet 1/1 security in ip detail
mls_if_index:2000400A dir:0 feature:0 proto:0
pass#0 features
UAPRSF: U-urg, A-ack, P-psh, R-rst, S-syn, F-fin
MLGFI: M-mpls_plus_ip_pkt, L-L4_hdr_vld, G-gpid_present,F-global_fmt_match, I-ife/ofe
's' means set; 'u' means unset; '-' means don't care
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
I INDEX LABEL FS ACOS AS IP_SA SRC_PORT IP_DA DST_PORT F FF L4PROT TCP-F:UAPRSF MLGFI OtherL4OPs RSLT CNT
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
fno:0
tcam:B, bank:0, prot:0 Aces
I V 16375 2049 0 0 0 0.0.0.0 - 0.0.0.0 - 0 0 0 - ----- - 0x0000000800000038 10331192<-
I M 16375 0x1FFF 0 0x00 0x000 0.0.0.0 - 0.0.0.0 - 0 0 0x0
The table below describes the significant fields shown in the display.
Related Commands
show platform software ccmTo display information about ternary content addressable memory (TCAM) Cisco CallManager (CCM) entries, use the show platform software ccm command in privileged EXEC mode. Usage GuidelinesThis command is available only on the Catalyst 6500 platform. This command is used primarily for troubleshooting purposes. It displays information about dynamic and static policies for one or all interfaces. If no interface is specified, information for all and interfaces are shown. ExamplesThis command displays information about Cisco CallManager entries on inbound and outbound traffic on an interface: Router # show platform software ccm interface FastEthernet 2/3 in Target-Class : id 0xA0000000, dir CCM_INPUT, if_type 1, if_info 0x14823998 Class-Group List: 0xA0000001 b1-cs217#sh platform software ccm interface fastEthernet 2/3 out Target-Class : id 0xA0000002, dir CCM_OUTPUT, if_type 1, if_info 0x14823998 Class-Group List: 0xA0000001 The table below describes the significant fields shown in the display.
This command displays information about Cisco CallManager entries on inbound and outbound traffic for a class group:
Router # show platform software ccm class-group A0000001
Class-group : video-flow-test, id 0xA0000001
Target input : 0xA0000000
Target Output : 0xA0000002
Class : video-flow, id 0xA98681, type 1
Filter : type MATCH_NUMBERED_ACCESS_GROUP, id 0xF0000002
Filter params : ACL Index: 101 Linktype: 7
Feature : PERFORMANCE_MONITOR
Params :
Feature Object : 0x54224218
Name :
Meter context : 0x54264440
Sibling : 0x0
Dynamic : FALSE
Feature Object : 0x54221170
Name :
Meter context : 0x54263858
Sibling : 0x0
Dynamic : FALSE
Intf List : 0xA0000000 0xA0000002
Class : class-default, id 0xADA3F1, type 39
Filter : type MATCH_ANY, id 0xF0000003
Filter params : any
Feature : FEATURE_EMPTY
Params :
Feature Object : 0x1741629C
Name :
Meter context : 0x0
Sibling : 0x0
Dynamic : FALSE
Intf List : 0xA0000000 0xA0000002
The table below describes the significant fields shown in the display.
show platform software feature-manager performance-monitorTo display the cumulative statistics collected by Performance Monitor during the specified number of most recent intervals, use the show platform software feature-managerperformance-monitor command in privileged EXEC mode.
show
platform
software
feature-manager
performance-monitor
{all | handle ip ip-address | interface interface-type interface-number | rdt-indices}
Syntax Description
Usage GuidelinesThis command is available only on the Catalyst 6500 platform. This command is used primarily for troubleshooting purposes. It displays information about dynamic and static policies for one or all interfaces. If no interface is specified, information for all and interfaces are shown. ExamplesThe following example shows the output for this command for a specific interface. It is similar to the output for the show platform software feature-manager performance-monitor all command:
Router # show platform software feature-manager performance-monitor interface FastEthernet 2/3
Interface: FastEthernet2/3
Policy: video-flow-test Group ID: A0000001
-----------------------------------------------------------------------------
Feature: VM Ingress L3
=============================================================================
DPort - Destination Port SPort - Source Port Pro - Protocol
RFTCM - R-Recirc. Flag MRLCS - M-Multicast Flag Res - VMR Result
- F-Fragment flag - R-Reflexive flag Prec - Drop Precedence
- T-Trailing Fragments - L-Layer 3 only GrpId - Qos Group Id
- C-From CPU - C-Capture Flag Adj. - Adj. Index
- M-L2 Lookup Miss - S-RPF suppress Pid - NF Profile Index
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
| Indx|T| Dest Ip Addr | Source Ip Addr|DPort|SPort|Pro|RFTCM|Prec|MRLCS|Pid|
| |Stats Id|
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
1 V 224.0.0.0 0.0.0.0 0 0 0 ----- 0 -----
M 240.0.0.0 0.0.0.0 0 0 0 00000 0 0
PERMIT_RESULT
2 V 0.0.0.0 0.0.0.0 0 0 0 ----- 0 -----
M 0.0.0.0 0.0.0.0 0 0 0 00000 0 0
L3_DENY_RESULT
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
| Indx|T| Dest Ip Addr | Source Ip Addr|DPort|SPort|Pro|RFTCM|Prec|MRLCS|Pid|
| |Stats Id|
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
1 V 0.0.0.0 10.10.10.0 0 0 17 ----- 0 ---C-
M 0.0.0.0 255.255.255.0 0 0 255 00000 0 0
PERMIT_RESULT
2 V 0.0.0.0 10.10.20.0 0 0 17 ----- 0 ---C-
M 0.0.0.0 255.255.255.0 0 0 255 00000 0 0
PERMIT_RESULT
3 V 0.0.0.0 0.0.0.0 0 0 0 ----- 0 -----
M 0.0.0.0 0.0.0.0 0 0 0 00000 0 0
L3_DENY_RESULT
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
| Indx|T| Dest Ip Addr | Source Ip Addr|DPort|SPort|Pro|RFTCM|Prec|MRLCS|Pid|
| |Stats Id|
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
1 V 0.0.0.0 0.0.0.0 0 0 0 ----- 0 -----
M 0.0.0.0 0.0.0.0 0 0 0 00000 0 0
PERMIT_RESULT
Interface: FastEthernet2/3
Policy: video-flow-test Group ID: A0000001
-----------------------------------------------------------------------------
Feature: VM Egress L3
=============================================================================
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
| Indx|T| Dest Ip Addr | Source Ip Addr|DPort|SPort|Pro|RFTCM|Prec|MRLCS|Pid|
| |Stats Id|
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
1 V 224.0.0.0 0.0.0.0 0 0 0 ----- 0 -----
M 240.0.0.0 0.0.0.0 0 0 0 00000 0 0
PERMIT_RESULT
2 V 0.0.0.0 0.0.0.0 0 0 0 ----- 0 -----
M 0.0.0.0 0.0.0.0 0 0 0 00000 0 0
L3_DENY_RESULT
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
| Indx|T| Dest Ip Addr | Source Ip Addr|DPort|SPort|Pro|RFTCM|Prec|MRLCS|Pid|
| |Stats Id|
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
1 V 0.0.0.0 10.10.10.0 0 0 17 ----- 0 -----
M 0.0.0.0 255.255.255.0 0 0 255 00000 0 0
PERMIT_RESULT Adjacency: 0x5512D8F4
2 V 0.0.0.0 10.10.20.0 0 0 17 ----- 0 -----
M 0.0.0.0 255.255.255.0 0 0 255 00000 0 0
PERMIT_RESULT Adjacency: 0x5512D8F4
3 V 0.0.0.0 0.0.0.0 0 0 0 ----- 0 -----
M 0.0.0.0 0.0.0.0 0 0 0 00000 0 0
L3_DENY_RESULT
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
| Indx|T| Dest Ip Addr | Source Ip Addr|DPort|SPort|Pro|RFTCM|Prec|MRLCS|Pid|
| |Stats Id|
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
1 V 0.0.0.0 0.0.0.0 0 0 0 ----- 0 -----
M 0.0.0.0 0.0.0.0 0 0 0 00000 0 0
PERMIT_RESULT Adjacency: 0x5512D8F4
Adjacency: 0x5512D8F4
FeatureId: 0x84 AdjId: 0xFFFFFFFF Flags: RecirculationAdj|
Cause: 0x0 Priority: 0xC
The table below describes the significant fields shown in the display.
The following example shows the output for this command for counters:
Router # show platform software feature-manager performance-monitor counters
General Counters
------------------------------------------------------------+-----------------+
Number of times video monitoring enabled : 2
Number of times ingress handler registered : 1
Number of times egress handler registered : 1
Ingress Packet Counters
------------------------------------------------------------+-----------------+
Packets dropped in handler due to NULL block/packet/dbus : 0
Packets seen by vm interrupt handler : 165246090
Packets ingress interface locate failure : 0
Packets accepted by vm interrupt handler : 165246090
Packets consumed by clone path : 165246090
Packets hits on static policy on Routed port/L2 Vlan : 165246090
Packets hits on static policy on switched port : 0
Packets hits on static policy on L3 Vlan : 0
Packets hits on dynamic policy on Routed port/L2 Vlan : 0
Packets hits on dynamic policy on switched port : 0
Packets hits on dynamic policy on L3 Vlan : 0
Packets rate-limited at interrupt handler : 0
Packets TTL decrements at ingress handler : 5121
Egress Packet Counters
------------------------------------------------------------+-----------------+
Packets dropped in handler due to NULL block/packet/dbus : 0
Packets seen by vm interrupt handler : 3288018307
Packets egress interface locate failure : 0
Packets accepted by vm interrupt handler : 3288018307
Packets consumed by clone path : 3288018307
Packets hits on static policy : 3288018307
Packets hits on static policy on L2 Vlan interface : 0
Packets hits on dynamic policy on L2 Vlan interface : 0
Packets hits on dynamic policy : 0
Packets rate-limited at interrupt handler : 0
Packets TTL decrements at egress handler : 3288018307
CEF Path Counters
------------------------------------------------------------+-----------------+
Number of failures due to null packet : 0
Number of failures due to null ingress interface : 0
Number of failures due to null egress interface : 0
Number of packets seen in ingress cef path : 0
Number of packets seen in egress cef path : 0
Number of null feature objects in ingress cef path : 0
Number of null feature objects in egress cef path : 0
Other Features Check
------------------------------------------------------------+-----------------+
Router Index Counter : 0
Bridge Index Counter : 0
CPU region LTL counter : 0
The following example shows the output for this command for RDT indices:
Router # show platform software feature-manager performance-monitor rdt-indices
Flags: D - Dynamic, S - Static
+-------+-----------+-------+------+-----------+-------+----------+
| Index | RDT FID |RDT IDX| Vlan | L3 IDB | Flags | Next Ptr |
+-------+-----------+-------+------+-----------+-------+----------+
14 0x000F0001 0x090E 0 0x52CA34F4 S 0x00000000
The table below describes the significant fields shown in the display. Related Commands
show platform software feature-manager tcamTo display information about dynamic ternary content addressable memory (TCAM) entries for the Performance Monitor component of Feature Manager, use the show platform software feature-manager tcam command in privileged EXEC mode.
show
platform
software
feature-manager
tcam dynamic performance-monitor{handle ipip-address | interface interface-type interface-number}
Usage GuidelinesThis command is available only on the Catalyst 6500 platform. This command is used primarily for troubleshooting purposes. It displays information about dynamic TCAM entries for the Performance Monitor component of Feature Manager for one or all interfaces or hosts. If no interface or host is specified, information for all and interfaces are shown. ExamplesThe following example shows dynamic TCAM entries for the specified host:
Router # show platform software feature-manager tcam dynamic performance-monitor handle ip 10.1.1.0
-----------------------------------------------------------------------------
HANDLE Feature ID No of entries MD5
-----------------------------------------------------------------------------
10.1.1.0 VM Ingress L3 2
The table below describes the significant fields shown in the display.
The following example shows dynamic TCAM entries for the specified interface: Router # show platform software feature-manager tcam dynamic performance-monitor interface FastEthernet 2/26
No Dynamic entries found on interface FastEthernet2/26 in ingress direction
-----------------------------------------------------------------------------
Dynamic feature ID :VM EGRESS L3 Direction : Egress
Interface : Fa2/26
=============================================================================
HANDLE 160.0.0.4 No of entries 2 Protocol IP
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
| Indx|T| Dest Ip Addr | Source Ip Addr|DPort|SPort|Pro|RFTCM|Prec|MRLCS|Pid|
| |Stats Id|
+-----+-+---------------+---------------+-----+-----+---+-----+----+-----+---+-+
1 V 10.10.20.2 10.10.10.2 0 0 17 --T-- 0 ---C-
M 255.255.255.255 255.255.255.255 0 0 255 00100 0 0
PERMIT_RESULT
2 V 10.10.20.2 10.10.10.2 10000 1000 17 ----- 0 ---C-
M 255.255.255.255 255.255.255.255 65535 65535 255 00000 0 0
PERMIT_RESULT
Related Commands
show policy-map type performance-monitorTo display policy-map statistics for Performance Monitor, use the show policy-map type performance-monitorcommand in privileged EXEC mode.
show
policy-map
type
performance-monitor
[interface interface-name]
[class class-name]
[input | output]
Syntax Description
Usage GuidelinesIf no interface or class is specified, statistics for all interfaces and classes associated with a performance-monitor policy-map are shown. ExamplesThe following example shows the output for this command for one Flow Policy::
Router # show policy-map type performance-monitor
Policy Map type performance-monitor PM-POLICY-4
Class PM-CLASS-4
flow monitor PM-MONITOR-4
record PM-RECORD-4
exporter PM-EXPORTER-4
monitor parameters
interval duration 30
timeout 10
history 10
flows 8000
monitor metric rtp
min-sequential 5
max-dropout 5
max-reorder 5
clock-rate default 90000
ssrc maximum 5
The table below describes the significant fields shown in the display.
source (Flexible NetFlow)To configure the source IP address interface for all of the packets sent by a flow exporter for Flexible NetFlow or Performance Monitor, use the source command in flow exporter configuration mode. To remove the source IP address interface for all of the packets sent by a flow exporter, use the no form of this command. Command DefaultThe IP address of the interface over which the Flexible NetFlow or Performance Monitor datagram is transmitted is used as the source IP address. Command History
Usage GuidelinesThis command can be used with both Flexible NetFlow and Performance Monitor. The benefits of using a consistent IP source address for the datagrams that NetFlow sends include the following:
ssrc maximumTo configure the SSRC maximum metrics for a Performance Monitor policy, use the ssrc maximumcommand in policy RTP configuration mode. To remove the configuration, use the no form of this command. Command Modes
Usage GuidelinesIt is not recommended that you limit the maximum number of SSRCs that can be monitored within same flow by using the ssrc maximumkeyword.The flow engine will not learn new SSRC sessions once the maximum number is meet until a discovered flow is removed. Setting the value high will help to avoid the unexpected denial-of-service attacks. ExamplesThe following example shows how to set the SSRC maximum, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# monitor metric rtp Router(config-pmap-c-mrtp)# ssrc maximum 40 The following example shows how to set the SSRC maximum, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# monitor metric rtp Router(config-spolicy-inline-mrtp)# ssrc maximum 40 template data timeoutTo configure the template resend timeout for a flow exporter, use the template data timeout command in flow exporter configuration mode. To remove the template resend timeout for a flow exporter, use the no form of this command. Command History
theshold value (policy-react and policy-inline-react)To configure the threshold that determines whether alarms are sent for a Performance Monitor policy, use the threshold valuecommand in policy configuration mode and policy inline react configuration mode. To remove the threshold setting, use the no form of this command.
threshold
value
{ge number | gt number | le number | lt number | range rng-start rng-end}
no
threshold
value
{ge number | gt number | le number | lt number | range rng-start rng-end}
Syntax Description
Command Modes
ExamplesThe following example shows how to specify that alarms are sent if a value exceeds a threshold of 20, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# react 2000 rtp-jitter-average Router(config-pmap-c-react)# threshold gt 20 The following example shows how to specify that alarms are sent if a value exceeds a threshold of 20, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# react 2000 rtp-jitter-average Router(config-spolicy-inline-react)# threshold gt 20 timeout (monitor parameters)To configure the amount of time to wait before a stopped flow is removed from the Performance Monitor database, use the monitor parameterscommand in monitor parameters configuration mode. To remove the configuration, use the no form of this command. Command Modes
ExamplesThe following example shows how to set the amount of time wait for a response when collecting data to 20 intervals, while configuring a policy-map: Router(config)# policy-map type performance-monitor policy-4 Router(config-pmap)# class PM-CLASS-4 Router(config-pmap-c)# monitor parameters Router(config-pmap-c-mparam)# timeout 20 The following example shows how to set the amount of time wait for a response when collecting data to 20 intervals, while associating a service-policy with an interface: Router(config)# interface ethernet 0/0 Router(config-if)# service-policy type performance-monitor inline input Router(config-if-spolicy-inline)# monitor parameters Router(config-spolicy-inline-mparam)# timeout 20 transport (Flexible NetFlow)To configure the transport protocol for a flow exporter for Flexible NetFlow or Performance Monitor, use the transport command in flow exporter configuration mode. To remove the transport protocol for a flow exporter, use the no form of this command. Command History
ttl (Flexible NetFlow)To configure the time-to-live (TTL) value for a flow exporter for Flexible NetFlow or Performance Monitor, use the ttl command in flow exporter configuration mode. To remove the TTL value for a flow exporter, use the no form of this command. Command History
© 2012 Cisco Systems, Inc. All rights reserved.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|