![]() |
Table Of Contents
Restrictions for the IP SLAs ICMP Jitter Operation
Information About the IP SLAs ICMP Jitter Operation
Benefits of the IP SLAs ICMP Jitter Operation
Statistics Measured by the IP SLAs ICMP Jitter Operation
How to Configure the IP SLAs ICMP Jitter Operation
Configuring an IP SLAs ICMP Jitter Operation
Configuration Examples for the IP SLAs ICMP Jitter Operation
Configuring an IP SLAs ICMP Jitter Operation: Example
Feature Information for the IP SLAs ICMP Jitter Operation
IP SLAs ICMP Jitter Operation
First Published: February 27, 2006Last Updated: February 27, 2006The Cisco IOS IP Service Level Agreements (SLAs) Internet Control Message Protocol (ICMP) Jitter Operation feature provides the capability to generate a stream of ICMP packets between a Cisco IOS device (source) and any other IP device (destination) to gather network performance-related statistics. The destination device can be any network device that supports ICMP such as a server or workstation. Available statistical measurements for the IP SLAs ICMP jitter operation include latency, round-trip time, jitter (interpacket delay variance), and packet loss. The IP SLAs ICMP jitter operation does not require configuration of the IP SLAs Responder feature on the destination device.
Finding Feature Information in This Module
Your Cisco IOS software release may not support all of the features documented in this module. To reach links to specific feature documentation in this module and to see a list of the releases in which each feature is supported, use the "Feature Information for the IP SLAs ICMP Jitter Operation" section.
Finding Support Information for Platforms and Cisco IOS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.
Contents
•
Restrictions for the IP SLAs ICMP Jitter Operation
•
Information About the IP SLAs ICMP Jitter Operation
•
How to Configure the IP SLAs ICMP Jitter Operation
•
Configuration Examples for the IP SLAs ICMP Jitter Operation
•
Feature Information for the IP SLAs ICMP Jitter Operation
Restrictions for the IP SLAs ICMP Jitter Operation
•
When compared to the IP SLAs User Datagram Protocol (UDP) jitter operation, the IP SLAs ICMP jitter operation may provide less accurate measurements because the accuracy of the measurements provided by a non-Cisco destination device cannot be determined.
•
Since ICMP packets do not support voice technology, the IP SLAs ICMP jitter operation does not support Mean Opinion Score (MOS), Calculated Planning Impairment Factor (ICPIF), or estimated transmission rating factor (R) reaction configuration capabilities.
Information About the IP SLAs ICMP Jitter Operation
To configure an IP SLAs ICMP jitter operation, you should understand the following concepts:
•
Benefits of the IP SLAs ICMP Jitter Operation
•
Statistics Measured by the IP SLAs ICMP Jitter Operation
Benefits of the IP SLAs ICMP Jitter Operation
The IP SLAs ICMP Jitter Operation feature provides the following key benefits:
•
End-to-end performance measurements between a Cisco device (source) and any other IP device (destination) using ICMP.
•
Proactive threshold violation monitoring through Simple Network Management Protocol (SNMP) trap notifications and syslog messages.
Statistics Measured by the IP SLAs ICMP Jitter Operation
The IP SLAs ICMP jitter operation supports the following statistical measurements:
•
Jitter (source-to-destination and destination-to-source)
•
Latency (source-to-destination and destination-to-source)
•
Round-trip time latency
•
Packet loss
•
Successive packet loss
•
Out-of-sequence packets (source-to-destination, destination-to-source, and round-trip)
•
Late packets
Obtaining separate measurements for the source-to-destination and destination-to-source data paths can be useful for identifying problems in your network because the paths may be different (asymmetric),
How to Configure the IP SLAs ICMP Jitter Operation
This section contains the following task:
•
Configuring an IP SLAs ICMP Jitter Operation
Configuring an IP SLAs ICMP Jitter Operation
Perform this task to configure and schedule an IP SLAs ICMP jitter operation.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
ip sla operation-number
4.
icmp-jitter {destination-ip-address | destination-hostname} [interval milliseconds] [num-packets packet-number] [source-ip {ip-address | hostname}]
5.
frequency seconds
6.
history history-parameter
7.
owner owner-id
8.
tag text
9.
threshold milliseconds
10.
timeout milliseconds
11.
tos number
12.
vrf vrf-name
13.
exit
14.
ip sla reaction-configuration operation-number react monitored-element [action-type option] [threshold-type {average [number-of-measurements] | consecutive [occurrences] | immediate | never | xofy [x-value y-value]}] [threshold-value upper-threshold lower-threshold]
15.
ip sla schedule operation-number [life {forever | seconds}] [start-time {hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss] [ageout seconds] [recurring]
16.
exit
17.
show ip sla configuration [operation-number]
DETAILED STEPS
Troubleshooting Tips
Use the debug ip sla trace and debug ip sla error commands to help troubleshoot issues with an IP SLAs operation.
What to Do Next
To view and interpret the results of an IP SLAs operation use the show ip sla statistics and show ip sla statistics aggregated commands. Checking the output for fields that correspond to criteria in your service level agreement will help you determine whether the service metrics are acceptable.
Configuration Examples for the IP SLAs ICMP Jitter Operation
This section provides the following configuration example:
•
Configuring an IP SLAs ICMP Jitter Operation: Example
Configuring an IP SLAs ICMP Jitter Operation: Example
The following example shows how to configure an IP SLAs ICMP jitter operation:
ip sla 1icmp-jitter 172.18.1.129 interval 40 num-packets 100 source-ip 10.1.2.34frequency 50!ip sla reaction-configuration 1 react jitterAvg threshold-value 5 2 action-type trap threshold-type immediate!ip sla schedule 1 start-time now life forever
Where to Go Next
•
If you want to configure multiple Cisco IOS IP SLAs operations at once, see the "IP SLAs—Multiple Operation Scheduling" chapter of the Cisco IOS IP SLAs Configuration Guide, Release 12.4.
•
If you want to configure threshold parameters for an IP SLAs operation, see the "IP SLAs—Proactive Threshold Monitoring" chapter of the Cisco IOS IP SLAs Configuration Guide, Release 12.4.
•
If you want to configure other types of IP SLAs operations, see the "Where to Go Next" section of the "Cisco IOS IP SLAs Overview" chapter of the Cisco IOS IP SLAs Configuration Guide, Release 12.4.
Additional References
The following sections provide references related to the IP SLAs ICMP Jitter Operation feature.
Related Documents
Related Topic Document TitleIP SLAs UDP jitter operation
"IP SLAs—Analyzing IP Service Levels Using the UDP Jitter Operation" chapter of the Cisco IOS IP SLAs Configuration Guide, Release 12.4
Cisco IOS IP SLAs command line interface enhancements for Cisco IOS Releases 12.4 and 12.4T
Cisco IOS IP Service Level Agreements Command Line Interface, Cisco white paper
http://www.cisco.com/en/US/products/ps6602/products_white_paper0900aecd8022c2cc.shtml
Cisco IOS IP SLAs configuration tasks
Cisco IOS IP SLAs Configuration Guide, Release 12.4
Cisco IOS IP SLAs commands
Cisco IOS IP SLAs Command Reference, Release 12.4T
Standards
Standard TitleNo new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.
—
MIBs
MIB MIBs Link•
CISCO-RTTMON-MIB
•
CISCO-RTTMON-ICMP-MIB
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:
RFCs
RFC TitleNo new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.
—
Technical Assistance
Command Reference
This section documents new and modified commands only.
•
ip sla reaction-configuration
icmp-jitter
To configure an IP Service Level Agreements (SLAs) Internet Control Message Protocol (ICMP) jitter operation, use the icmp-jitter command in IP SLA configuration mode.
icmp-jitter {destination-ip-address | destination-hostname} [interval milliseconds] [num-packets packet-number] [source-ip {ip-address | hostname}]
Syntax Description
Command Default
No IP SLAs operation type is configured for the operation being configured.
Command Modes
IP SLA configuration (config-ip-sla)
Command History
Usage Guidelines
You must configure the type of IP SLAs operation (such as User Datagram Protocol [UDP] jitter or Internet Control Message Protocol [ICMP] echo) before you can configure any of the other parameters of the operation. To change the operation type of an existing IP SLAs operation, you must first delete the IP SLAs operation (using the no ip sla global configuration command) and then reconfigure the operation with the new operation type.
Examples
The following example shows how to configure an IP SLAs ICMP jitter operation:
ip sla 1icmp-jitter 172.18.1.129 interval 40 num-packets 100 source-ip 10.1.2.34frequency 50!ip sla reaction-configuration 1 react jitterAvg threshold-value 5 2 action-type trap threshold-type immediate!ip sla schedule 1 start-time now life foreverRelated Commands
Command Descriptionip sla
Begins configuration for an IP SLAs operation and enters IP SLA configuration mode.
ip sla reaction-configuration
To configure certain actions to occur based on events under the control of Cisco IOS IP Service Level Agreements (SLAs), use the ip sla reaction-configuration command in global configuration mode. To clear all reaction configuration for a specified IP SLAs operation, use the no form of this command.
ip sla reaction-configuration operation-number react monitored-element [action-type option] [threshold-type {average [number-of-measurements] | consecutive [occurrences] | immediate | never | xofy [x-value y-value]}] [threshold-value upper-threshold lower-threshold]
no ip sla reaction-configuration operation-number
Syntax Description
operation-number
Number of the IP SLAs operation for which reactions are to be configured.
react monitored-element
(Optional) Specifies the element to be monitored for violations.
Note
The elements available for monitoring will vary depending on the type of IP SLAs operation you are running.
Keyword options for the monitored-element argument are as follows:
•
connectionLoss—Specifies that a reaction should occur if there is a one-way connection loss for the monitored operation. The threshold-value keyword does not apply to this monitored element.
•
frameLossDS—Specifies that a reaction should occur if the one-way destination-to-source digital signal processor (DSP) frame loss value violates the upper threshold or lower threshold.
•
iaJitterDS—Specifies that a reaction should occur if the one-way destination-to-source interarrival jitter value violates the upper threshold or lower threshold.
•
iaJitterSD—Specifies that a reaction should occur if the one-way source-to-destination interarrival jitter value violates the upper threshold or lower threshold.
•
icpif—Specifies that a reaction should occur if the one-way Calculated Planning Impairment Factor (ICPIF) value violates the upper threshold or lower threshold.
•
jitterAvg—Specifies that a reaction should occur if the average round-trip jitter value violates the upper threshold or lower threshold.
•
jitterDSAvg—Specifies that a reaction should occur if the average one-way destination-to-source jitter value violates the upper threshold or lower threshold.
•
jitterSDAvg—Specifies that a reaction should occur if the average one-way source-to-destination jitter value violates the upper threshold or lower threshold.
react monitored-element (continued)
•
latencyDSAvg—Specifies that a reaction should occur if the average one-way destination-to-source latency value violates the upper threshold or lower threshold.
•
latencySDAvg—Specifies that a reaction should occur if the average one-way source-to-destination latency value violates the upper threshold or lower threshold.
•
maxOflatencyDS—Specifies that a reaction should occur if the one-way maximum latency destination-to-source threshold is violated.
•
maxOflatencySD—Specifies that a reaction should occur if the one-way maximum latency source-to-destination threshold is violated.
•
maxOfNegativeDS—Specifies that a reaction should occur if the one-way maximum negative jitter destination-to-source threshold is violated.
•
maxOfNegativeSD—Specifies that a reaction should occur if the one-way maximum negative jitter source-to-destination threshold is violated.
•
maxOfPositiveDS—Specifies that a reaction should occur if the one-way maximum positive jitter destination-to-source threshold is violated.
•
maxOfPositiveSD—Specifies that a reaction should occur if the one-way maximum positive jitter source-to-destination threshold is violated.
•
mos—Specifies that a reaction should occur if the one-way Mean Opinion Score (MOS) value violates the upper threshold or lower threshold.
•
moscqds—Specifies that a reaction should occur if the one-way destination-to-source Mean Opinion Score for Conversational Quality (MOS-CQ) value violates the upper threshold or lower threshold.
•
moscqsd—Specifies that a reaction should occur if the one-way source-to-destination Mean Opinion Score for Conversational Quality (MOS-CQ) value violates the upper threshold or lower threshold.
•
moslqds—Specifies that a reaction should occur if the one-way destination-to-source Mean Opinion Score for Listening Quality (MOS-LQ) value violates the upper threshold or lower threshold.
•
packetLateArrival—Specifies that a reaction should occur if the one-way number of late packets violates the upper threshold or lower threshold.
react monitored-element (continued)
•
packetLoss—Specifies that a reaction should occur if the packet loss value violates the upper threshold or lower threshold. The path of the packets is unknown.
•
packetLossDS—Specifies that a reaction should occur if the one-way destination-to-source packet loss value violates the upper threshold or lower threshold.
•
packetLossSD—Specifies that a reaction should occur if the one-way source-to-destination packet loss value violates the upper threshold or lower threshold.
•
packetMIA—Specifies that a reaction should occur if the one-way number of missing packets violates the upper threshold or lower threshold.
•
packetOutOfSequence—Specifies that a reaction should occur if the one-way number of packets out of sequence violates the upper threshold or lower threshold.
•
rFactorDS—Specifies that a reaction should occur if the one-way destination-to-source estimated transmission rating factor R violates the upper threshold or lower threshold.
•
rFactorSD—Specifies that a reaction should occur if the one-way source-to-destination estimated transmission rating factor R violates the upper threshold or lower threshold.
•
rtt—Specifies that a reaction should occur if the round-trip time violates the upper threshold or lower threshold.
•
successivePacketLoss—Specifies that a reaction should occur if the one-way number of successively dropped packets violates the upper threshold or lower threshold.
•
timeout—Specifies that a reaction should occur if there is a one-way timeout for the monitored operation. The threshold-value keyword does not apply to this monitored element.
•
verifyError—Specifies that a reaction should occur if there is a one-way error verification violation. The threshold-value keyword does not apply to this monitored element.
action-type option
(Optional) Specifies what action or combination of actions the operation performs when threshold events occur. If the threshold-type never keywords are defined, the action-type keyword is disabled. The option argument can be one of the following keywords:
•
none—No action is taken. This option is the default value.
•
trapAndTrigger—Trigger a Simple Network Management Protocol (SNMP) trap and start another IP SLAs operation when the violation conditions are met, as defined in the trapOnly and triggerOnly options.
•
trapOnly—Send an SNMP logging trap when the specified violation type occurs for the monitored element. IP SLAs logging traps are enabled using the ip sla logging traps command.
•
triggerOnly—Have one or more target operation's operational state make the transition from pending to active when the violation conditions are met. The target operations to be triggered are specified using the ip sla reaction-trigger command. A target operation will continue until its life expires, as specified by the target operation's configured lifetime value. A triggered target operation must finish its life before it can be triggered again.
threshold-type average [number-of-measurements]
(Optional) When the average of a specified number of measurements for the monitored element exceeds the upper threshold or when the average of a specified number of measurements for the monitored element drops below the lower threshold, perform the action defined by the action-type keyword. For example, if the upper threshold for react rtt threshold-type average 3 is configured as 5000 ms and the last three results of the operation are 6000, 6000, and 5000 ms, the average would be 6000 + 6000 + 5000 = 17000/3 = 5667, thus violating the 5000 ms upper threshold.
The default number of 5 averaged measurements can be changed using the number-of-measurements argument. The valid range is from 1 to 16.
This syntax is not available if the connectionLoss, timeout, or verifyError keyword is specified as the monitored element, because upper and lower thresholds do not apply to these options.
threshold-type consecutive [occurrences]
(Optional) When the reaction conditions (such as threshold violations) for the monitored element are met consecutively for a specified number of times, perform the action defined by the action-type keyword.
The default number of 5 consecutive occurrences can be changed using the occurrences argument. The valid range is from 1 to 16.
The occurrences value will appear in the output of the show ip sla reaction-configuration command as the "Threshold Count" value.
threshold-type immediate
(Optional) When the reaction conditions (such as threshold violations) for the monitored element are met, immediately perform the action defined by the action-type keyword.
threshold-type never
(Optional) Do not calculate threshold violations. This is the default threshold type.
threshold-type xofy [x-value y-value]
(Optional) When the reaction conditions (such as threshold violations) for the monitored element are met x number of times within the last y number of measurements ("x of y"), perform the action defined by the action-type keyword.
The default is 5 for both the x and y values (xofy 5 5). The valid range for each value is from 1 to 16.
The x-value will appear in the output of the show ip sla reaction-configuration command as the "Threshold Count" value, and the y-value will appear as the "Threshold Count2" value.
threshold-value upper-threshold lower-threshold
(Optional) Specifies the upper-threshold and lower-threshold values of the applicable monitored elements. See Table 1 in the "Usage Guidelines" section for a list of the default values.
Note
For MOS threshold values (react mos), the number is expressed in three digits representing ones, tenths, and hundredths. For example, to express a MOS threshold of 3.20, enter 320. The valid range is from 100 (1.00) to 500 (5.00).
Defaults
No IP SLAs reactions are generated.
Error verification is disabled.
Connection loss and timeout logging are disabled.
Note
See Table 1 in the "Usage Guidelines" section for a list of the default upper and lower thresholds for specific monitored elements.
Command Modes
Global configuration
Command History
Usage Guidelines
You can configure the ip sla reaction-configuration command multiple times to allow reactions for multiple monitored elements (for example, configuring thresholds for destination-to-source packet loss and MOS) for the same operation. However, entering the no ip sla reaction-configuration operation-number command will clear all reaction configuration for the specified operation. In other words, disabling of granular reaction elements (for example, entering the no ip sla reaction-configuration operation-number react monitored-element command) is not supported, so as to provide backwards compatibility with the earlier version of this command.
SNMP traps for IP SLAs are supported by the CISCO-RTTMON-MIB and CISCO-SYSLOG-MIB. The ip sla logging traps command is used to enable the generation of SNMP traps specific to IP SLAs threshold violations.
You can check the configuration of the IP SLAs reaction configuration using the show ip sla reaction-configuration command.
Note
Keywords are not case sensitive and are shown in mixed case for readability only.
Table 1 lists the default upper and lower thresholds for specific monitored elements.
Examples
In the following example, IP SLAs operation 10 (a UDP jitter operation) is configured to send an SNMP logging trap when the MOS value exceeds 4.9 (best quality) or falls below 2.5 (poor quality):
ip sla reaction-configuration 10 react mos threshold-type immediate threshold-value 490 250 action-type trapOnlyRelated Commands
Feature Information for the IP SLAs ICMP Jitter Operation
Table 2 lists the feature release history for this feature.
Not all commands may be available in your Cisco IOS software release. For release information about a specific command, see the command reference documentation.
Cisco IOS software images are specific to a Cisco IOS software release, a feature set, and a platform. Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.
Note
Table 2 lists only the Cisco IOS software release that introduced support for a given feature in a given Cisco IOS software release train. Unless noted otherwise, subsequent releases of that Cisco IOS software release train also support that feature.
© 2006 Cisco Systems, Inc. All rights reserved.