IP SLA Cisco Book
IP SLA Cisco Book
IP SLA Cisco Book
Release 12.4T
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
CONTENTS
IP SLAs Overview 0
Finding Feature Information 1
Information About IP SLAs 1
IP SLAs Technology Overview 2
Service Level Agreements 3
Benefits of IP SLAs 4
Network Performance Measurement Using IP SLAs 4
IP SLAs Operation Types 5
IP SLAs Responder and IP SLAs Control Protocol 5
Response Time Computation for IP SLAs 6
IP SLAs Operation Scheduling 6
IP SLAs Operation Threshold Monitoring 7
MPLS VPN Awareness 7
History Statistics 7
Additional References 8
9
Manually Configuring an IP SLAs Ethernet Ping or Jitter Operation on the Source Device 87
Scheduling IP SLAs Operations 90
Troubleshooting Tips 92
What to Do Next 92
Configuration Examples for IP SLAs for Metro-Ethernet 92
Example IP SLAs Auto Ethernet Operation with Endpoint Discovery 93
Example Individual IP SLAs Ethernet Ping Operation 93
Additional References 94
Feature Information for IP SLAs for Metro-Ethernet 95
96
referenced by the IP SLAs feature, refer to the text of the CISCO-RTTMON-MIB.my file, available from
the Cisco MIB website .
IP SLAs provides the following improvements over a traditional service level agreement:
End-to-end measurements--The ability to measure performance from one end of the network to the
other allows a broader reach and more accurate representation of the end-user experience.
Sophistication--Statistics such as delay, jitter, packet sequence, Layer 3 connectivity, and path and
download time that are broken down into bidirectional and round-trip numbers provide more data than
just the bandwidth of a Layer 2 link.
Ease of deployment--Leveraging the existing Cisco devices in a large network makes IP SLAs easier
and cheaper to implement than the physical probes often required with traditional service level
agreements.
Application-aware monitoring--IP SLAs can simulate and measure performance statistics generated by
applications running over Layer 3 through Layer 7. Traditional service level agreements can only
measure Layer 2 performance.
Pervasiveness--IP SLAs support exists in Cisco networking devices ranging from low-end to high-end
routers and switches. This wide range of deployment gives IP SLAs more flexibility over traditional
service level agreements.
When you know the performance expectations for different levels of traffic from the core of your network
to the edge of your network, you can confidently build an end-to-end application-aware service level
agreement.
Benefits of IP SLAs
IP SLAs monitoring
Provides service level agreement monitoring, measurement, and verification.
Network performance monitoring
Measures the jitter, latency, or packet loss in the network.
Provides continuous, reliable, and predictable measurements.
IP service network health assessment
Verifies that the existing QoS is sufficient for new IP services.
Edge-to-edge network availability monitoring
Provides proactive verification and connectivity testing of network resources (for example,
indicates the network availability of a Network File System (NFS) server used to store business
critical data from a remote site).
Troubleshooting of network operation
Provides consistent, reliable measurement that immediately identifies problems and saves
troubleshooting time.
Voice over IP (VoIP) performance monitoring
Multiprotocol Label Switching (MPLS) Virtual Private Network (VPN) performance monitoring and
network verification
To implement IP SLAs network performance measurement you need to perform these tasks:
1 Enable the IP SLAs Responder, if appropriate.
2 Configure the required IP SLAs operation type.
3 Configure any options available for the specified IP SLAs operation type.
4 Configure threshold conditions, if required.
5 Schedule the operation to run, then let the operation run for a period of time to gather statistics.
6 Display and interpret the results of the operation using Cisco software commands or an NMS system
with SNMP.
Conceptual information about the IP SLAs Responder and IP SLAs control protocol, the various IP SLAs
operation types, thresholding options, and scheduling options are contained in this document.
Enabling the IP SLAs Responder on the destination device is not required for all IP SLAs operations. For
example, if services that are already provided by the destination router (such as Telnet or HTTP) are
chosen, the IP SLAs Responder need not be enabled. For non-Cisco devices, the IP SLAs Responder
cannot be configured and IP SLAs can send operational packets only to services native to those devices.
An additional benefit of the two time stamps at the target router is the ability to track one-way delay, jitter,
and directional packet loss. Because much network behavior is asynchronous, it is critical to have these
statistics. However, to capture one-way delay measurements the configuration of both the source router and
target router with Network Time Protocol (NTP) is required. Both the source and target need to be
synchronized to the same clock source. One-way jitter measurements do not require clock synchronization.
IP SLAs operations helps minimize the CPU utilization and thereby enhances the scalability of the
network.
For more details about the IP SLAs multioperations scheduling functionality, see the IP SLAs-
Multioperation Scheduling of IP SLAs Operations module of the IP SLAs Configuration Guide .
History Statistics
IP SLAs maintains the following three types of history statistics:
Aggregated statistics--By default, IP SLAs maintains two hours of aggregated statistics for each
operation. Value from each operation cycle is aggregated with the previously available data within a
given hour. The Enhanced History feature in IP SLAs allows for the aggregation interval to be shorter
than an hour.
Operation snapshot history--IP SLAs maintains a snapshot of data for each operation instance that
matches a configurable filter, such as all, over threshold, or failures. The entire set of data is available
and no aggregation takes place.
Distribution statistics--IP SLAs maintains a frequency distribution over configurable intervals. Each
time IP SLAs starts an operation, a new history bucket is created until the number of history buckets
matches the specified size or the lifetime of the operation expires. By default, the history for an IP
SLAs operation is not collected. If history is collected, each bucket contains one or more history
entries from the operation. History buckets do not wrap.
Additional References
Related Documents
Standards
Standards Title
ITU-T G.711 u-law and G.711 a-law Pulse code modulation (PCM) of voice frequencies
MIBs
RFCs
RFCs Title
No new or modified RFCs are supported by this --
feature, and support for existing RFCs has not been
modified by this feature.
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Description Link
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
Prerequisites
Time synchronization, such as that provided by NTP, is required between the source and the target
device in order to provide accurate one-way delay (latency) measurements. To configure NTP on the
source and target devices, perform the tasks in the Performing Basic System Management chapter of
the Cisco IOS Network Management Configuration Guide. Time synchronization is not required for
the one-way jitter and packet loss measurements, however. If the time is not synchronized between the
source and target devices, one-way jitter and packet loss data will be returned, but values of 0 will
be returned for the one-way delay measurements provided by the UDP jitter operation.
Before configuring any IP SLAs application, you can use the show ip sla application command to
verify that the operation type is supported on your software image.
Elapsed time before the operation 60 seconds frequency (IP SLA) command
repeats, in seconds (F)
The IP SLAs operations function by generating synthetic (simulated) network traffic. A single IP SLAs
operation (for example, IP SLAs operation 10) will repeat at a given frequency for the lifetime of the
operation.
Note A responder should not configure a permanent port for the same sender. If the responder configures the
permanent port for the same sender, even if the packets are successfully sent (no timeout or packet loss
issues), the jitter values will be zero.
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
ip sla responder
ip sla responder udp-echo ipaddress ip-address port port
4. exit
DETAILED STEPS
Example:
Router# configure terminal
Configuring and Scheduling a Basic UDP Jitter Operation on the Source Device
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. udp-jitter {destination-ip-address | destination-hostname} destination-port [source-ip {ip-address |
hostname}] [source-port port-number] [control {enable | disable}] [num-packets number-of-packets]
[interval interpacket-interval]
5. frequency seconds
6. exit
7. 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]
8. exit
9. show ip sla configuration [operation-number]
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla operation-number Begins configuration for an IP SLAs operation and enters
IP SLA configuration mode.
Example:
Router(config)# ip sla 10
Step 4 udp-jitter {destination-ip-address | destination-hostname} Configures the IP SLAs operation as a UDP jitter
destination-port [source-ip {ip-address | hostname}] [source- operation and enters UDP jitter configuration submode.
port port-number] [control {enable | disable}] [num-packets Use the control disable keyword combination only
number-of-packets] [interval interpacket-interval] if you disable the IP SLAs control protocol on both
the source and target routers.
Example:
Router(config-ip-sla)# udp-jitter 172.29.139.134 5000
Step 5 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-jitter)# frequency 30
Step 7 ip sla schedule operation-number [life {forever| seconds}] Configures the scheduling parameters for an individual
[start-time {hh:mm[:ss] [month day | day month] | pending | IP SLAs operation.
now | after hh:mm:ss}] [ageout seconds] [recurring]
Example:
Router(config)# ip sla schedule 5 start-time now life
forever
Step 9 show ip sla configuration [operation-number] (Optional) Displays configuration values including all
defaults for all IP SLAs operations or a specified
Example: operation.
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
Note
The IP SLAs UDP jitter operation does not support the IP SLAs History feature (statistics history
buckets) because of the large data volume involved with UDP jitter operations. This means that the
following commands are not supported for UDP jitter operations: history buckets-kept, history filter,
history lives-kept, samples-of-history-kept, and show ip sla history.
The MIB used by IP SLAs (CISCO-RTTMON-MIB) limits the hours-of-statistics kept for the UDP
jitter operation to two hours. Configuring a larger value using the history hours-of-statisticshours
global configuration change will not increase the value beyond two hours. However, the Data
Collection MIB can be used to collect historical data for the operation. For information, see the
CISCO-DATA-COLLECTION-MIB at http://www.cisco.com/go/mibs ).
Before configuring a UDP jitter operation on the source device, the IP SLAs Responder must be enabled on
the target device (the operational target). The IP SLAs Responder is available only on Cisco IOS software-
based devices. To enable the Responder, perform the task in the Configuring the IP SLAs Responder on
the Destination Device section.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. udp-jitter {destination-ip-address | destination-hostname} destination-port [source-ip {ip-address |
hostname}] [source-port port-number] [control {enable | disable}] [num-packets number-of-packets]
[interval interpacket-interval]
5. history distributions-of-statistics-kept size
6. history enhanced [interval seconds] [buckets number-of-buckets]
7. frequency seconds
8. history hours-of-statistics-kept hours
9. owner owner-id
10. request-data-size bytes
11. history statistics-distribution-interval milliseconds
12. tag text
13. threshold milliseconds
14. timeout milliseconds
15. Do one of the following:
tos number
traffic-class number
16. flow-label number
17. verify-data
18. vrf vrf-name
19. exit
20. 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]
21. exit
22. show ip sla configuration [operation-number]
DETAILED STEPS
Example:
Router# configure terminal
Step 4 udp-jitter {destination-ip-address | destination-hostname} Configures the IP SLAs operation as a UDP jitter operation
destination-port [source-ip {ip-address | hostname}] and enters UDP jitter configuration submode.
[source-port port-number] [control {enable | disable}] Use the control disable keyword combination only if
[num-packets number-of-packets] [interval interpacket- you disable the IP SLAs control protocol on both the
interval] source and target routers.
Example:
Router(config-ip-sla)# udp-jitter 172.29.139.134
5000
Step 5 history distributions-of-statistics-kept size (Optional) Sets the number of statistics distributions kept
per hop during an IP SLAs operation.
Example:
Router(config-ip-sla-jitter)# history
distributions-of-statistics-kept 5
Step 6 history enhanced [interval seconds] [buckets number-of- (Optional) Enables enhanced history gathering for an IP
buckets] SLAs operation.
Example:
Router(config-ip-sla-jitter)# history enhanced
interval 900 buckets 100
Step 7 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-jitter)# frequency 30
Step 8 history hours-of-statistics-kept hours (Optional) Sets the number of hours for which statistics are
maintained for an IP SLAs operation.
Example:
Router(config-ip-sla-jitter)# history hours-of-
statistics-kept 4
Step 10 request-data-size bytes (Optional) Sets the protocol data size in the payload of an
IP SLAs operation's request packet.
Example:
Router(config-ip-sla-jitter)# request-data-size 64
Step 11 history statistics-distribution-interval milliseconds (Optional) Sets the time interval for each statistics
distribution kept for an IP SLAs operation.
Example:
Router(config-ip-sla-jitter)# history statistics-
distribution-interval 10
Step 13 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
Example: operation.
Step 14 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-ip-sla-jitter)# timeout 10000
Step 15 Do one of the following: (Optional) In an IPv4 network only, defines the ToS byte in
the IPv4 header of an IP SLAs operation.
tos number
or
traffic-class number
(Optional) In an IPv6 network only, defines the traffic class
Example: byte in the IPv6 header for a supported IP SLAs operation.
Example:
Router(config-ip-sla-jitter)# traffic-class 160
Step 16 flow-label number (Optional) In an IPv6 network only, defines the flow label
field in the IPv6 header for a supported IP SLAs operation.
Example:
Router(config-ip-sla-jitter)# flow-label 112233
Step 20 ip sla schedule operation-number [life {forever| seconds}] Configures the scheduling parameters for an individual IP
[start-time {hh:mm[:ss] [month day | day month] | pending | SLAs operation.
now | after hh:mm:ss}] [ageout seconds] [recurring]
Example:
Router(config)# ip sla schedule 5 start-time now
life forever
Step 22 show ip sla configuration [operation-number] (Optional) Displays configuration values including all
defaults for all IP SLAs operations or a specified operation.
Example:
Router# show ip sla configuration 10
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
ip sla 1
udp-jitter 20.0.10.3 65051 num-packets 20
request-data-size 160
tos 128
frequency 30
ip sla schedule 1 start-time after 00:05:00
ip sla 2
udp-jitter 20.0.10.3 65052 num-packets 20 interval 10
request-data-size 20
tos 64
frequency 30
ip sla schedule 2 start-time after 00:05:05
ip sla responder
Additional References
Related Documents
Standards
Standards Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by features in this document.
MIBs
RFCs
RFCs Title
No specific RFCs are supported by the features in --
this document.
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
IPv6 - IP SLAs (UDP Jitter, UDP 12.2(33)SRC 12.2(33)SB Support was added for operability
Echo, ICMP Echo, TCP Connect) 12.4(20)T Cisco IOS XE 3.1.0SG in IPv6 networks.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
Note The term Voice in this document should be taken to mean any Internet telephony applications. The term
Voice over IP can include the transmission of multimedia (both voice and video) over IP networks.
combinations of impairments. The table below, taken from G.113 (02/96), shows how sample ICPIF values
are expected to correspond to subjective quality judgement.
10 Good
20 Adequate
30 Limiting case
For further details on the ICPIF, see the 1996 version of the G.113 specification.
Note The latest version of the ITU-T G.113 Recommendation (2001), no longer includes the ICPIF model.
Instead, it refers implementers to G.107: The Impairment Factor method, used by the E-model of ITU-T
G.107, is now recommended. The earlier method that used Quantization Distortion Units is no longer
recommended. The full E-Model (also called the ITU-T Transmission Rating Model), expressed as R = Ro
- Is - Id - Ie + A , provides the potential for more accurate measurements of call quality by refining the
definitions of impairment factors (see the 2003 version of the G.107 for details). Though the ICPIF shares
terms for impairments with the E-Model, the two models should not be confused. The IP SLAs VoIP UDP
Operation feature takes advantage of observed correspondences between the ICPIF, transmission rating
factor R, and MOS values, but does not yet support the E-Model.
IP SLAs uses a simplified ICPIF formula, defined in more detail later in this document.
As the MOS ratings for codecs and other transmission impairments are known, an estimated MOS can be
computed and displayed based on measured impairments. This estimated value is designated as MOS-CQE
(Mean Opinion Score; Conversational Quality, Estimated) by the ITU in order to distinguish it from
objective or subjective MOS values (see P.800.1 for details).
For example, if you configure the VoIP UDP jitter operation to use the characteristics for the g711ulaw
codec, by default a probe operation will be sent once a minute (f). Each probe operation would consist of
1000 packets (n), with each packet containing 180 bytes of synthetic data (s), sent 20 milliseconds apart (t).
100 2
150 4
Packet Loss (as a percentage of Equipment Impairment Value for Equipment Impairment Value for
total number of packets sent) PCM (G.711) Codecs the CS-ACELP (G.729A) Codec
2% 12 20
4% 22 30
6% 28 38
8% 32 42
These values are only suggestions. To be meaningful, the use of the factor A and its selected value in a
specific application should be used consistently in any planning model you adopt. However, the values in
the table above should be considered as the absolute upper limits for A .
The default Advantage Factor for IP SLAs VoIP UDP jitter operations is always zero.
4 - 13 4 High
14 - 23 3 Medium
24 - 33 2 Low
34 - 43 1 Poor
IP SLAs will always express the estimated MOS value as a number in the range of 1 to 5, with 5 being the
best quality. A MOS value of 0 (zero) indicates that MOS data could not be generated for the operation.
Note
Currently, IP SLAs supports only the following speech codecs (compression methods):
G.711 A Law (g711alaw: 64 kbps PCM compression method)
G.711 mu Law (g711ulaw: 64 kbps PCM compression method)
G.729A (g729a: 8 kbps CS-ACELP compression method)
The following commands, available in UDP jitter configuration mode, are not valid for UDP jitter
(codec) operations:
history distributions-of-statistics-kept
history statistics-distribution-interval
request-data-size
Specifying the codec-type will configure the appropriate default values for the codec-interval, codec-
size, and codec-numpacket options. You should not specify values for the interval, size, and number
of packet options unless you have a specific reason to override the defaults (for example,
approximating a different codec).
The show ip sla configuration command will list the values for the Number of statistic distribution
buckets kept and Statistic distribution interval (milliseconds), but these values do not apply to jitter
(codec) operations.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. udp-jitter {destination-ip-address | destination-hostname} destination-port codec codec-type [codec-
numpackets number-of-packets] [codec-size number-of-bytes] [codec-interval milliseconds]
[advantage-factor value] [source-ip {ip-address | hostname}] [source-port port-number] [control
{enable | disable}]
5. history enhanced [interval seconds] [buckets number-of-buckets]
6. frequency seconds
7. history hours-of-statistics-kept hours
8. owner owner-id
9. tag text
10. threshold milliseconds
11. timeout milliseconds
12. Do one of the following:
tos number
traffic-class number
13. flow-label number
14. verify-data
15. vrf vrf-name
16. exit
17. 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]
18. exit
19. show ip sla configuration [operation-number]
DETAILED STEPS
Example:
Router# configure terminal
Example:
Router(config)# ip sla 10
Step 4 udp-jitter {destination-ip-address | destination-hostname} Configures the operation as a jitter (codec) operation that
destination-port codec codec-type [codec-numpackets will generate VoIP scores in addition to latency, jitter,
number-of-packets] [codec-size number-of-bytes] [codec- and packet loss statistics.
interval milliseconds] [advantage-factor value] [source-ip
{ip-address | hostname}] [source-port port-number] [control
{enable | disable}]
Example:
Router(config-ip-sla)# udp-jitter 209.165.200.225
16384 codec g711alaw advantage-factor 10
Step 5 history enhanced [interval seconds] [buckets number-of- (Optional) Enables enhanced history gathering for an IP
buckets] SLAs operation.
Example:
Router(config-ip-sla-jitter)# history enhanced
interval 900 buckets 100
Step 6 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-jitter)# frequency 30
Step 7 history hours-of-statistics-kept hours (Optional) Sets the number of hours for which statistics
are maintained for an IP SLAs operation.
Example:
Router(config-ip-sla-jitter)# history hours-of-
statistics-kept 4
Step 10 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
operation.
Example:
Router(config-ip-sla-jitter)# threshold 10000
Step 11 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-ip-sla-jitter)# timeout 10000
Step 12 Do one of the following: (Optional) In an IPv4 network only, defines the ToS byte
in the IPv4 header of an IP SLAs operation.
tos number
or
traffic-class number
(Optional) In an IPv6 network only, defines the traffic
Example: class byte in the IPv6 header for a supported IP SLAs
operation.
Router(config-ip-sla-jitter)# tos 160
Example:
Router(config-ip-sla-jitter)# traffic-class 160
Step 13 flow-label number (Optional) In an IPv6 network only, defines the flow
label field in the IPv6 header for a supported IP SLAs
Example: operation.
Step 17 ip sla schedule operation-number [life {forever| seconds}] Configures the scheduling parameters for an individual
[start-time {hh:mm[:ss] [month day | day month] | pending | IP SLAs operation.
now | after hh:mm:ss}] [ageout seconds] [recurring]
Example:
Router(config)# ip sla schedule 5 start-time now
life forever
Step 19 show ip sla configuration [operation-number] (Optional) Displays configuration values including all
defaults for all IP SLAs operations or a specified
Example: operation.
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
Password:
Router# configure terminal
Enter configuration commands, one per line. End with the end command.
Router(config)# ip sla 10
Router(config-sla)# udp-jitter 209.165.200.225 16384 codec g711alaw advantage-factor 2
Router(config)# exit
Router#
Router# show running-config | begin ip sla 10
ip sla 10
udp-jitter 209.165.200.225 16384 codec g711alaw advantage-factor 2
owner admin_bofh
ip sla schedule 10 start-time now
.
.
.
Router# show ip sla configuration 10
Entry number: 10
Owner: admin_bofh
Tag:
Type of operation to perform: jitter
Target address: 209.165.200.225
Source address: 0.0.0.0
Target port: 16384
Source port: 0
Operation timeout (milliseconds): 5000
Codec Type: g711alaw
Codec Number Of Packets: 1000
Codec Packet Size: 172
Codec Interval (milliseconds): 20
Advantage Factor: 2
Type Of Service parameters: 0x0
Verify data: No
Vrf Name:
Control Packets: enabled
Operation frequency (seconds): 60
Next Scheduled Start Time: Start Time already passed
Life (seconds): 3600
Entry Ageout (seconds): never
Status of entry (SNMP RowStatus): Active
Connection loss reaction enabled: No
Timeout reaction enabled: No
Verify error enabled: No
Threshold reaction type: Never
Threshold (milliseconds): 5000
Threshold Falling (milliseconds): 3000
Threshold Count: 5
Threshold Count2: 5
Reaction Type: None
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 1
Statistic distribution interval (milliseconds): 20
Enhanced History:
When a codec type is configured for a jitter operation, the standard jitter Request size (ARR data
portion), Number of packets, and Interval (milliseconds) parameters will not be displayed in the show
ip sla configuration command output. Instead, values for Codec Packet Size, Codec Number of
Packets, and Codec Interval (milliseconds) are displayed.
Entry number: 10
Modification time: 12:57:45.690 UTC Sun Oct 26 2003
Number of operations attempted: 1
Number of operations skipped: 0
Current seconds left in Life: Forever
Operational state of entry: Active
Last time this entry was reset: Never
Connection loss occurred: FALSE
Timeout occurred: FALSE
Over thresholds occurred: FALSE
Latest RTT (milliseconds): 19
Latest operation start time: 12:57:45.723 Sun Oct 26 2003
Latest operation return code: OK
!
Voice Scores:
ICPIF: 20 MOS Score: 3.20
!
RTT Values:
NumOfRTT: 10 RTTAvg: 19 RTTMin: 19 RTTMax: 20
RTTSum: 191 RTTSum2: 3649
Packet Loss Values:
PacketLossSD: 0 PacketLossDS: 0
PacketOutOfSequence: 0 PacketMIA: 0 PacketLateArrival: 0
InternalError: 0 Busies: 0
Jitter Values:
NumOfJitterSamples: 9
MinOfPositivesSD: 0 MaxOfPositivesSD: 0
NumOfPositivesSD: 0 SumOfPositivesSD: 0 Sum2PositivesSD: 0
MinOfNegativesSD: 0 MaxOfNegativesSD: 0
NumOfNegativesSD: 0 SumOfNegativesSD: 0 Sum2NegativesSD: 0
MinOfPositivesDS: 1 MaxOfPositivesDS: 1
NumOfPositivesDS: 1 SumOfPositivesDS: 1 Sum2PositivesDS: 1
MinOfNegativesDS: 1 MaxOfNegativesDS: 1
NumOfNegativesDS: 1 SumOfNegativesDS: 1 Sum2NegativesDS: 1
Interarrival jitterout: 0 Interarrival jitterin: 0
One Way Values:
NumOfOW: 0
OWMinSD: 0 OWMaxSD: 0 OWSumSD: 0 OWSum2SD: 0
OWMinDS: 0 OWMaxDS: 0 OWSumDS: 0 OWSum2DS: 0
Additional References
Related Documents
PSTN Fallback for Voice Gateways SIP: Measurement-Based Call Admission Control
for SIP
http://www.cisco.com/en/US/docs/ios/12_2t/
12_2t15/feature/guide/ftcacsip.html
Standards
Standard1 Title
ITU-T Recommendation G.107 (2003) The E-model, a computation model for use in
transmission planning
ITU-T Recommendation G.711 (1998) Pulse code modulation (PCM) of voice frequencies
(also known as the G.711 Voice Codec)
ITU-T Recommendation G.729 Annex A (1996) Reduced complexity 8 kbit/s CS-ACELP speech
codec (also known as the G.729/A/B Speech
Codec)
MIBs
1 Full support by this feature for listed RFCs is not claimed. ITU Telecommunication Standards (ITU-T Recommendations In Force) can be
obtained from http://www.itu.ch. Summary definitions are available from a variety of internet sources.
RFCs
RFC2 Title
RFC 768 User Datagram Protocol
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Table 10: Feature Information for IP SLAs UDP Jitter Operations for VoIP
Glossary
codec --In the context of IP Telephony, a codec is a compression and decompression algorithm used to
transfer voice and video data more efficiently. Voice codec types are typically referred to using the ITU
recommendation number that defines the algorithm (for example, G.711 instead of PCM).
CS-ACELP --The codec type defined in the reference documents G.729 and G.729A, Coding of speech at
8 kbit/s using conjugate-structure algebraic-code-excited linear-prediction (CS-ACELP) .
ITU --The International Telecommunication Union. The ITU is an international organization within the
United Nations System where governments and the private sector coordinate global telecom networks and
services. The ITU Telecommunication Standardization Sector (ITU-T), responsible for defining standards
(Recommendations) covering all fields of telecommunications, is one of the three operational sectors of the
ITU. The ITU web site is at http://www.itu.int.
ITU-T --ITU Telecommunication Standardization Sector. The ITU-T is one of the three operational sectors
of the ITU, and is responsible for defining standards (called ITU-T Recommendations) covering all fields
of telecommunications.
MOS-CQE (Mean Opinion Score; Conversational Quality, Estimated)--The score calculated by a network
planning model which aims at predicting the quality in a conversational application situation. Estimates of
conversational quality carried out according to ITU-T Rec. G.107, when transformed to a mean opinion
score (MOS), give results in terms of MOS-CQE.3
PCM --The codec type defined in the reference document G.711, Pulse code modulation (PCM) of voice
frequencies .
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
3 Definition from ITU-T Recommendation P.800.1. Used in accordance with the ITU Copyright and Disclaimer Notice.
The participating PE routers of an LSP Health Monitor operation must support the MPLS LSP ping
feature. It is recommended that the Provider (P) routers also support the MPLS LSP Ping feature in
order to obtain complete error reporting and diagnostics information.
Ensure that the source PE router has enough memory to support the desired LSP Health Monitor
functionality. Enabling the LSP discovery option can potentially have a significant impact on router
memory. If there is not enough memory available during the LSP discovery process, the process will
gracefully terminate and an error message will be displayed.
Note The destination PE routers of an LSP Health Monitor operation do not require the IP SLAs Responder to be
enabled.
Monitoring and SNMP trap alerts for round-trip time (RTT) threshold violations, connection loss, and
command response timeouts
Note By default, only a single path between the source and destination PE routers is discovered. If the LSP
discovery option is enabled, the equal-cost multipaths between the source and destination PE routers are
discovered. For more information on how the LSP discovery process works, see the "LSP Discovery
Process" section.
2 The user configures proactive threshold monitoring parameters for the LSP Health Monitor operation.
For more information about proactive threshold monitoring, see the "Proactive Threshold Monitoring
for the LSP Health Monitor" section.
Depending on the proactive threshold monitoring configuration options chosen, SNMP trap
notifications or syslog messages are generated as threshold violations are met.
3 The user configures multioperation scheduling parameters for the LSP Health Monitor operation. For
more information about multioperation scheduling, see the "Multioperation Scheduling for the LSP
Health Monitor" section.
Once the LSP Health Monitor operation is started, a single IP SLAs operation is automatically created
(based on parameters configured in Step 1) for each applicable PE (BGP next hop) neighbor. The IP
SLAs operations will measure network connectivity between the source PE router and the discovered
destination PE router. The start time and frequency of each measurement is based on the multioperation
scheduling parameters defined by the user.
If the LSP discovery option is enabled, creation of LSP discovery groups for newly discovered BGP next
hop neighbors will follow the same process as described in the "LSP Discovery Process" section. If a BGP
next hop neighbor is removed from a particular VPN, all the corresponding LSP discovery groups and their
associated individual IP SLAs operations and statistics are removed from the LSP discovery group
database.
Forward Equivalence Class (FEC) of the BGP next hop router in the global routing table is provided so that
it can be used by the MPLS LSP ping operation.
Note For a given LSP Health Monitor operation, the user can define the maximum number of BGP next hop
neighbors that can be concurrently undergoing LSP discovery.
3 Each individual IP SLAs operation (created for each applicable PE neighbor) uses an IP SLAs LSP ping
superoperation to measure network connectivity across all equal-cost multipaths between the source PE
router and discovered destination PE router. The IP SLAs superoperation operates by sending an LSP
ping packet to the destination PE router and adjusting the LSP ping 127/8 LSP selector IP address for
each discovered equal-cost multipath. For example, assume that there are three equal-cost multipaths to
a destination PE router and the identified LSP selector IP addresses are 127.0.0.1, 127.0.0.5, and
127.0.0.6. The IP SLAs superoperation would sequentially send three LSP ping packets using the
identified LSP selector IP addresses for directing the superoperation across the three paths. This
technique ensures that there is only a single IP SLAs LSP ping operation for each source and
destination PE router pair, and significantly reduces the number of active LSP ping operations sent by
the source PE router.
The figure below illustrates a simple VPN scenario. This network consists of a core MPLS VPN with two
PE routers (router PE1 and router PE2) belonging to the VRF named VPN blue. Suppose router PE1 is the
source PE router for an LSP Health Monitor operation with the LSP discovery option enabled and that
router PE2 is discovered by the BGP discovery process as a BGP next hop neighbor to router PE1. If path 1
and path 2 are equal-cost multipaths between router PE1 to router PE2, then the LSP discovery process
would create an LSP discovery group consisting of path 1 and path 2. An IP SLAs LSP ping superoperation
would also be created to monitor network availability across each path.
LSP discovery group corresponds to one BGP next hop neighbor and is assigned a unique identification
number (starting with the number 1). The figure below illustrates a simple VPN scenario. This network
consists of a core MPLS VPN with three PE routers (router PE1, PE2, and PE3) belonging to the VRF
named VPN blue. Suppose router PE1 is the source PE router for an LSP Health Monitor operation with the
LSP discovery option enabled and that router PE2 and PE3 are discovered by the BGP discovery process as
BGP next hop neighbors to router PE1. LSP discovery group 1 is created for the equal-cost multipaths
between router PE1 to router PE2 and LSP discovery group 2 is created for the equal-cost multipaths
between router PE1 to router PE3.
Once the LSP Health Monitor operation is started, a single IP SLAs operation is automatically created for
each applicable PE (BGP next hop) neighbor. Each IP SLAs operation (created for each applicable PE
neighbor) uses an IP SLAs LSP ping superoperation to measure network connectivity across all equal-cost
multipaths between the source PE router and discovered destination PE router. Each LSP ping
superoperation corresponds to a single LSP discovery group.
The LSP ping superoperation operates by sending an LSP ping packet to the destination PE router and
adjusting the LSP ping 127/8 LSP selector IP address for each discovered equal-cost multipath. The
network connectivity statistics collected by each equal-cost multipath is aggregated and stored in one-hour
increments (data can be collected for a maximum of two hours). Results are stored as group averages
representative of all the equal-cost multipaths within the LSP discovery group for a given one-hour
increment.
Each equal-cost multipath discovered between the source PE router and a BGP next hop neighbor is
uniquely identified with the following parameters:
127/8 destination IP address (LSP selector) within the local host IP address range
PE outgoing interface
The database for an LSP discovery group is updated if any of the following events occur:
The corresponding LSP ping superoperation sends an LSP ping packet.
An active equal-cost multipath is added to or deleted from the LSP discovery group.
The user enters the Cisco command to delete all the aggregated statistical data for a particular LSP
discovery group.
return code is generated. Depending on the value of the return code and the current status of the LSP
discovery group, the group status can change.
Table 11: Conditions for Which an LSP Discovery Group Status Changes
Individual IP SLAs Current Group Status = Current Group Status = Current Group Status =
Operation Return Code UP PARTIAL DOWN
OK No group status change. If return codes for all Group status changes to
paths in the group are PARTIAL.
OK, then the group
status changes to UP.
Broken or Unexplorable Group status changes to If return codes for all No group status change.
PARTIAL. paths in the group are
Broken or Unexplorable,
then the group status
changes to DOWN.
The return code for an individual IP SLAs LSP ping operation can be one of the following:
OK--Indicates that the LSP is working properly. The customer VPN traffic will be sent across this
path.
Broken--Indicates that the LSP is broken. Customer VPN traffic will not be sent across this path and
may be discarded.
Unexplorable--Indicates that not all the paths to this PE neighbor have been discovered. This may be
due to a disruption along the LSP or because the number of 127/8 IP addresses used for LSP selection
has been exhausted.
The status of an LSP discovery group can be one of the following:
UNKNOWN--Indicates that group status has not yet been determined and that the paths belonging to
the group are in the process of being tested for the first time. Once this initial test is complete, the
group status will change to UP, PARTIAL, or DOWN.
UP--Indicates that all the paths within the group are active and no operation failures have been
detected.
PARTIAL--Indicates that an operation failure has been detected for one or more, but not all, of the
paths within the group.
DOWN--Indicates that an operation failure has been detected for all the paths within the group.
at intervals equally distributed over a specified duration of time (schedule period) and to restart at a
specified frequency. Multioperation scheduling is particularly useful in cases where the LSP Health
Monitor is enabled on a source PE router that has a large number of PE neighbors and, therefore, a large
number of IP SLAs operations running at the same time.
Newly created IP SLAs operations (for newly discovered BGP next hop neighbors) are added to the same
schedule period as the operations that are currently running. To prevent too many operations from starting
at the same time, the multioperation scheduling feature will schedule the operations to begin at random
intervals uniformly distributed over the schedule period.
Configuring a multioperation schedule for the LSP Health Monitor is similar to configuring a standard
multioperation schedule for a group of individual IP SLAs operations.
Note If the LSP discovery option is disabled, only a single path between the source PE router and each BGP next
hop neighbor is discovered.
SUMMARY STEPS
1. enable
2. configure terminal
3. mpls discovery vpn next-hop
4. mpls discovery vpn interval seconds
5. auto ip sla mpls-lsp-monitor operation-number
6. Do one of the following:
type echo [ipsla-vrf-all | vrf vpn-name]
type pathEcho [ipsla-vrf-all | vrf vpn-name]
7. access-list access-list-number
8. scan-interval minutes
9. delete-scan-factor factor
10. force-explicit-null
11. exp exp-bits
12. lsp-selector ip-address
13. reply-dscp-bits dscp-value
14. reply-mode {ipv4 | router-alert}
15. request-data-size bytes
16. secondary-frequency {both | connection-loss | timeout} frequency
17. tag text
18. threshold milliseconds
19. timeout milliseconds
20. ttl time-to-live
21. exit
22. auto ip sla mpls-lsp-monitor reaction-configuration operation-number react {connectionLoss |
timeout} [action-type option] [threshold-type {consecutive [occurrences] | immediate | never}]
23. exit
DETAILED STEPS
Example:
Router> enable
Example:
Router# configure terminal
Step 3 mpls discovery vpn next-hop (Optional) Enables the MPLS VPN BGP next hop neighbor
discovery process.
Example: NoteThis command is automatically enabled when the auto ip sla
Router(config)# mpls discovery vpn next-hop
mpls-lsp-monitor command is entered.
Step 4 mpls discovery vpn interval seconds (Optional) Specifies the time interval at which routing entries that
are no longer valid are removed from the BGP next hop neighbor
Example: discovery database of an MPLS VPN.
Step 5 auto ip sla mpls-lsp-monitor operation-number Begins configuration for an LSP Health Monitor operation and
enters auto IP SLA MPLS configuration mode.
Example: NoteEntering this command automatically enables the mpls
Router(config)# auto ip sla mpls-lsp-
discovery vpn next-hop command.
monitor 1
Step 6 Do one of the following: Enters MPLS parameters configuration submode and allows the
user to configure the parameters for an IP SLAs LSP ping
type echo [ipsla-vrf-all | vrf vpn-name] operation using the LSP Health Monitor.
type pathEcho [ipsla-vrf-all | vrf vpn-name]
or
Example:
Router(config-auto-ip-sla-mpls)# type
pathEcho ipsla-vrf-all
Step 7 access-list access-list-number (Optional) Specifies the access list to apply to an LSP Health
Monitor operation.
Example:
Router(config-auto-ip-sla-mpls-params)#
access-list 10
Step 8 scan-interval minutes (Optional) Sets the timer for the IP SLAs LSP Health Monitor
database.
Example:
Router(config-auto-ip-sla-mpls-params)#
scan-interval 5
Step 9 delete-scan-factor factor (Optional) Specifies the number of times the LSP Health Monitor
should check the scan queue before automatically deleting IP SLAs
Example: operations for BGP next hop neighbors that are no longer valid.
Router(config-auto-ip-sla-mpls-params)# The default scan factor is 1. Each time the LSP Health
delete-scan-factor 2 Monitor checks the scan queue for updates, it deletes IP SLAs
operations for BGP next hop neighbors that are no longer
valid.
If the scan factor is set to 0, IP SLAs operations will not be
automatically deleted by the LSP Health Monitor. This
configuration is not recommended.
This command must be used with the scan-interval command.
Step 10 force-explicit-null (Optional) Adds an explicit null label to all echo request packets of
an IP SLAs operation.
Example:
Router(config-auto-ip-sla-mpls-params)#
force-explicit-null
Step 11 exp exp-bits (Optional) Specifies the experimental field value in the header for
an echo request packet of an IP SLAs operation.
Example:
Router(config-auto-ip-sla-mpls-params)# exp
5
Step 12 lsp-selector ip-address (Optional) Specifies the local host IP address used to select the
LSP of an IP SLAs operation.
Example:
Router(config-auto-ip-sla-mpls-params)# lsp-
selector 127.0.0.10
Step 13 reply-dscp-bits dscp-value (Optional) Specifies the differentiated services codepoint (DSCP)
value for an echo reply packet of an IP SLAs operation.
Example:
Router(config-auto-ip-sla-mpls-params)#
reply-dscp-bits 5
Step 14 reply-mode {ipv4 | router-alert} (Optional) Specifies the reply mode for an echo request packet of
an IP SLAs operation.
Example: The default reply mode is an IPv4 UDP packet.
Router(config-auto-ip-sla-mpls-params)#
reply-mode router-alert
Step 15 request-data-size bytes (Optional) Specifies the protocol data size for a request packet of
an IP SLAs operation.
Example:
Router(config-auto-ip-sla-mpls-params)#
request-data-size 200
Step 16 secondary-frequency {both | connection-loss | (Optional) Sets the faster measurement frequency (secondary
timeout} frequency frequency) to which an IP SLAs operation should change when a
reaction condition occurs.
Example:
Router(config-auto-ip-sla-mpls-params)#
secondary-frequency connection-loss 10
Step 18 threshold milliseconds (Optional) Sets the upper threshold value for calculating network
monitoring statistics created by an IP SLAs operation.
Example:
Router(config-auto-ip-sla-mpls-params)#
threshold 6000
Step 19 timeout milliseconds (Optional) Specifies the amount of time the IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-auto-ip-sla-mpls-params)#
timeout 7000
Step 20 ttl time-to-live (Optional) Specifies the maximum hop count for an echo request
packet of an IP SLAs operation.
Example:
Router(config-auto-ip-sla-mpls-params)# ttl
200
Step 22 auto ip sla mpls-lsp-monitor reaction- (Optional) Configures certain actions to occur based on events
configuration operation-number react under the control of the LSP Health Monitor.
{connectionLoss | timeout} [action-type option]
[threshold-type {consecutive [occurrences] |
immediate | never}]
Example:
Router(config)# auto ip sla mpls-lsp-
monitor reaction-configuration 1 react
connectionLoss action-type trapOnly
threshold-type consecutive 3
Configuring the LSP Health Monitor Operation with LSP Discovery on a PE Router
Note
The LSP Health Monitor with LSP Discovery feature supports Layer 3 MPLS VPNs only.
The LSP discovery option does not support IP SLAs LSP traceroute operations.
The LSP discovery option does not support IP SLAs VCCV operations.
The LSP discovery process can potentially have a significant impact on the memory and CPU of the
source PE router. To prevent unnecessary router performance issues, careful consideration should be
taken when configuring the operational and scheduling parameters of an LSP Health Monitor
operation.
SUMMARY STEPS
1. enable
2. configure terminal
3. mpls discovery vpn next-hop
4. mpls discovery vpn interval seconds
5. auto ip sla mpls-lsp-monitor operation-number
6. type echo [ipsla-vrf-all | vrf vpn-name]
7. Configure optional parameters for the IP SLAs LSP echo operation.
8. path-discover
9. hours-of-statistics-kept hours
10. force-explicit-null
11. interval milliseconds
12. lsp-selector-base ip-address
13. maximum-sessions number
14. scan-period minutes
15. session-timeout seconds
16. timeout seconds
17. exit
18. exit
19. auto ip sla mpls-lsp-monitor reaction-configuration operation-number react lpd {lpd-group [retry
number] | tree-trace} [action-type trapOnly]
20. ip sla logging traps
21. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 mpls discovery vpn next-hop (Optional) Enables the MPLS VPN BGP next hop neighbor
discovery process.
Example: NoteThis command is automatically enabled when the auto ip sla
Router(config)# mpls discovery vpn next-hop
mpls-lsp-monitor command is entered.
Step 5 auto ip sla mpls-lsp-monitor operation-number Begins configuration for an LSP Health Monitor operation and
enters auto IP SLAs MPLS configuration mode.
Example: NoteEntering this command automatically enables the mpls
Router(config)# auto ip sla mpls-lsp-
discovery vpn next-hop command.
monitor 1
Step 6 type echo [ipsla-vrf-all | vrf vpn-name] Enters MPLS parameters configuration mode and allows the user to
configure the parameters for an IP SLAs LSP ping operation using
Example: the LSP Health Monitor.
Step 7 Configure optional parameters for the IP SLAs LSP (Optional) See Steps 7 through 21 in the "Configuring an LSP
echo operation. Health Monitor Operation Without LSP Discovery on a PE Router"
section.
Step 8 path-discover Enables the LSP discovery option for an IP SLAs LSP Health
Monitor operation and enters LSP discovery parameters
Example: configuration submode.
Router(config-auto-ip-sla-mpls-params)#
path-discover
Step 9 hours-of-statistics-kept hours (Optional) Sets the number of hours for which LSP discovery group
statistics are maintained for an LSP Health Monitor operation.
Example:
Router(config-auto-ip-sla-mpls-lpd-params)#
hours-of-statistics-kept 1
Step 10 force-explicit-null (Optional) Adds an explicit null label to all echo request packets of
an LSP Health Monitor operation.
Example:
Router(config-auto-ip-sla-mpls-lpd-params)#
force-explicit-null
Step 11 interval milliseconds (Optional) Specifies the time interval between MPLS echo requests
that are sent as part of the LSP discovery process for an LSP Health
Example: Monitor operation.
Router(config-auto-ip-sla-mpls-lpd-params)#
interval 2
Step 12 lsp-selector-base ip-address (Optional) Specifies the base IP address used to select the LSPs
belonging to the LSP discovery groups of an LSP Health Monitor
operation.
Example:
Router(config-auto-ip-sla-mpls-lpd-params)#
lsp-selector-base 127.0.0.2
Step 13 maximum-sessions number (Optional) Specifies the maximum number of BGP next hop
neighbors that can be concurrently undergoing LSP discovery for a
Example: single LSP Health Monitor operation.
NoteCareful consideration should be used when configuring this
Router(config-auto-ip-sla-mpls-lpd-params)#
maximum-sessions 2 parameter to avoid a negative impact on the routers CPU.
Step 14 scan-period minutes (Optional) Sets the amount of time after which the LSP discovery
process can restart for an LSP Health Monitor operation.
Example:
Router(config-auto-ip-sla-mpls-lpd-params)#
scan-period 30
Step 15 session-timeout seconds (Optional) Sets the amount of time the LSP discovery process for an
LSP Health Monitor operation waits for a response to its LSP
Example: discovery request for a particular BGP next hop neighbor.
Router(config-auto-ip-sla-mpls-lpd-params)#
session-timeout 60
Step 16 timeout seconds (Optional) Sets the amount of time the LSP discovery process for an
LSP Health Monitor operation waits for a response to its echo
Example: request packets.
NoteCareful consideration should be used when configuring this
Router(config-auto-ip-sla-mpls-lpd-params)#
timeout 4 parameter to avoid a negative impact on the routers CPU.
Step 17 exit Exits LSP discovery parameters configuration submode and returns
to MPLS parameters configuration mode.
Example:
Router(config-auto-ip-sla-mpls-lpd-params)#
exit
Step 18 exit Exits MPLS parameters configuration mode and returns to global
configuration mode.
Example:
Router(config-auto-ip-sla-mpls-params)# exit
Step 19 auto ip sla mpls-lsp-monitor reaction- (Optional) Configures the proactive threshold monitoring
configuration operation-number react lpd {lpd- parameters for an LSP Health Monitor operation with LSP
group [retry number] | tree-trace} [action-type discovery enabled.
trapOnly]
Example:
Router(config)# auto ip sla mpls-lsp-
Step 20 ip sla logging traps (Optional) Enables the generation of SNMP system logging
messages specific to IP SLAs trap notifications.
Example:
Router(config)# ip sla logging traps
Step 21 exit Exits global configuration submode and returns to privileged EXEC
mode.
Example:
Router(config)# exit
Note
The LSP discovery process can potentially have a significant impact on the memory and CPU of the
source PE router. Careful consideration should be taken when configuring the scheduling parameters
to prevent too many IP SLAs LSP ping operations from running at the same time. The schedule period
should be set to a relatively large value for large MPLS VPNs.
Newly created IP SLAs operations (for newly discovered BGP next hop neighbors) are added to the
same mulioperation schedule period as the operations that are currently running. To prevent too many
operations from starting at the same time, the multioperation scheduler will schedule the operations to
begin at random intervals uniformly distributed over the schedule period.
SUMMARY STEPS
1. enable
2. configure terminal
3. auto ip sla mpls-lsp-monitor schedule operation-number schedule-period seconds [frequency
[seconds]] [start-time {after hh : mm : ss | hh : mm[: ss] [month day | day month] | now | pending}]
4. exit
5. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
Step 3 auto ip sla mpls-lsp-monitor schedule operation-number schedule-period Configures the scheduling parameters for
seconds [frequency [seconds]] [start-time {after hh : mm : ss | hh : mm[: ss] an LSP Health Monitor operation.
[month day | day month] | now | pending}]
Example:
Router(config)# auto ip sla mpls-lsp-monitor schedule 1 schedule-
period 60 start-time now
Example:
Router(config)# exit
Troubleshooting Tips
Use the debug ip sla trace and debug ip sla error commands to help troubleshoot issues with an
individual IP SLAs LSP ping or LSP traceroute operation. Use the debug ip sla mpls-lsp-monitor
command to help troubleshoot issues with an IP SLAs LSP Health Monitor operation.
What to Do Next
To display the results of an individual 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.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. Do one of the following:
mpls lsp ping ipv4 destination-address destination-mask [force-explicit-null] [lsp-selector ip-
address] [src-ip-addr source-address] [reply {dscp dscp-value | mode {ipv4 | router-alert}}]
mpls lsp trace ipv4 destination-address destination-mask [force-explicit-null] [lsp-selector ip-
address] [src-ip-addr source-address] [reply {dscp dscp-value | mode {ipv4 | router-alert}}]
5. exp exp-bits
6. request-data-size bytes
7. secondary-frequency {connection-loss | timeout} frequency
8. tag text
9. threshold milliseconds
10. timeout milliseconds
11. ttl time-to-live
12. exit
13. ip sla reaction-configuration operation-number [react monitored-element] [threshold-type {never |
immediate | consecutive [consecutive-occurrences] | xofy [x-value y-value] | average [number-of-
probes]}] [threshold-value upper-threshold lower-threshold] [action-type {none | trapOnly |
triggerOnly | trapAndTrigger}]
14. ip sla logging traps
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
DETAILED STEPS
Example:
Router# configure terminal
Example:
Router(config)# ip sla 1
Step 4 Do one of the following: Configures the IP SLAs operation as an LSP ping
operation and enters LSP ping configuration mode.
mpls lsp ping ipv4 destination-address destination-mask
[force-explicit-null] [lsp-selector ip-address] [src-ip-addr or
source-address] [reply {dscp dscp-value | mode {ipv4 | Configures the IP SLAs operation as an LSP trace
router-alert}}] operation and enters LSP trace configuration mode.
mpls lsp trace ipv4 destination-address destination-mask
[force-explicit-null] [lsp-selector ip-address] [src-ip-addr
source-address] [reply {dscp dscp-value | mode {ipv4 |
router-alert}}]
Example:
Router(config-ip-sla)# mpls lsp ping ipv4
192.168.1.4 255.255.255.255 lsp-selector 127.1.1.1
Example:
Example:
Router(config-ip-sla)# mpls lsp trace ipv4
192.168.1.4 255.255.255.255 lsp-selector 127.1.1.1
Step 5 exp exp-bits (Optional) Specifies the experimental field value in the
header for an echo request packet of an IP SLAs
Example: operation.
NoteThe LSP ping configuration mode is used in this
Router(config-sla-monitor-lspPing)# exp 5
example and in the remaining steps. Except where
noted, the same commands are also supported in the
LSP trace configuration mode.
Step 6 request-data-size bytes (Optional) Specifies the protocol data size for a request
packet of an IP SLAs operation.
Example:
Router(config-sla-monitor-lspPing)# request-data-
size 200
Step 7 secondary-frequency {connection-loss | timeout} frequency (Optional) Sets the faster measurement frequency
(secondary frequency) to which an IP SLAs operation
Example: should change when a reaction condition occurs.
Step 9 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
Example: operation.
Step 10 timeout milliseconds (Optional) Specifies the amount of time the IP SLAs
operation waits for a response from its request packet.
Example:
Router(config-sla-monitor-lspPing)# timeout 7000
Step 11 ttl time-to-live (Optional) Specifies the maximum hop count for an
echo request packet of an IP SLAs operation.
Example:
Router(config-sla-monitor-lspPing)# ttl 200
Step 12 exit Exits LSP ping or LSP trace configuration submode and
returns to global configuration mode.
Example:
Router(config-sla-monitor-lspPing)# exit
Step 13 ip sla reaction-configuration operation-number [react (Optional) Configures certain actions to occur based on
monitored-element] [threshold-type {never | immediate | events under the control of Cisco IOS IP SLAs.
consecutive [consecutive-occurrences] | xofy [x-value y-value] |
average [number-of-probes]}] [threshold-value upper-
threshold lower-threshold] [action-type {none | trapOnly |
triggerOnly | trapAndTrigger}]
Example:
Router(config)# ip sla reaction-configuration 1
react connectionLoss threshold-type consecutive 3
action-type traponly
Step 14 ip sla logging traps (Optional) Enables the generation of SNMP system
logging messages specific to IP SLAs trap notifications.
Example:
Router(config)# ip sla logging traps
Step 15 ip sla schedule operation-number [life {forever | seconds}] Configures the scheduling parameters for an IP SLAs
[start-time {hh : mm[: ss] [month day | day month] | pending | operation.
now | after hh : mm : ss}] [ageout seconds] [recurring]
Example:
Router(config)# ip sla schedule 1 start-time now
Troubleshooting Tips
Use the debug ip sla trace and debug ip sla error commands to help troubleshoot issues with an
individual IP SLAs LSP ping or LSP traceroute operation.
What to Do Next
To display the results of an individual 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.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. mpls lsp ping pseudowire peer-ipaddr vc-id [source-ipaddr source-ipaddr]
5. exp exp-bits
6. frequency seconds
7. request-data-size bytes
8. secondary-frequency {both | connection-loss | timeout} frequency
9. tag text
10. threshold milliseconds
11. timeout milliseconds
12. exit
13. ip sla reaction-configuration operation-number [react monitored-element] [threshold-type {never |
immediate | consecutive [consecutive-occurrences] | xofy [x-value y-value] | average [number-of-
probes]}] [threshold-value upper-threshold lower-threshold] [action-type {none | trapOnly |
triggerOnly | trapAndTrigger}]
14. ip sla logging traps
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
DETAILED STEPS
Example:
Router# configure terminal
Step 4 mpls lsp ping pseudowire peer-ipaddr vc-id [source-ipaddr Configures the IP SLAs operation as an LSP pseudo-
source-ipaddr] wire ping and enters VCCV configuration mode.
Example:
Router(config-ip-sla)# mpls lsp ping
pseudowire 192.168.1.103 123 source-ipaddr
192.168.1.102
Example:
Router(config-sla-vccv)# exp 5
Step 7 request-data-size bytes (Optional) Specifies the protocol data size for a
request packet of an IP SLAs operation.
Example:
Router(config-sla-vccv)# request-data-size 200
Step 8 secondary-frequency {both | connection-loss | timeout} (Optional) Sets the faster measurement frequency
frequency (secondary frequency) to which an IP SLAs operation
should change when a reaction condition occurs.
Example:
Router(config-sla-vccv)# secondary-frequency
connection-loss 10
Step 10 threshold milliseconds (Optional) Sets the upper threshold value for
calculating network monitoring statistics created by an
Example: IP SLAs operation.
Example:
Router(config-sla-vccv)# threshold 6000
Step 11 timeout milliseconds (Optional) Specifies the amount of time the IP SLAs
operation waits for a response from its request packet.
Example:
Router(config-sla-vccv)# timeout 7000
Step 13 ip sla reaction-configuration operation-number [react (Optional) Configures certain actions to occur based
monitored-element] [threshold-type {never | immediate | on events under the control of Cisco IOS IP SLAs.
consecutive [consecutive-occurrences] | xofy [x-value y-value] |
average [number-of-probes]}] [threshold-value upper-threshold
lower-threshold] [action-type {none | trapOnly | triggerOnly |
trapAndTrigger}]
Example:
Router(config)# ip sla reaction-configuration 777
react connectionLoss threshold-type consecutive 3
action-type traponly
Step 14 ip sla logging traps (Optional) Enables the generation of SNMP system
logging messages specific to IP SLAs trap
Example: notifications.
Step 15 ip sla schedule operation-number [life {forever | seconds}] Configures the scheduling parameters for an IP SLAs
[start-time {hh : mm[: ss] [month day | day month] | pending | operation.
now | after hh : mm : ss}] [ageout seconds] [recurring]
Example:
Router(config)# ip sla schedule 777 life forever start-
time now
Troubleshooting Tips
Use the debug ip sla trace and debug ip sla error commands to help troubleshoot issues with an
individual IP SLAs PWE3 service via VCCV operation.
What to Do Next
To display the results of an individual 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.
DETAILED STEPS
Step 2 debug ip sla mpls-lsp-monitor [operation-number] (Optional) Enables debugging output of LSP Health Monitor
operations.
Example:
Router# debug ip sla mpls-lsp-monitor
Step 3 debug ip sla trace [operation-number] (Optional) Enables debugging output for tracing the execution
of IP SLAs operations.
Example:
Router# debug ip sla trace
Step 4 show ip sla mpls-lsp-monitor collection-statistics (Optional) Displays the statistics for IP SLAs operations
[group-id] belonging to an LSP discovery group of an LSP Health
Monitor operation.
NoteThis command is applicable only if the LSP discovery
option is enabled.
Example:
Router# show ip sla mpls-lsp-monitor collection-
statistics 100001
Step 5 show ip sla mpls-lsp-monitor configuration [operation- (Optional) Displays configuration settings for LSP Health
number] Monitor operations.
Example:
Router# show ip sla mpls-lsp-monitor
configuration 1
Step 6 show ip sla mpls-lsp-monitor lpd operational-state (Optional) Displays the operational status of the LSP
[group-id] discovery groups belonging to an LSP Health Monitor
operation.
Example: NoteThis command is applicable only if the LSP discovery
option is enabled.
Router# show ip sla mpls-lsp-monitor lpd
operational-state 100001
Step 7 show ip sla mpls-lsp-monitor neighbors (Optional) Displays routing and connectivity information
about MPLS VPN BGP next hop neighbors discovered by the
Example: LSP Health Monitor operation.
Step 8 show ip sla mpls-lsp-monitor scan-queue operation- (Optional) Displays information about adding or deleting
number BGP next hop neighbors from a particular MPLS VPN of an
LSP Health Monitor operation.
Example:
Router# show ip sla mpls-lsp-monitor scan-queue 1
Step 9 show ip sla mpls-lsp-monitor summary [operation- (Optional) Displays BGP next hop neighbor and LSP
number [group [group-id]]] discovery group information for LSP Health Monitor
operations.
Example: NoteThis command is applicable only if the LSP discovery
option is enabled.
Router# show ip sla mpls-lsp-monitor summary
Step 10 show ip sla statistics [operation-number] [details] (Optional) Displays the current operational status and
statistics of all IP SLAs operations or a specified operation.
Example: NoteThis command applies only to manually configured IP
SLAs operations.
Router# show ip sla statistics 100001
Step 11 show ip sla statistics aggregated [operation-number] (Optional) Displays the aggregated statistical errors and
[details] distribution information for all IP SLAs operations or a
specified operation.
Example: NoteThis command applies only to manually configured IP
SLAs operations.
Router# show ip sla statistics aggregated 100001
Example Configuring and Verifying the LSP Health Monitor Without LSP
Discovery
The figure below illustrates a simple VPN scenario for an ISP. This network consists of a core MPLS VPN
with four PE routers belonging to three VPNs: red, blue, and green. From the perspective of router PE1,
these VPNs are reachable remotely through BGP next hop routers PE2 (router ID: 10.10.10.5), PE3 (router
ID: 10.10.10.7), and PE4 (router ID: 10.10.10.8).
Figure 7: Network Used for LSP Health Monitor Example
The following example shows how to configure operation parameters, proactive threshold monitoring, and
scheduling options on router PE1 (see the figure above) using the LSP Health Monitor. In this example, the
LSP discovery option is enabled for LSP Health Monitor operation 1. Operation 1 is configured to
automatically create IP SLAs LSP ping operations for all BGP next hop neighbors (PE2, PE3, and PE4) in
use by all VRFs (red, blue, and green) associated with router PE1. The BGP next hop neighbor process is
enabled, and the time interval at which routing entries that are no longer valid are removed from the BGP
next hop neighbor discovery database is set to 60 seconds. The time interval at which the LSP Health
Monitor checks the scan queue for BGP next hop neighbor updates is set to 1 minute. The secondary
frequency option is enabled for both connection loss and timeout events, and the secondary frequency is set
to 10 seconds. As specified by the proactive threshold monitoring configuration, when three consecutive
connection loss or timeout events occur, an SNMP trap notification is sent. Multioperation scheduling and
the generation of IP SLAs SNMP system logging messages are enabled.
Threshold Count : 3
Action Type : Trap Only
The following is sample output from the show mpls discovery vpn command for router PE1:
The following is sample output from the show ip sla mpls-lsp-monitor neighbors command for router
PE1:
The following is sample output from the show ip sla mpls-lsp-monitor scan-queue 1 and debug ip sla
mpls-lsp-monitor commands when IP connectivity from router PE1 to router PE4 is lost. This output
shows that connection loss to each of the VPNs associated with router PE4 (red, blue, and green) was
detected and that this information was added to the LSP Health Monitor scan queue. Also, since router PE4
is no longer a valid BGP next hop neighbor, the IP SLAs operation for router PE4 (Probe 10003) is being
deleted.
The following is sample output from the show ip sla mpls-lsp-monitor scan-queue 1 and debug ip sla
mpls-lsp-monitor commands when IP connectivity from router PE1 to router PE4 is restored. This output
shows that each of the VPNs associated with router PE4 (red, blue, and green) were discovered and that
this information was added to the LSP Health Monitor scan queue. Also, since router PE4 is a newly
discovered BGP next hop neighbor, a new IP SLAs operation for router PE4 (Probe 100005) is being
created and added to the LSP Health Monitor multioperation schedule. Even though router PE4 belongs to
three VPNs, only one IP SLAs operation is being created.
Example Configuring and Verifying the LSP Health Monitor with LSP
Discovery
The figure below illustrates a simple VPN scenario for an ISP. This network consists of a core MPLS VPN
with two PE routers belonging to a VPN named red. From the perspective of router PE1, there are three
equal-cost multipaths available to reach router PE2.
Figure 8: Network Used for LSP Health Monitor with LSP Discovery Example
The following example shows how to configure operation parameters, proactive threshold monitoring, and
scheduling options on router PE1 (see the figure above) using the LSP Health Monitor. In this example, the
LSP discovery option is enabled for LSP Health Monitor operation 100. Operation 100 is configured to
automatically create IP SLAs LSP ping operations for all equal-cost multipaths between router PE1 and
router PE2. The BGP next hop neighbor process is enabled, and the time interval at which routing entries
that are no longer valid are removed from the BGP next hop neighbor discovery database is set to 30
seconds. The time interval at which the LSP Health Monitor checks the scan queue for BGP next hop
neighbor updates is set to 1 minute. The secondary frequency option is enabled for both connection loss
and timeout events, and the secondary frequency is set to 5 seconds. The explicit null label option for echo
request packets is enabled. The LSP rediscovery time period is set to 3 minutes. As specified by the
proactive threshold monitoring configuration, an SNMP trap notification will be sent when an LSP
discovery group status changes occurs. Multioperation scheduling and the generation of IP SLAs SNMP
system logging messages are enabled.
The following is sample output from the show ip sla mpls-lsp-monitor configuration command for router
PE1:
The following is sample output from the show mpls discovery vpn command for router PE1:
The following is sample output from the show ip sla mpls-lsp-monitor neighbors command for router
PE1:
The following is sample output from the show ip sla mpls-lsp-monitor lpd operational-state command
for LSP discovery group 100001:
The following is sample output from the show ip sla mpls-lsp-monitor collection-statistics command for
LSP discovery group 100001:
The following is sample output from the show ip sla mpls-lsp-monitor summary command for LSP
Health Monitor operation 100:
The following is sample output from the show ip sla mpls-lsp-monitor summary command for LSP
discovery group 100001:
ip sla 1
mpls lsp ping ipv4 192.168.1.4 255.255.255.255 lsp-selector 127.1.1.1
frequency 120
secondary-frequency timeout 30
!
ip sla reaction-configuration 1 react connectionLoss threshold-type consecutive 3 action-
type trapOnly
ip sla reaction-configuration 1 react timeout threshold-type consecutive 3 action-type
trapOnly
ip sla logging traps
!
ip sla schedule 1 start-time now life forever
ip sla 777
mpls lsp ping pseudowire 192.168.1.103 123
exp 5
frequency 120
secondary-frequency timeout 30
tag testgroup
threshold 6000
timeout 7000
exit
!
ip sla reaction-configuration 777 react rtt threshold-value 6000 3000 threshold-type
immediate 3 action-type traponly
ip sla reaction-configuration 777 react connectionLoss threshold-type immediate action-
type traponly
ip sla reaction-configuration 777 react timeout threshold-type consecutive 3 action-type
traponly
ip sla logging traps
!
ip sla schedule 777 life forever start-time now
exit
RTT Thresholds
The threshold command configures 6000 milliseconds as the amount of time for a rising threshold to be
declared on the monitored pseudo-wire. The first ip sla reaction-configuration command specifies that an
SNMP logging trap is to be sent immediately if the round-trip time violates the upper threshold of 6000
milliseconds or the lower threshold of 3000 milliseconds.
Connection Loss
The second ip sla reaction-configuration command specifies that an SNMP logging trap is to be sent
immediately if a connection loss occurs for the monitored pseudo-wire.
Response Timeout
The timeout command configures 7000 seconds as the amount of time that VCCV operation 777 waits for
a response from its request packet before a timeout is declared. The secondary-frequency command
specifies that, if a timeout occurs, the measurement frequency of the operation repeats is to be increased
from 120 seconds (the initial measurement frequency specified using the frequency command) to a faster
rate of 30 seconds. The third ip sla reaction-configuration command specifies that an SNMP logging trap
is to be sent if three consecutive timeouts occur.
Additional References
Related Documents
MPLS LSP discovery management tool MPLS EM-MPLS LSP Multipath Tree Trace
chapter of the Cisco IOS Multiprotocol Label
Switching Configuration Guide
Configuring standard IP access lists Access Control Lists chapter of the Cisco IOS
Security Configuration Guide: Securing the Data
Plane
Multioperation scheduling for Cisco IOS IP SLAs Configuring Multioperation Scheduling of IP SLAs
Operations chapter of the Cisco IOS IP SLAs
Configuration Guide
Proactive threshold monitoring for Cisco IOS IP Configuring Proactive Threshold Monitoring of IP
SLAs SLAs Operations chapter of the Cisco IOS IP SLAs
Configuration Guide
Cisco IOS commands Cisco IOS Master Commands List, All Releases
Standards
Standard Title
draft-ietf-mpls-lsp-ping-09.txt Detecting MPLS Data Plane Failures
MIBs
RFCs
RFC Title
No new or modified RFCs are supported by this --
feature, and support for existing RFCs has not been
modified by this feature.
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support.
To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not
required.
IP SLAs--LSP Health Monitor 12.2(31)SB2 12.2(33)SRB The LSP discovery capability was
with LSP Discovery 15.0(1)SCisco IOS XE 3.1.0SG added.
IP SLAs for MPLS Pseudo Wire 12.2(33)SB 12.2(33)SRC The IP SLAs VCCV operation
(PWE3) via VCCV 15.0(1)SCisco IOS XE 3.1.0SG was added to support Virtual
Circuit Connectivity Verification
(VCCV) for Pseudo-Wire
Emulation Edge-to-Edge (PWE3)
services across MPLS networks.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
Configuring an IP SLAs Auto Ethernet Operation with Endpoint Discovery on the Source Device,
page 85
Manually Configuring an IP SLAs Ethernet Ping or Jitter Operation on the Source Device, page 87
Scheduling IP SLAs Operations, page 90
1. enable
2. configure terminal
3. ip sla ethernet-monitor operation-number
4. type echo domain domain-name {evc evc-id | vlan vlan-id} [exclude-mpids mp-ids]
5. type jitter domain domain-name {evc evc-id | vlan vlan-id} [exclude-mpids mp-ids] [interval
interframe-interval] [num-frames frames-number]
6. cos cos-value
7. owner owner-id
8. request-data-size bytes
9. tag text
10. threshold milliseconds
11. timeout milliseconds
12. end
13. show ip sla ethernet-monitor configuration [operation-number]
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla ethernet-monitor operation-number Begins configuration for an IP SLAs auto Ethernet
operation and enters IP SLA Ethernet monitor
configuration mode.
Example:
Router(config)# ip sla ethernet-monitor 1
Step 4 type echo domain domain-name {evc evc-id | vlan vlan-id} For Echo operations only:
[exclude-mpids mp-ids] Configures an auto Ethernet operation for Ethernet ping
operations.
Example:
Router(config-ip-sla-ethernet-monitor)# type echo
domain testdomain vlan 34
Step 5 type jitter domain domain-name {evc evc-id | vlan vlan-id} For Jitter operations only:
[exclude-mpids mp-ids] [interval interframe-interval] [num- Configures an auto Ethernet operation for Ethernet jitter
frames frames-number] operations.
Example:
Router(config-ip-sla-ethernet-monitor)# type jitter
domain testdomain evc testevc interval 20 num-
frames 30
Step 6 cos cos-value (Optional) Sets the class of service for an IP SLAs
Ethernet operation.
Example:
Router(config-ip-sla-ethernet-params)# cos 2
Step 8 request-data-size bytes (Optional) Sets the padding size for the data frame of an IP
SLAs Ethernet operation.
Example: The default value for IP SLAs Ethernet ping
Router(config-ip-sla-ethernet-params)# request-data- operations is 66 bytes.
size 64 The default value for IP SLAs Ethernet jitter
operations is 51 bytes.
Step 9 tag text (Optional) Creates a user-specified identifier for an IP
SLAs operation.
Example:
Router(config-ip-sla-ethernet-params)# tag
TelnetPollSever1
Step 10 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
operation.
Example:
Router(config-ip-sla-ethernet-params)# threshold
10000
Step 11 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-ip-sla-ethernet-params)# timeout 10000
Example:
Router(config-ip-sla-ethernet-params)# end
Step 13 show ip sla ethernet-monitor configuration [operation- (Optional) Displays configuration settings for all IP SLAs
number] auto Ethernet operations or a specified auto Ethernet
operation.
Example:
Router# show ip sla ethernet-monitor configuration 1
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. ethernet echo mpid mp-id domain domain-name {evc evc-id | port | vlan vlan-id}
5. ethernet jitter mpid mp-id domain domain-name {evc evc-id | port | vlan vlan-id} [interval
interframe-interval] [num-frames frames-number]
6. cos cos-value
7. frequency seconds
8. history history-parameter
9. owner owner-id
10. request-data-size bytes
11. tag text
12. threshold milliseconds
13. timeout milliseconds
14. end
15. show ip sla configuration [operation-number]
16. show ip sla application
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla operation-number Begins configuration for an IP SLAs operation and enters IP
SLA configuration mode.
Example:
Router(config)# ip sla 1
Step 4 ethernet echo mpid mp-id domain domain-name {evc For a ping operation only:
evc-id | port | vlan vlan-id} Configures the IP SLAs operation as an Ethernet ping
operation and enters Ethernet echo configuration mode.
Example:
Router(config-ip-sla)# ethernet echo mpid 23
domain testdomain vlan 34
Example:
Router(config-ip-sla)# ethernet jitter mpid 23
domain testdomain evc testevc interval 20 num-
frames 30
Step 6 cos cos-value (Optional) Sets the class of service for an IP SLAs Ethernet
operation.
Example: NoteFor this and the remaining steps, the configuration mode
shown in the example is for the Ethernet echo operation.
Router(config-ip-sla-ethernet-echo)# cos 2
However, the commands are the same in the Ethernet jitter
configuration mode.
Step 7 frequency seconds (Optional) Sets the rate at which a specified IP SLAs operation
repeats.
Example:
Router(config-ip-sla-ethernet-echo)# frequency
30
Step 8 history history-parameter (Optional) Specifies the parameters used for gathering
statistical history information for an IP SLAs operation.
Example:
Router(config-ip-sla-ethernet-echo)# history
hours-of-statistics-kept 3
Step 10 request-data-size bytes (Optional) Sets the padding size for the data frame of an IP
SLAs Ethernet operation.
Example: The default value for IP SLAs Ethernet ping operations is 66
bytes. The default value for IP SLAs Ethernet jitter operations
Router(config-ip-sla-ethernet-echo)# request-
data-size 64 is 51 bytes.
Step 11 tag text (Optional) Creates a user-specified identifier for an IP SLAs
operation.
Example:
Router(config-ip-sla-ethernet-echo)# tag
TelnetPollSever1
Step 12 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs operation.
Example:
Router(config-ip-sla-ethernet-echo)# threshold
10000
Step 13 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation waits
for a response from its request packet.
Example:
Router(config-ip-sla-ethernet-echo)# timeout
10000
Example:
Router(config-ip-sla-ethernet-echo)# end
Step 15 show ip sla configuration [operation-number] (Optional) Displays configuration values including all defaults
for all IP SLAs operations or a specified operation.
Example:
Router# show ip sla configuration 1
Step 16 show ip sla application (Optional) Displays global information about supported IP
SLAs features.
Example:
Router# show ip sla application
Note
All IP SLAs operations to be scheduled must be already configured.
The frequency of all operations scheduled in an operation group must be the same unless you are
enabling the random scheduler option for a multioperation scheduler.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla ethernet-monitor schedule operation-number schedule-period seconds [frequency [seconds]]
[start-time {after hh : mm : ss | hh : mm[: ss] [month day | day month] | now | pending}]
4. 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]
5. ip sla group schedule group-operation-number operation-id-numbers schedule-period schedule-
period-range [ageout seconds] [frequency group-operation-frequency] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
6. exit
7. show ip sla group schedule
8. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla ethernet-monitor schedule operation-number schedule-period For individual auto Ethernet operations only:
seconds [frequency [seconds]] [start-time {after hh : mm : ss | hh : mm[: Configures scheduling parameters for an IP
ss] [month day | day month] | now | pending}] SLAs auto Ethernet operation.
Example:
Router(config)# ip sla ethernet-monitor schedule 10 schedule-
period 60 start-time now
Step 4 ip sla schedule operation-number [life {forever | seconds}] [start-time {hh For individual IP SLAs operations only:
: mm[: ss] [month day | day month] | pending | now | after hh : mm : ss}] Configures the scheduling parameters for an
[ageout seconds] [recurring] individual IP SLAs operation.
Example:
Router(config)# ip sla schedule 1 start-time now life forever
Step 5 ip sla group schedule group-operation-number operation-id-numbers For mulioperation scheduler only:
schedule-period schedule-period-range [ageout seconds] [frequency Specifies an IP SLAs operation group
group-operation-frequency] [life{forever | seconds}] [start- number and the range of operation numbers
Example:
Router(config)# ip sla group schedule 1 3,4,6-9
Example:
Router(config)# exit
Step 7 show ip sla group schedule (Optional) Displays the IP SLAs group
schedule details.
Example:
Router# show ip sla group schedule
Troubleshooting Tips
Use the debug ip sla trace and debug ip sla error commands to help troubleshoot issues with an
individual IP SLAs Ethernet ping or Ethernet jitter operation. Use the debug ip sla ethernet-monitor
command to help troubleshoot issues with an IP SLAs auto Ethernet operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
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 A
ip sla ethernet-monitor 10
type echo domain testdomain vlan 34
!
ip sla ethernet-monitor reaction-configuration 10 react connectionLoss threshold-type
consecutive 3 action-type trapOnly
!
ip sla ethernet-monitor schedule 10 schedule-period 60 start-time now
Configuration B
ip sla ethernet-monitor 20
type echo domain testdomain evc testevc
!
ip sla ethernet-monitor reaction-configuration 20 react connectionLoss threshold-type
consecutive 3 action-type trapOnly
!
ip sla ethernet-monitor schedule 20 schedule-period 60 start-time now
Configuration C
ip sla 1
ethernet echo mpid 23 domain testdomain vlan 34
!
ip sla reaction-configuration 1 react connectionLoss threshold-type consecutive 3 action-
type trapOnly
!
ip sla schedule 1 start-time now
Configuration D
ip sla 5
ethernet echo mpid 23 domain testdomain evc testevc
!
ip sla reaction-configuration 5 react connectionLoss threshold-type consecutive 3 action-
type trapOnly
!
ip sla schedule 5 start-time now
Additional References
Related Documents
Multioperation scheduling for Cisco IOS IP SLAs Configuring a Multiple Operation Scheduler
module of the Cisco IOS IP SLAs Configuration
Guide
Proactive threshold monitoring for Cisco IOS IP Configuring Proactive Threshold Monitoring of IP
SLAs SLAs Operations module of the Cisco IOS IP SLAs
Configuration Guide
Standards
Standard Title
IEEE 802.1ag Connectivity Fault Management
MIBs
RFCs
RFC Title
No new or modified RFCs are supported by this --
feature, and support for existing RFCs has not been
modified by this feature.
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
IP SLAs Metro-Ethernet 3.0 12.2(33)SRE 15.0(1)S Support for port level statistical
(CFM d8.1) measurements was added.
IEEE 802.1ag - D8.1 standard 15.1(1)T Support for CFM d8.1 replaced
Compliant CFM, IP SLA for support for CFM d1.0. IP SLAs
Ethernet integration with CFM d1.0
continues to be supported in
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
Because 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.
packet is greater than that of the next packet, the first packet was delivered out of order on the source-to-
destination path. For the destination-to-source path, the same method can be applied. Note that if the packet
is out of order on the source-to-destination path, it should be returned out of order to the sender unless there
is also misordering on the destination-to-source path.
If any packet cannot be sent due to an internal or unexpected error, or because the timerwheel slot
containing the packet is missed, it is counted as Packet Skipped. This metric is very important because
statistics are measured on sent packets only.
All timed-out packets are counted towards Packet Loss. Successive packet loss is calculated by counting,
and adding, the number of successive dropped packets. Successive packet loss is reported as minimum of
successive packet drop and maximum of successive packet drop.
All other statistics are calculated using the same logic as a UDP jitter operation.
Note This operation does not require an IP SLAs Responder on the destination device.
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. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla operation-number Begins configuration for an IP SLAs operation and enters
IP SLA configuration mode.
Example:
Router(config)# ip sla 10
Step 4 icmp-jitter {destination-ip-address | destination-hostname} Configures the IP SLAs operation as an ICMP jitter
[interval milliseconds] [num-packets packet-number] operation and enters IP SLAs ICMP jitter configuration
[source-ip {ip-address | hostname}] mode.
Example:
Router(config-ip-sla)# icmp-jitter 172.18.1.129
interval 40 num-packets 100 source-ip 10.1.2.34
Step 5 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-icmpjitter)# frequency 30
Step 6 history history-parameter (Optional) Specifies the parameters used for gathering
statistical history information for an IP SLAs operation.
Example:
Router(config-ip-sla-icmpjitter)# history hours-of-
statistics-kept 3
Step 10 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-ip-sla-icmpjitter)# timeout 10000
Step 11 tos number (Optional) Defines a type of service (ToS) byte in the IP
header of an IP SLAs operation.
Example:
Router(config-ip-sla-icmpjitter)# tos 160
Example:
Router(config-ip-sla-icmpjitter)# end
Note
All IP SLAs operations to be scheduled must be already configured.
The frequency of all operations scheduled in a multioperation group must be the same.
List of one or more operation ID numbers to be added to a multioperation group is limited to a
maximum of 125 characters, including commas (,).
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
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]
ip sla group schedule group-operation-number operation-id-numbers schedule-period schedule-
period-range [ageout seconds] [frequency group-operation-frequency] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
4. exit
5. show ip sla group schedule
6. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
ip sla schedule operation-number [life {forever | seconds}] [start-time Configures the scheduling parameters for an
{hh : mm[: ss] [month day | day month] | pending | now | after hh : mm individual IP SLAs operation.
: ss}] [ageout seconds] [recurring] or
ip sla group schedule group-operation-number operation-id-numbers For multioperation scheduler only:
schedule-period schedule-period-range [ageout seconds] [frequency
group-operation-frequency] [life{forever | seconds}] [start- Specifies an IP SLAs operation group
time{hh:mm[:ss] [month day | day month] | pending | now | after number and the range of operation numbers
hh:mm:ss}] to be scheduled in global configuration
mode.
Example:
Router(config)# ip sla schedule 10 start-time now life forever
Example:
Router(config)# ip sla group schedule 1 3,4,6-9
Example:
Router(config)# exit
Step 5 show ip sla group schedule (Optional) Displays the IP SLAs group
schedule details.
Example:
Router# show ip sla group schedule
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
ip sla 10
Additional References
Related Documents
Cisco IOS IP SLAs: general information Cisco IOS IP SLAs Overview chapter of the Cisco
IOS IP SLAs Configuration Guide.
Standards
Standard Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by this feature.
MIBs
RFCs
RFC Title
RFC 792 Internet Control Message Protocol
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
Table 15: Statistics Gathered by the RTP-Based VoIP Operation for c549 DSPs
Statistics Description
Interarrival jitter (destination-to-source and source- Interarrival jitter is the mean deviation (smoothed
to-destination) absolute value) of the difference in packet spacing
for a pair of packets.
The source-to-destination value is measured by
sending RTP packets to the IP SLAs Responder. No
values are obtained from the DSP for this
measurement.
Statistics Description
For more information about interarrival jitter, see
RFC 3550 (RTP: A Transport Protocol for Real-
Time Applications ).
MOS-CQ (destination-to-source and source-to- Mean Opinion Score for Conversational Quality.
destination)
This value is obtained by conversion of the
estimated R factor to Mean Opinion Score (MOS)
using ITU-T Recommendation G.107 conversion
tables.
The source-to-destination value is measured by
sending RTP packets to the IP SLAs Responder. No
values are obtained from the DSP for this
measurement.
Round-trip time (RTT) latency Round-trip time latency for an RTP packet to travel
from the source to the destination and back to the
source.
One-way latency (destination-to-source and source- Average, minimum, and maximum latency values.
to-destination)
These values are measured by sending RTP packets
to IP SLAs Responder. The RTP data stream is then
looped back from the destination to the source
gateway.
Table 16: Statistics Gathered by the RTP-Based VoIP Operation for c5510 DSPs
Statistics Description
Interarrival jitter (destination-to-source and source- Interarrival jitter is the mean deviation (smoothed
to-destination) absolute value) of the difference in packet spacing
for a pair of packets.
The source-to-destination value is measured by
sending RTP packets to the IP SLAs Responder. No
values are obtained from the DSP for this
measurement.
For more information on how this value is
calculated, see RFC 1889 (RTP: A Transport
Protocol for Real-Time Applications ).
MOS-CQ (destination-to-source and source-to- Mean Opinion Score for Conversational Quality.
destination)
This value is obtained by conversion of the
estimated R factor to Mean Opinion Score (MOS)
using ITU-T Recommendation G.107 conversion
tables.
The source-to-destination value is measured by
sending RTP packets to the IP SLAs Responder. No
values are obtained from the DSP for this
measurement.
Round-trip time (RTT) latency Round-trip time latency for an RTP packet to travel
from the source to the destination and back to the
source.
Statistics Description
values are obtained from the DSP for this
measurement.
One-way latency (destination-to-source and source- Average, minimum, and maximum latency values.
to-destination)
These values are measured by sending RTP packets
to IP SLAs Responder. The RTP data stream is then
looped back from the destination to the source
gateway.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. voip rtp {destination-ip-address | destination-hostname} source-ip {ip-address | hostname} source-
voice-port {slot [/ subunit / port : ds0-group-number]} [codec codec-type] [duration seconds]
[advantage-factor value]
5. frequency seconds
6. history history-parameter
7. owner text
8. tag text
9. threshold milliseconds
10. timeout milliseconds
11. exit
12. 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]
13. 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]
14. exit
15. show ip sla configuration [operation-number]
DETAILED STEPS
Example:
Router# configure terminal
Step 4 voip rtp {destination-ip-address | destination-hostname} source-ip Enters IP SLAs VoIP RTP configuration mode and
{ip-address | hostname} source-voice-port {slot [/ subunit / port : configures the IP SLAs operation as an RTP-based
ds0-group-number]} [codec codec-type] [duration seconds] VoIP operation.
[advantage-factor value]
Example:
Router(config-ip-sla)# voip rtp 10.2.3.4 source-ip
10.5.6.7 source-voice-port 1/0:1 codec g711alaw duration
30 advantage-factor 5
Router(config-ip-sla-voip-rtp)# frequency 90
Step 9 threshold milliseconds (Optional) Sets the upper threshold value for
calculating network monitoring statistics created by
Example: an IP SLAs operation.
Step 12 ip sla reaction-configuration operation-number react monitored- (Optional) Configures certain actions to occur based
element [action-type option] [threshold-type {average [number- on events under the control of Cisco IOS IP SLAs.
of-measurements] | consecutive [occurrences] | immediate | never |
xofy [x-value y-value]}] [threshold-value upper-threshold lower-
threshold]
Example:
Router(config)# ip sla reaction-configuration 1 react
frameLossDS action-type traponly threshold-type
consecutive 3
Step 13 ip sla schedule operation-number [life {forever | seconds}] [start- Specifies the scheduling parameters for an IP SLAs
time {hh : mm[: ss] [month day | day month] | pending | now | after operation.
hh : mm : ss}] [ageout seconds] [recurring]
Example:
Router(config)# ip sla schedule 1 start-time now life
forever
Step 15 show ip sla configuration [operation-number] (Optional) Displays configuration values including
all defaults for all IP SLAs operations or a specified
Example: operation.
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla 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 aggregatedcommands. Checking the output for fields that correspond to criteria in your service
level agreement will help you determine whether the service metrics are acceptable.
ip sla 1
voip rtp 10.2.3.4 source-ip 10.5.6.7 source-voice-port 1/0:1 codec g711alaw duration 30
advantage-factor 5
!
ip sla reaction-configuration 1 react FrameLossDS action-type traponly threshold-type
consecutive 3
!
ip sla schedule 1 start-time now life forever
Use the show ip sla statistics command in privileged EXEC mode to display the current operational status
and statistics for an IP SLAs operation. Use the show ip sla statistics aggregated command in privileged
EXEC mode to display the aggregated hourly status and statistics for an IP SLAs operation.
Additional References
The following sections provide references related to the IP SLAs RTP-Based VoIP Operation feature.
Related Documents
Cisco IOS commands Cisco IOS Master Commands List, All Releases
Standards
Standard Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by this feature.
MIBs
RFCs
RFC Title
No new or modified RFCs are supported by this --
feature, and support for existing RFCs has not been
modified by this feature.
Technical Assistance
Description Link
The Cisco Technical Support & Documentation http://www.cisco.com/techsupport
website contains thousands of pages of searchable
technical content, including links to products,
technologies, solutions, technical tips, and tools.
Registered Cisco.com users can log in from this
page to access even more content.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
You cannot configure the IP SLAs VoIP gatekeeper registration delay operation if the gatekeeper has
already been registered with the gateway.
1. enable
2. configure terminal
3. gateway
4. exit
5. interface interface-id
6. ip address ip-address subnet-mask
7. h323-gateway voip interface
8. h323-gateway voip id gatekeeper-id {ipaddr ip-address [port-number] | multicast}
9. h323-gateway voip h323-id interface-id
10. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 gateway Enables the H.323 VoIP gateway and enters gateway
configuration mode.
Example:
Router(config)# gateway
Example:
Router(config-if)# ip address 172.29.129.123
255.255.255.0
Step 8 h323-gateway voip id gatekeeper-id {ipaddr ip-address [port- Defines the name and location of the gatekeeper for a
number] | multicast} specific gateway.
Repeat this step for each ID (see example).
Example:
[priority number]
Example:
Router(config-if)# h323-gateway voip id zone1 ipaddr
172.29.129.124 1719
Example:
Router(config-if)# h323-gateway voip id saagk ipaddr
172.29.129.28 1719
Step 9 h323-gateway voip h323-id interface-id Configures the H.323 name of the gateway that
identifies this gateway to its associated gatekeeper.
Example:
Router(config-if)# h323-gateway voip h323-id GWZ
Example
The following example shows sample output from the show gateway command if the gateway (named
GW3) is registered to a gatekeeper (named slagk):
H323-ID GW3
H323 resource thresholding is Disabled
The following example shows sample output for the show gateway command if the gateway is not
registered to a gatekeeper:
Use theshow gatekeeper endpoint command to verify the endpoints registration status to the gatekeeper.
The following example shows the common output of this command if an endpoint is registered:
The following example shows the common output of the show gatekeeper endpoint command if an
endpoint is not registered:
gateway
interface Ethernet1/1
ip address 172.29.129.123 255.255.255.0
h323-gateway voip interface
h323-gateway voip id zone1 ipaddr 172.29.129.124 1719
h323-gateway voip id saagk ipaddr 172.29.129.28 1719
h323-gateway voip h323-id GWZ
Troubleshooting Tips
To troubleshoot registration issues, see the Troubleshooting Gatekeeper Registration Issues technical
assistance document.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. voip delay gatekeeper-registration
5. history buckets-kept size
6. history distributions-of-statistics-kept size
7. history enhanced [interval seconds] [buckets number-of-buckets]
8. history filter {none | all | overThreshold | failures}
9. frequency seconds
10. history hours-of-statistics-kept hours
11. history lives-kept lives
12. owner owner-id
13. history statistics-distribution-interval milliseconds
14. tag text
15. threshold milliseconds
16. timeout milliseconds
17. verify-data
18. exit
19. 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]
20. exit
21. show ip sla configuration [operation-number]
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla operation-number Begins configuration for an IP SLAs operation and enters
IP SLA configuration mode.
Example:
Router(config)# ip sla 10
Router(config-ip-sla)# voip delay gatekeeper- If the gatekeeper has not been registered with the
registration gateway prior to entering this command, the following
error message will be displayed:
No gatekeeper has been registered!
Step 5 history buckets-kept size (Optional) Sets the number of history buckets that are kept
during the lifetime of an IP SLAs operation.
Example:
Router(config-ip-sla-voip)# history buckets-kept 25
Step 6 history distributions-of-statistics-kept size (Optional) Sets the number of statistics distributions kept
per hop during an IP SLAs operation.
Example:
Router(config-ip-sla-voip)# history distributions-
of-statistics-kept 5
Step 7 history enhanced [interval seconds] [buckets number-of- (Optional) Enables enhanced history gathering for an IP
buckets] SLAs operation.
Example:
Router(config-ip-sla-voip)# history enhanced
interval 900 buckets 100
Step 8 history filter {none | all | overThreshold | failures} (Optional) Defines the type of information kept in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-voip)# history filter failures
Step 9 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-voip)# frequency 30
Step 10 history hours-of-statistics-kept hours (Optional) Sets the number of hours for which statistics are
maintained for an IP SLAs operation.
Example:
Router(config-ip-sla-voip)# history hours-of-
statistics-kept 4
Step 11 history lives-kept lives (Optional) Sets the number of lives maintained in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-voip)# history lives-kept 5
Step 13 history statistics-distribution-interval milliseconds (Optional) Sets the time interval for each statistics
distribution kept for an IP SLAs operation.
Example:
Router(config-ip-sla-voip)# history statistics-
distribution-interval 10
Step 15 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
Example: operation.
Step 16 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-ip-sla-voip)# timeout 10000
Step 19 ip sla schedule operation-number [life {forever| seconds}] Configures the scheduling parameters for an individual IP
[start-time {hh:mm[:ss] [month day | day month] | pending | SLAs operation.
now | after hh:mm:ss] [ageout seconds] [recurring]
Example:
Example:
Router(config)# ip sla schedule 5 start-time now
life forever
Step 21 show ip sla configuration [operation-number] (Optional) Displays configuration values including all
defaults for all IP SLAs operations or a specified operation.
Example:
Router# show ip sla configuration 10
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
In the following example, a VoIP gatekeeper registration delay operation is configured and scheduled to
start immediately. This example assumes the gateway to gatekeeper relationship has already been
configured.
Additional References
Related Documents
Gateway and gatekeeper configuration using Cisco Cisco IOS Voice Configuration Library
IOS Release 12.3 and later releases
Standards
Standard Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by this feature.
MIBs
RFCs
RFC Title
No new or modified RFCs are supported by this --
feature, and support for existing RFCs has not been
modified by this feature.
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Table 18: Feature Information for IP SLAs VoIP Gatekeeper Registration Delay Operations
Glossary
Gatekeepers --Network devices that help to facilitate and control H.323-based voice and video
communications across networks. Gatekeepers are responsible for providing address translation between
LAN aliases and IP addresses, call control and routing services to H.323 endpoints, system management,
and security policies. These services provided by the gatekeeper in communicating between H.323
endpoints are defined in RAS.
Gateways --Network devices that provide translation between circuit-switched networks (particularly, H.
320 ISDN) and packet-based networks (for example, H.323 LANs), allowing endpoints in networks with
different transmission formats, codecs, and protocols to communicate.
H.225.0 --Protocol standard that defines the establishment and disconnection of H.323 calls.
H.225.0 RAS --H.225.0 Registration/Admission/Status. Standard that facilitates communication between
H.323 gateways (endpoints) and H.323 gatekeepers.
H.235 --Protocol standard that defines security solutions for H.323 protocols (Q.931, H.245, RAS,
Streams). H.235 was formerly called H.SECURE.
H.245 --Protocol standard that defines connection management and negotiation capabilities between H.323
devices on the network once the call is established by Q.931.
H.323 --An ITU protocol standard for the transmission of real-time audio (Voice/VoIP), video (for
example, videoconferencing), and data information over packet switching-based networks. Such networks
include IP-based (including the Internet) networks, Internet packet exchange-based local-area networks
(LANs), enterprise networks and metropolitan and wide-area networks (WANs). H.323 can also be applied
to multipoint multimedia communications. H.323 defines a distributed architecture for IP telephony
applications, including multimedia, video conferencing, video over the Internet, and VoIP.
Q.931 --Protocol standard that defines the establishment and disconnection of H.323 calls.
RTP/RTCP --Real-time Protocol/Real-Time Control Protocol serves as the standardized means for
transmitting and receiving audio and video streams across the network once the call is established.
VoIP --Voice or Video over Internet Protocol. Sometimes used to refer to all IP telephony applications.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
Note The IP SLAs VoIP Responder application is different from the IP SLAs Responder, which is configured
using a Cisco IOS command.
Note The required configuration for setting up the dial peer will vary slightly depending on whether you are
using H.323 or SIP.
SUMMARY STEPS
1. enable
2. call application session start instance-name [application-name]
3. configure terminal
4. dial-peer voice tag voip
5. destination-pattern [+] string [T]
6. session target {ipv4: destination-address | dns:[$s$. | $d$. | $e$. | $u$.] host-name | enum: table-num |
loopback:rtp | ras | sip-server}
7. session protocol sipv2
8. exit
DETAILED STEPS
Step 2 call application session start instance-name [application-name] Starts a new session of the Cisco IOS IP SLAs VoIP
test-call application.
Example:
Router# call application session start ipsla-testcall
ipsla-testcall
Example:
Router# configure terminal
Step 4 dial-peer voice tag voip Defines a VoIP dial peer and enters dial-peer
configuration mode.
Example:
Router(config)# dial-peer voice 6789 voip
Step 5 destination-pattern [+] string [T] Specifies either the prefix or the full E.164 telephone
number to be used for a dial peer.
Example:
Router(config-dial-peer)# destination-pattern 6789
Example:
Router(config-dial-peer)# session target
ipv4:172.29.129.123
Step 7 session protocol sipv2 (Optional) Specifies SIP as the session protocol for
the VoIP dial peer.
Example: NotePerform this step only if configuring a SIP call.
Router(config-dial-peer)# session protocol sipv2
1. enable
2. configure terminal
3. ip sla operation-number
4. voip delay post-dial [detect-point {alert-ringing | connect-ok}] destination tag
5. history buckets-kept size
6. history distributions-of-statistics-kept size
7. history enhanced [interval seconds] [buckets number-of-buckets]
8. history filter {none | all | overThreshold | failures}
9. frequency seconds
10. history hours-of-statistics-kept hours
11. history lives-kept lives
12. owner owner-id
13. history statistics-distribution-interval milliseconds
14. tag text
15. threshold milliseconds
16. timeout milliseconds
17. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla operation-number Begins configuration for an IP SLAs operation and enters
IP SLA configuration mode.
Example:
Router(config)# ip sla 10
Step 4 voip delay post-dial [detect-point {alert-ringing | connect- Enters IP SLA VoIP configuration mode and configures
ok}] destination tag the operation as a VoIP call setup (post-dial delay)
operation that will generate VoIP call setup response time
Example:
measurements.
Step 5 history buckets-kept size (Optional) Sets the number of history buckets that are kept
during the lifetime of an IP SLAs operation.
Example:
Router(config-ip-sla-voip)# history buckets-kept 25
Step 6 history distributions-of-statistics-kept size (Optional) Sets the number of statistics distributions kept
per hop during an IP SLAs operation.
Example:
Router(config-ip-sla-voip)# history distributions-
of-statistics-kept 5
Step 7 history enhanced [interval seconds] [buckets number-of- (Optional) Enables enhanced history gathering for an IP
buckets] SLAs operation.
Example:
Router(config-ip-sla-voip)# history enhanced
interval 900 buckets 100
Step 8 history filter {none | all | overThreshold | failures} (Optional) Defines the type of information kept in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-voip)# history filter failures
Step 10 history hours-of-statistics-kept hours (Optional) Sets the number of hours for which statistics
are maintained for an IP SLAs operation.
Example:
Router(config-ip-sla-voip)# history hours-of-
statistics-kept 4
Step 11 history lives-kept lives (Optional) Sets the number of lives maintained in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-voip)# history lives-kept 5
Step 13 history statistics-distribution-interval milliseconds (Optional) Sets the time interval for each statistics
distribution kept for an IP SLAs operation.
Example:
Router(config-ip-sla-voip)# history statistics-
distribution-interval 10
Step 15 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
Example: operation.
Step 16 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-ip-sla-voip)# timeout 10000
Example:
Router(config-ip-sla-voip)# exit
Note
All IP SLAs operations to be scheduled must be already configured.
The frequency of all operations scheduled in a multioperation group must be the same.
List of one or more operation ID numbers to be added to a multioperation group is limited to a
maximum of 125 characters, including commas (,).
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
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]
ip sla group schedule group-operation-number operation-id-numbers schedule-period schedule-
period-range [ageout seconds] [frequency group-operation-frequency] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
4. exit
5. show ip sla group schedule
6. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
Example:
Router(config)# ip sla schedule 10 start-time now life forever
Example:
Router(config)# ip sla group schedule 1 3,4,6-9
Example:
Router(config)# exit
Step 5 show ip sla group schedule (Optional) Displays the IP SLAs group
schedule details.
Example:
Router# show ip sla group schedule
Note The required configuration for setting up the dial peer will vary slightly depending on whether you are
using H.323 or SIP.
SUMMARY STEPS
1. enable
2. configure terminal
3. dial-peer voice tag voip
4. incoming called-number tag
5. application application-name
6. session protocol sipv2
7. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 dial-peer voice tag voip Defines a VoIP dial peer and enters dial-peer configuration
mode.
Example:
Router(config)# dial-peer voice 6789 voip
Step 4 incoming called-number tag Specifies a digit string to be matched by an incoming call to
associate the call with a dial peer.
Example:
Router(config-dial-peer)# incoming called-
number 6789
Step 5 application application-name Enables the Cisco IOS IP SLAs VoIP Responder application
(ipsla-responder) on the dial peer to respond to incoming call
Example: setup messages.
Step 6 session protocol sipv2 (Optional) Specifies SIP as the session protocol for the VoIP
dial peer.
Example: NotePerform this step only if configuring a SIP call.
Router(config-dial-peer)# session protocol sipv2
Example:
Router(config-dial-peer)# exit
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
configure terminal
dial-peer voice 6789 voip
incoming called-number 6789
application ipsla-responder
session protocol sipv2
exit
Additional References
Related Documents
Cisco IOS IP SLAs: general information Cisco IOS IP SLAs Overview chapter of the Cisco
IP SLAs Configuration Guide.
Standards
Standard Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by this feature.
MIBs
RFCs
RFC Title
No new or modified RFCs are supported by this --
feature, and support for existing RFCs has not been
modified by this feature.
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
Response time (round-trip time) is computed by measuring the time taken between sending a UDP echo
request message from Router B to the destination router--Router A--and receiving a UDP echo reply from
Router A. UDP echo accuracy is enhanced by using the IP SLAs Responder at Router A, the destination
Cisco router. If the destination router is a Cisco router, then IP SLAs sends a UDP datagram to any port
number that you specified. Using the IP SLAs Responder is optional for a UDP echo operation when using
Cisco devices. The IP SLAs Responder cannot be configured on non-Cisco devices.
The results of a UDP echo operation can be useful in troubleshooting issues with business-critical
applications by determining the round-trip delay times and testing connectivity to both Cisco and non-
Cisco devices.
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
ip sla responder
ip sla responder udp-echo ipaddress ip-address port port
4. exit
DETAILED STEPS
Example:
Router# configure terminal
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. udp-echo {destination-ip-address | destination-hostname} destination-port [source-ip {ip-address |
hostname} source-port port-number] [control {enable | disable}]
5. frequency seconds
6. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla operation-number Begins configuration for an IP SLAs operation and enters IP
SLA configuration mode.
Example:
Router(config)# ip sla 10
Step 4 udp-echo {destination-ip-address | destination-hostname} Defines a UDP echo operation and enters IP SLA UDP
destination-port [source-ip {ip-address | hostname} configuration mode.
source-port port-number] [control {enable | disable}] Use the control disable keyword combination only if
you disable the IP SLAs control protocol on both the
Example: source and target routers.
Router(config-ip-sla)# udp-echo 172.29.139.134
5000
Step 5 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-udp)# frequency 30
Step 6 exit Exits IP SLA UDP configuration mode and returns to global
configuration mode.
Example:
Router(config-ip-sla-udp)# exit
Configuring a UDP Echo Operation with Optional Parameters on the Source Device
If you are using the IP SLAs Responder, ensure that you have completed the "Configuring the IP SLAs
Responder on the Destination Device" section before you start this task.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. udp-echo {destination-ip-address | destination-hostname} destination-port [source-ip {ip-address |
hostname} source-port port-number] [control {enable | disable}]
5. history buckets-kept size
6. data-pattern hex-pattern
7. history distributions-of-statistics-kept size
8. history enhanced [interval seconds] [buckets number-of-buckets]
9. history filter {none | all | overThreshold | failures}
10. frequency seconds
11. history hours-of-statistics-kept hours
12. history lives-kept lives
13. owner owner-id
14. request-data-size bytes
15. history statistics-distribution-interval milliseconds
16. tag text
17. threshold milliseconds
18. timeout milliseconds
19. Do one of the following:
tos number
traffic-class number
20. flow-label number
21. verify-data
22. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla operation-number Begins configuration for an IP SLAs operation and enters IP
SLA configuration mode.
Example:
Router(config)# ip sla 10
Step 4 udp-echo {destination-ip-address | destination-hostname} Defines a UDP echo operation and enters IP SLA UDP
destination-port [source-ip {ip-address | hostname} configuration mode.
source-port port-number] [control {enable | disable}] Use the control disable keyword combination only if
you disable the IP SLAs control protocol on both the
Example: source and target routers.
Router(config-ip-sla)# udp-echo 172.29.139.134
5000
Step 5 history buckets-kept size (Optional) Sets the number of history buckets that are kept
during the lifetime of an IP SLAs operation.
Example:
Router(config-ip-sla-udp)# history buckets-kept
25
Step 6 data-pattern hex-pattern (Optional) Specifies the data pattern in an IP SLAs operation
to test for data corruption.
Example:
Router(config-ip-sla-udp)# data-pattern
Step 7 history distributions-of-statistics-kept size (Optional) Sets the number of statistics distributions kept per
hop during an IP SLAs operation.
Example:
Router(config-ip-sla-udp)# history distributions-
of-statistics-kept 5
Step 8 history enhanced [interval seconds] [buckets number-of- (Optional) Enables enhanced history gathering for an IP
buckets] SLAs operation.
Example:
Router(config-ip-sla-udp)# history enhanced
interval 900 buckets 100
Step 10 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-udp)# frequency 30
Step 11 history hours-of-statistics-kept hours (Optional) Sets the number of hours for which statistics are
maintained for an IP SLAs operation.
Example:
Router(config-ip-sla-udp)# history hours-of-
statistics-kept 4
Step 12 history lives-kept lives (Optional) Sets the number of lives maintained in the history
table for an IP SLAs operation.
Example:
Router(config-ip-sla-udp)# history lives-kept 5
Step 14 request-data-size bytes (Optional) Sets the protocol data size in the payload of an IP
SLAs operation's request packet.
Example:
Router(config-ip-sla-udp)# request-data-size 64
Step 15 history statistics-distribution-interval milliseconds (Optional) Sets the time interval for each statistics
distribution kept for an IP SLAs operation.
Example:
Router(config-ip-sla-udp)# history statistics-
distribution-interval 10
Step 17 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
operation.
Example:
Router(config-ip-sla-udp)# threshold 10000
Step 18 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-ip-sla-udp)# timeout 10000
Step 19 Do one of the following: (Optional) In an IPv4 network only, defines the ToS byte in
the IPv4 header of an IP SLAs operation.
tos number
or
traffic-class number
(Optional) In an IPv6 network only, defines the traffic class
Example: byte in the IPv6 header for a supported IP SLAs operation.
Example:
Router(config-ip-sla-jitter)# traffic-class 160
Step 20 flow-label number (Optional) In an IPv6 network only, defines the flow label
field in the IPv6 header for a supported IP SLAs operation.
Example:
Router(config-ip-sla-udp)# flow-label 112233
Note
All IP SLAs operations to be scheduled must be already configured.
The frequency of all operations scheduled in a multioperation group must be the same.
List of one or more operation ID numbers to be added to a multioperation group is limited to a
maximum of 125 characters, including commas (,).
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
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]
ip sla group schedule group-operation-number operation-id-numbers schedule-period schedule-
period-range [ageout seconds] [frequency group-operation-frequency] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
4. exit
5. show ip sla group schedule
6. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
ip sla schedule operation-number [life {forever | seconds}] [start-time Configures the scheduling parameters for an
{hh : mm[: ss] [month day | day month] | pending | now | after hh : mm individual IP SLAs operation.
: ss}] [ageout seconds] [recurring] or
ip sla group schedule group-operation-number operation-id-numbers For multioperation scheduler only:
schedule-period schedule-period-range [ageout seconds] [frequency
group-operation-frequency] [life{forever | seconds}] [start- Specifies an IP SLAs operation group
time{hh:mm[:ss] [month day | day month] | pending | now | after number and the range of operation numbers
hh:mm:ss}] to be scheduled in global configuration
mode.
Example:
Router(config)# ip sla schedule 10 start-time now life forever
Example:
Router(config)# ip sla group schedule 1 3,4,6-9
Example:
Router(config)# exit
Step 5 show ip sla group schedule (Optional) Displays the IP SLAs group
schedule details.
Example:
Router# show ip sla group schedule
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
ip sla 5
Additional References
Related Documents
Standards
Standards Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by this feature.
MIBs
RFCs
RFCs Title
RFC 862 Echo Protocol
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
Description Link
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Table 20: Feature Information for the IP SLAs UDP Echo Operation
IPv6 - IP SLAs (UDP Jitter, UDP 12.2(33)SRC 12.2(33)SB Support was added for operability
Echo, ICMP Echo, TCP Connect) 12.4(20)T Cisco IOS XE 3.1.0SG in IPv6 networks.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
HTTP Operation
The HTTP operation measures the round-trip time (RTT) between a Cisco device and an HTTP server to
retrieve a web page. The HTTP server response time measurements consist of three types:
DNS lookup--RTT taken to perform domain name lookup.
TCP Connect--RTT taken to perform a TCP connection to the HTTP server.
HTTP transaction time--RTT taken to send a request and get a response from the HTTP server. The
operation retrieves only the home HTML page.
The DNS operation is performed first and the DNS RTT is measured. Once the domain name is found, a
TCP Connect operation to the appropriate HTTP server is performed and the RTT for this operation is
measured. The final operation is an HTTP request and the RTT to retrieve the home HTML page from the
HTTP server is measured. One other measurement is made and called the time to first byte which measures
the time from the start of the TCP Connect operation to the first HTML byte retrieved by the HTTP
operation. The total HTTP RTT is a sum of the DNS RTT, the TCP Connect RTT, and the HTTP RTT.
For GET requests, IP SLAs will format the request based on the specified URL. For RAW requests, IP
SLAs requires the entire content of the HTTP request. When a RAW request is configured, the raw
commands are specified in HTTP RAW configuration mode. A RAW request is flexible and allows you to
control fields such as authentication. An HTTP request can be made through a proxy server.
The results of an HTTP operation can be useful in monitoring your web server performance levels by
determining the RTT taken to retrieve a web page.
Note This operation does not require an IP SLAs Responder on the destination device.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. http {get | raw} url [name-server ip-address] [version version-number] [source-ip {ip-address |
hostname}] [source-port port-number] [cache {enable | disable}] [proxy proxy-url]
5. frequency seconds
6. end
DETAILED STEPS
Example:
Router# configure terminal
Step 4 http {get | raw} url [name-server ip-address] [version version- Defines an HTTP operation and enters IP SLA
number] [source-ip {ip-address | hostname}] [source-port port- configuration mode.
number] [cache {enable | disable}] [proxy proxy-url]
Example:
Router(config-ip-sla)# http get http://198.133.219.25
Step 5 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
HTTP operation repeats. The default and minimum
Example: frequency value for an IP SLAs HTTP operation is 60
seconds.
Router(config-ip-sla-http)# frequency 90
Example:
Router(config-ip-sla-http)# end
Configuring an HTTP GET Operation with Optional Parameters on the Source Device
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. http {get | raw} url [name-server ip-address] [version version-number] [source-ip {ip-address |
hostname}] [source-port port-number] [cache {enable | disable}] [proxy proxy-url]
5. history buckets-kept size
6. history distributions-of-statistics-kept size
7. history enhanced [interval seconds] [buckets number-of-buckets]
8. history filter {none | all | overThreshold | failures}
9. frequency seconds
10. history hours-of-statistics-kept hours
11. http-raw-request
12. history lives-kept lives
13. owner owner-id
14. history statistics-distribution-interval milliseconds
15. tag text
16. threshold milliseconds
17. timeout milliseconds
18. tos number
19. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla operation-number Begins configuration for an IP SLAs operation and enters
IP SLA configuration mode.
Example:
Router(config)# ip sla 10
Example:
Router(config-ip-sla)# http get http://
198.133.219.25
Step 5 history buckets-kept size (Optional) Sets the number of history buckets that are
kept during the lifetime of an IP SLAs operation.
Example:
Router(config-ip-sla-http)# history buckets-kept 25
Step 6 history distributions-of-statistics-kept size (Optional) Sets the number of statistics distributions kept
per hop during an IP SLAs operation.
Example:
Router(config-ip-sla-http)# history distributions-
of-statistics-kept 5
Step 7 history enhanced [interval seconds] [buckets number-of- (Optional) Enables enhanced history gathering for an IP
buckets] SLAs operation.
Example:
Router(config-ip-sla-http)# history enhanced
interval 900 buckets 100
Step 8 history filter {none | all | overThreshold | failures} (Optional) Defines the type of information kept in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-http)# history filter failures
Step 9 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
HTTP operation repeats. The default and minimum
Example: frequency value for an IP SLAs HTTP operation is 60
seconds.
Router(config-ip-sla-http)# frequency 90
Step 10 history hours-of-statistics-kept hours (Optional) Sets the number of hours for which statistics
are maintained for an IP SLAs operation.
Example:
Router(config-ip-sla-http)# history hours-of-
statistics-kept 4
Example:
Router(config-ip-sla-http)# http-raw-request
Step 12 history lives-kept lives (Optional) Sets the number of lives maintained in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-http)# history lives-kept 5
Step 14 history statistics-distribution-interval milliseconds (Optional) Sets the time interval for each statistics
distribution kept for an IP SLAs operation.
Example:
Router(config-ip-sla-http)# history statistics-
distribution-interval 10
Step 16 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
Example: operation.
Step 17 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-ip-sla-http)# timeout 10000
Step 18 tos number (Optional) Defines a type of service (ToS) byte in the IP
header of an IP SLAs operation.
Example:
Router(config-ip-sla-http)# tos 160
Example:
Router(config-ip-sla-http)# end
Note This operation does not require an IP SLAs Responder on the destination device.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. http {get | raw} url [name-server ip-address] [version version-number] [source-ip {ip-address |
hostname}] [source-port port-number] [cache {enable | disable}] [proxy proxy-url]
5. http-raw-request
6. Enter the required HTTP 1.0 command syntax.
7. end
DETAILED STEPS
Example:
Router# configure terminal
Router(config)# ip sla 10
Step 4 http {get | raw} url [name-server ip-address] [version version-number] Defines an HTTP operation.
[source-ip {ip-address | hostname}] [source-port port-number] [cache
{enable | disable}] [proxy proxy-url]
Example:
Router(config-ip-sla)# http raw http://198.133.219.25
Example:
Router(config-ip-sla)# http-raw-request
Example:
Router(config-ip-sla-http)# end
Note
All IP SLAs operations to be scheduled must be already configured.
The frequency of all operations scheduled in a multioperation group must be the same.
List of one or more operation ID numbers to be added to a multioperation group is limited to a
maximum of 125 characters, including commas (,).
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
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]
ip sla group schedule group-operation-number operation-id-numbers schedule-period schedule-
period-range [ageout seconds] [frequency group-operation-frequency] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
4. exit
5. show ip sla group schedule
6. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
ip sla schedule operation-number [life {forever | seconds}] [start-time Configures the scheduling parameters for an
{hh : mm[: ss] [month day | day month] | pending | now | after hh : mm individual IP SLAs operation.
: ss}] [ageout seconds] [recurring] or
ip sla group schedule group-operation-number operation-id-numbers For multioperation scheduler only:
schedule-period schedule-period-range [ageout seconds] [frequency
group-operation-frequency] [life{forever | seconds}] [start- Specifies an IP SLAs operation group
time{hh:mm[:ss] [month day | day month] | pending | now | after number and the range of operation numbers
hh:mm:ss}] to be scheduled in global configuration
mode.
Example:
Router(config)# ip sla schedule 10 start-time now life forever
Example:
Router(config)# ip sla group schedule 1 3,4,6-9
Example:
Router(config)# exit
Step 5 show ip sla group schedule (Optional) Displays the IP SLAs group
schedule details.
Example:
Router# show ip sla group schedule
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
Router B Configuration
ip sla 8
http get url http://198.133.219.25
!
ip sla schedule 8 start-time now
ip sla 8
http raw url http://198.133.219.25
http-raw-request
GET /en/US/hmpgs/index.html HTTP/1.0\r\n
\r\n
end
ip sla schedule 8 life forever start-time now
ip sla 8
http raw url http://www.proxy.cisco.com
http-raw-request
GET http://www.yahoo.com HTTP/1.0\r\n
\r\n
end
ip sla schedule 8 life forever start-time now
ip sla 8
http raw url http://site-test.cisco.com
http-raw-request
GET /lab/index.html HTTP/1.0\r\n
Authorization: Basic btNpdGT4biNvoZe=\r\n
\r\n
end
ip sla schedule 8 life forever start-time now
Additional References
Related Documents
Cisco IOS IP SLAs: general information Cisco IOS IP SLAs Overview chapter of the Cisco
IOS IP SLAs Configuration Guide.
Standards
Standards Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by this feature.
MIBs
RFCs
RFCs Title
No new or modified RFCs are supported by this --
feature, and support for existing RFCs has not been
modified by this feature.
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
that provides reliable full-duplex data transmission. The destination device can be any device using IP or an
IP SLAs Responder.
In the figure below Router B is configured as the source IP SLAs device and a TCP Connect operation is
configured with the destination device as IP Host 1.
Connection response time is computed by measuring the time taken between sending a TCP request
message from Router B to IP Host 1 and receiving a reply from IP Host 1.
TCP Connect accuracy is enhanced by using the IP SLAs Responder at the destination Cisco device. If the
destination router is a Cisco router, then IP SLAs makes a TCP connection to any port number that you
specified. If the destination is not a Cisco IP host, then you must specify a known destination port number
such as 21 for FTP, 23 for Telnet, or 80 for an HTTP server.
Using the IP SLAs Responder is optional for a TCP Connect operation when using Cisco devices. The IP
SLAs Responder cannot be configured on non-Cisco devices.
TCP Connect is used to test virtual circuit availability or application availability. Server and application
connection performance can be tested by simulating Telnet, SQL, and other types of connection to help you
verify your IP service levels.
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
ip sla responder
ip sla responder tcp-connect ipaddress ip-address port port
4. exit
DETAILED STEPS
Example:
Router# configure terminal
Configuring and Scheduling a TCP Connect Operation with Optional Parameters on the Source
Device, page 176
Prerequisites
If you are using the IP SLAs Responder, complete the "Configuring the IP SLAs Responder on the
Destination Device" section before you start this task.
Configuring and Scheduling a Basic TCP Connect Operation on the Source Device
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. tcp-connect {destination-ip-address | destination-hostname} destination-port [source-ip {ip-address |
hostname} source-port port-number] [control {enable | disable}]
5. frequency seconds
6. exit
7. 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]
8. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla operation-number Begins configuration for an IP SLAs operation and enters
IP SLA configuration mode.
Example:
Router(config)# ip sla 10
Step 4 tcp-connect {destination-ip-address | destination-hostname} Defines a TCP Connect operation and enters IP SLA
destination-port [source-ip {ip-address | hostname} source- TCP configuration mode.
port port-number] [control {enable | disable}] Use the control disable keyword combination only
if you disable the IP SLAs control protocol on both
the source and target routers.
Example:
Router(config-ip-sla)# tcp-connect 172.29.139.132 5000
Step 5 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-tcp)# frequency 30
Step 7 ip sla schedule operation-number [life {forever| seconds}] Configures the scheduling parameters for an individual
[start-time {hh:mm[:ss] [month day | day month] | pending | IP SLAs operation.
now | after hh:mm:ss] [ageout seconds] [recurring]
Example:
Router(config)# ip sla schedule 10 start-time now
life forever
Example
The following example shows the configuration of an IP SLAs operation type of TCP Connect that will
start immediately and run indefinitely.
ip sla 9
tcp-connect 172.29.139.132 5000
frequency 10
!
ip sla schedule 9 life forever start-time now
Troubleshooting Tips, page 16
What to Do Next, page 16
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
Configuring and Scheduling a TCP Connect Operation with Optional Parameters on the
Source Device
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. tcp-connect {destination-ip-address | destination-hostname} destination-port [source-ip {ip-address |
hostname} source-port port-number] [control {enable | disable}]
5. history buckets-kept size
6. history distributions-of-statistics-kept size
7. history enhanced [interval seconds] [buckets number-of-buckets]
8. history filter {none | all | overThreshold | failures}
9. frequency seconds
10. history hours-of-statistics-kept hours
11. history lives-kept lives
12. owner owner-id
13. history statistics-distribution-interval milliseconds
14. tag text
15. threshold milliseconds
16. timeout milliseconds
17. Do one of the following:
tos number
traffic-class number
18. flow-label number
19. exit
20. 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]
21. exit
22. show ip sla configuration [operation-number]
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla operation-number Begins configuration for an IP SLAs operation and enters
IP SLA configuration mode.
Example:
Router(config)# ip sla 10
Step 4 tcp-connect {destination-ip-address | destination-hostname} Defines a TCP Connect operation and enters IP SLA TCP
destination-port [source-ip {ip-address | hostname} source- configuration mode.
port port-number] [control {enable | disable}] Use the control disable keyword combination only if
you disable the IP SLAs control protocol on both the
Example: source and target routers.
Router(config-ip-sla)# tcp-connect 172.29.139.132
5000
Step 5 history buckets-kept size (Optional) Sets the number of history buckets that are kept
during the lifetime of an IP SLAs operation.
Example:
Router(config-ip-sla-tcp)# history buckets-kept 25
Step 6 history distributions-of-statistics-kept size (Optional) Sets the number of statistics distributions kept
per hop during an IP SLAs operation.
Example:
Router(config-ip-sla-tcp)# history distributions-
of-statistics-kept 5
Step 7 history enhanced [interval seconds] [buckets number-of- (Optional) Enables enhanced history gathering for an IP
buckets] SLAs operation.
Example:
Router(config-ip-sla-tcp)# history enhanced
interval 900 buckets 100
Step 8 history filter {none | all | overThreshold | failures} (Optional) Defines the type of information kept in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-tcp)# history filter failures
Step 9 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-tcp)# frequency 30
Step 10 history hours-of-statistics-kept hours (Optional) Sets the number of hours for which statistics are
maintained for an IP SLAs operation.
Example:
Router(config-ip-sla-tcp)# history hours-of-
statistics-kept 4
Step 11 history lives-kept lives (Optional) Sets the number of lives maintained in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-tcp)# history lives-kept 5
Step 13 history statistics-distribution-interval milliseconds (Optional) Sets the time interval for each statistics
distribution kept for an IP SLAs operation.
Example:
Router(config-ip-sla-tcp)# history statistics-
distribution-interval 10
Step 15 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
Example: operation.
Step 16 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-ip-sla-tcp)# timeout 10000
Example:
Router(config-ip-sla-jitter)# traffic-class 160
Step 18 flow-label number (Optional) In an IPv6 network only, defines the flow label
field in the IPv6 header for a supported IP SLAs operation.
Example:
Router(config-ip-sla-tcp)# flow-label 112233
Step 20 ip sla schedule operation-number [life {forever| seconds}] Configures the scheduling parameters for an individual IP
[start-time {hh:mm[:ss] [month day | day month] | pending | SLAs operation.
now | after hh:mm:ss] [ageout seconds] [recurring]
Example:
Router(config)# ip sla schedule 10 start-time now
life forever
Step 22 show ip sla configuration [operation-number] (Optional) Displays configuration values including all
defaults for all IP SLAs operations or a specified operation.
Example:
Router# show ip sla configuration 10
Example
The following sample output shows the configuration of all the IP SLAs parameters (including defaults) for
the TCP Connect operation number 9.
Tag: SL-SGU
Type of Operation to Perform: tcpConnect
Reaction and History Threshold (milliseconds): 5000
Operation Frequency (seconds): 20
Operation Timeout (milliseconds): 60000
Verify Data: FALSE
Status of Entry (SNMP RowStatus): active
Protocol Type: ipTcpConn
Target Address: 172.29.139.132
Source Address: 0.0.0.0
Target Port: 5000
Source Port: 0
Request Size (ARR data portion): 1
Response Size (ARR data portion): 1
Control Packets: enabled
Loose Source Routing: disabled
LSR Path:
Type of Service Parameters: 128
Life (seconds): infinite - runs forever
Next Scheduled Start Time: Start Time already passed
Entry Ageout (seconds): never
Connection Loss Reaction Enabled: FALSE
Timeout Reaction Enabled: FALSE
Threshold Reaction Type: never
Threshold Falling (milliseconds): 3000
Threshold Count: 5
Threshold Count2: 5
Reaction Type: none
Verify Error Reaction Enabled: FALSE
Number of Statistic Hours kept: 2
Number of Statistic Paths kept: 1
Number of Statistic Hops kept: 1
Number of Statistic Distribution Buckets kept: 1
Statistic Distribution Interval (milliseconds): 20
Number of History Lives kept: 0
Number of History Buckets kept: 15
Number of History Samples kept: 1
History Filter Type: none
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
Router A Configuration
configure terminal
ip sla responder tcp-connect ipaddress 10.0.0.1 port 23
Router B Configuration
ip sla 9
tcp-connect 10.0.0.1 23 control disable
frequency 30
tos 128
timeout 1000
tag FLL-RO
ip sla schedule 9 start-time now
The following example shows how to configure a TCP Connect operation with a specific port, port 23, and
without an IP SLAs Responder. The operation is scheduled to start immediately and run indefinitely.
ip sla 9
tcp-connect 173.29.139.132 21 control disable
frequency 30
ip sla schedule 9 life forever start-time now
Additional References
Related Documents
Standards
Standards Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by this feature.
MIBs
RFCs
RFCs Title
No new or modified RFCs are supported by this --
feature, and support for existing RFCs has not been
modified by this feature.
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Table 22: Feature Information for the IP SLAs TCP Connect Operation
IPv6 - IP SLAs (UDP Jitter, UDP 12.2(33)SRC 12.2(33)SB Support was added for operability
Echo, ICMP Echo, TCP Connect) 12.4(20)T Cisco IOS XE 3.1.0SG in IPv6 networks.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
The IP SLAs ICMP Echo operation conforms to the same IETF specifications for ICMP ping testing and
the two methods result in the same response times.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. icmp-echo {destination-ip-address | destination-hostname} [source-ip {ip-address | hostname} |
source-interface interface-name]
5. frequency seconds
6. end
DETAILED STEPS
Example:
Router# configure terminal
Step 4 icmp-echo {destination-ip-address | destination-hostname} Defines an ICMP Echo operation and enters IP SLA
[source-ip {ip-address | hostname} | source-interface interface- ICMP Echo configuration mode.
name]
Example:
Router(config-ip-sla)# icmp-echo 172.29.139.134
Step 5 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-echo)# frequency 300
Example:
Router(config-ip-sla-echo)# end
Configuring an ICMP Echo Operation with Optional Parameters on the Source Device
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. icmp-echo {destination-ip-address | destination-hostname} [source-ip {ip-address | hostname} |
source-interface interface-name]
5. history buckets-kept size
6. history distributions-of-statistics-kept size
7. history enhanced [interval seconds] [buckets number-of-buckets]
8. history filter {none | all | overThreshold | failures}
9. frequency seconds
10. history hours-of-statistics-kept hours
11. history lives-kept lives
12. owner owner-id
13. request-data-size bytes
14. history statistics-distribution-interval milliseconds
15. tag text
16. threshold milliseconds
17. timeout milliseconds
18. Do one of the following:
tos number
traffic-class number
19. flow-label number
20. verify-data
21. vrf vrf-name
22. end
DETAILED STEPS
Example:
Router# configure terminal
Step 4 icmp-echo {destination-ip-address | destination-hostname} Defines an Echo operation and enters IP SLA Echo
[source-ip {ip-address | hostname} | source-interface configuration mode.
interface-name]
Example:
Router(config-ip-sla)# icmp-echo 172.29.139.134
source-ip 172.29.139.132
Step 5 history buckets-kept size (Optional) Sets the number of history buckets that are kept
during the lifetime of an IP SLAs operation.
Example:
Router(config-ip-sla-echo)# history buckets-kept 25
Step 6 history distributions-of-statistics-kept size (Optional) Sets the number of statistics distributions kept
per hop during an IP SLAs operation.
Example:
Router(config-ip-sla-echo)# history distributions-
of-statistics-kept 5
Step 7 history enhanced [interval seconds] [buckets number-of- (Optional) Enables enhanced history gathering for an IP
buckets] SLAs operation.
Example:
Router(config-ip-sla-echo)# history enhanced
interval 900 buckets 100
Step 8 history filter {none | all | overThreshold | failures} (Optional) Defines the type of information kept in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-echo)# history filter failures
Step 9 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-echo)# frequency 30
Step 10 history hours-of-statistics-kept hours (Optional) Sets the number of hours for which statistics are
maintained for an IP SLAs operation.
Example:
Router(config-ip-sla-echo)# history hours-of-
statistics-kept 4
Step 13 request-data-size bytes (Optional) Sets the protocol data size in the payload of an
IP SLAs operation's request packet.
Example:
Router(config-ip-sla-echo)# request-data-size 64
Step 14 history statistics-distribution-interval milliseconds (Optional) Sets the time interval for each statistics
distribution kept for an IP SLAs operation.
Example:
Router(config-ip-sla-echo)# history statistics-
distribution-interval 10
Step 16 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
Example: operation.
Step 17 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-ip-sla-echo)# timeout 10000
Step 18 Do one of the following: (Optional) In an IPv4 network only, defines the ToS byte
in the IPv4 header of an IP SLAs operation.
tos number
or
traffic-class number
(Optional) In an IPv6 network only, defines the traffic
Example: class byte in the IPv6 header for a supported IP SLAs
operation.
Router(config-ip-sla-jitter)# tos 160
Example:
Router(config-ip-sla-jitter)# traffic-class 160
Step 19 flow-label number (Optional) In an IPv6 network only, defines the flow label
field in the IPv6 header for a supported IP SLAs operation.
Example:
Router(config-ip-sla-echo)# flow-label 112233
Example:
Router(config-ip-sla-echo)# end
Note
All IP SLAs operations to be scheduled must be already configured.
The frequency of all operations scheduled in a multioperation group must be the same.
List of one or more operation ID numbers to be added to a multioperation group is limited to a
maximum of 125 characters, including commas (,).
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
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]
ip sla group schedule group-operation-number operation-id-numbers schedule-period schedule-
period-range [ageout seconds] [frequency group-operation-frequency] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
4. exit
5. show ip sla group schedule
6. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
ip sla schedule operation-number [life {forever | seconds}] [start-time Configures the scheduling parameters for an
{hh : mm[: ss] [month day | day month] | pending | now | after hh : mm individual IP SLAs operation.
: ss}] [ageout seconds] [recurring] or
ip sla group schedule group-operation-number operation-id-numbers For multioperation scheduler only:
schedule-period schedule-period-range [ageout seconds] [frequency
group-operation-frequency] [life{forever | seconds}] [start- Specifies an IP SLAs operation group
time{hh:mm[:ss] [month day | day month] | pending | now | after number and the range of operation numbers
hh:mm:ss}] to be scheduled in global configuration
mode.
Example:
Router(config)# ip sla schedule 10 start-time now life forever
Example:
Router(config)# ip sla group schedule 1 3,4,6-9
Example:
Router(config)# exit
Step 5 show ip sla group schedule (Optional) Displays the IP SLAs group
schedule details.
Example:
Router# show ip sla group schedule
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
ip sla 6
Additional References
Related Documents
Cisco IOS IP SLAs: general information Cisco IOS IP SLAs Overview chapter of the
Cisco IOS IP SLAs Configuration Guide
Standards
Standards Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by this feature.
MIBs
RFCs
RFCs Title
RFC 862 Echo Protocol
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
Description Link
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
IPv6 - IP SLAs (UDP Jitter, UDP 12.2(33)SB 12.2(33)SRC Support was added for operability
Echo, ICMP Echo, TCP Connect) 12.4(20)T Cisco IOS XE 3.1.0SG in IPv6 networks.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
Using the statistics recorded for the response times and availability, the ICMP Path Echo operation can
identify a hop in the path that is causing a bottleneck.
Note This operation does not require an IP SLAs Responder on the destination device.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-id
4. path-echo {destination-ip-address | destination-hostname} [source-ip {ip-address | hostname}]
5. frequency seconds
6. end
DETAILED STEPS
Example:
Router# configure terminal
Step 4 path-echo {destination-ip-address | destination-hostname} Defines a Path Echo operation and enters IP SLA Path
[source-ip {ip-address | hostname}] Echo configuration mode.
Example:
Router(config-ip-sla)# path-echo protocol
172.29.139.134
Step 5 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-pathEcho)# frequency 30
Example:
Router(config-ip-sla-pathEcho)# end
Example
The following example shows the configuration of the IP SLAs ICMP Path Echo operation number 7 that
will start in 30 seconds and run for 5 minutes.
ip sla 7
path-echo 172.29.139.134
frequency 30
!
ip sla schedule 7 start-time after 00:00:30 life 300
Configuring an ICMP Path Echo Operation with Optional Parameters on the Source Device
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. path-echo {destination-ip-address | destination-hostname} [source-ip {ip-address | hostname}]
5. history buckets-kept size
6. history distributions-of-statistics-kept size
7. history enhanced [interval seconds] [buckets number-of-buckets]
8. history filter {none | all | overThreshold | failures}
9. frequency seconds
10. history hours-of-statistics-kept hours
11. history lives-kept lives
12. owner owner-id
13. paths-of-statistics-kept size
14. request-data-size bytes
15. samples-of-history-kept samples
16. history statistics-distribution-interval milliseconds
17. tag text
18. threshold milliseconds
19. timeout milliseconds
20. tos number
21. verify-data
22. vrf vrf-name
23. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla operation-number Begins configuration for an IP SLAs operation and enters
IP SLA configuration mode.
Example:
Router(config)# ip sla 10
Example:
Router(config-ip-sla)# path-echo 172.29.139.134
Step 5 history buckets-kept size (Optional) Sets the number of history buckets that are kept
during the lifetime of an IP SLAs operation.
Example:
Router(config-ip-sla-pathEcho)# history buckets-
kept 25
Step 6 history distributions-of-statistics-kept size (Optional) Sets the number of statistics distributions kept
per hop during an IP SLAs operation.
Example:
Router(config-ip-sla-pathEcho)# history
distributions-of-statistics-kept 5
Step 7 history enhanced [interval seconds] [buckets number-of- (Optional) Enables enhanced history gathering for an IP
buckets] SLAs operation.
Example:
Router(config-ip-sla-pathEcho)# history enhanced
interval 900 buckets 100
Step 8 history filter {none | all | overThreshold | failures} (Optional) Defines the type of information kept in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-pathEcho)# history filter
failures
Step 9 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-pathEcho)# frequency 30
Step 10 history hours-of-statistics-kept hours (Optional) Sets the number of hours for which statistics are
maintained for an IP SLAs operation.
Example:
Router(config-ip-sla-pathEcho)# history hours-of-
statistics-kept 4
Step 11 history lives-kept lives (Optional) Sets the number of lives maintained in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-pathEcho)# history lives-kept
5
Step 13 paths-of-statistics-kept size (Optional) Sets the number of paths for which statistics are
maintained per hour for an IP SLAs operation.
Example:
Router(config-ip-sla-pathEcho)# paths-of-
statistics-kept 3
Step 14 request-data-size bytes (Optional) Sets the protocol data size in the payload of an
IP SLAs operation's request packet.
Example:
Router(config-ip-sla-pathEcho)# request-data-size
64
Step 15 samples-of-history-kept samples (Optional) Sets the number of entries kept in the history
table per bucket for an IP SLAs operation.
Example:
Router(config-ip-sla-pathEcho)# samples-of-history-
kept 10
Step 16 history statistics-distribution-interval milliseconds (Optional) Sets the time interval for each statistics
distribution kept for an IP SLAs operation.
Example:
Router(config-ip-sla-pathEcho)# history statistics-
distribution-interval 10
Step 18 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
Example: operation.
Step 19 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-ip-sla-pathEcho)# timeout 10000
Step 20 tos number (Optional) Defines a type of service (ToS) byte in the IP
header of an IP SLAs operation.
Example:
Router(config-ip-sla-pathEcho)# tos 160
Example:
Router(config-ip-sla-pathEcho)# end
Note
All IP SLAs operations to be scheduled must be already configured.
The frequency of all operations scheduled in a multioperation group must be the same.
List of one or more operation ID numbers to be added to a multioperation group is limited to a
maximum of 125 characters, including commas (,).
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
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]
ip sla group schedule group-operation-number operation-id-numbers schedule-period schedule-
period-range [ageout seconds] [frequency group-operation-frequency] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
4. exit
5. show ip sla group schedule
6. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
ip sla schedule operation-number [life {forever | seconds}] [start-time Configures the scheduling parameters for an
{hh : mm[: ss] [month day | day month] | pending | now | after hh : mm individual IP SLAs operation.
: ss}] [ageout seconds] [recurring] or
ip sla group schedule group-operation-number operation-id-numbers For multioperation scheduler only:
schedule-period schedule-period-range [ageout seconds] [frequency
group-operation-frequency] [life{forever | seconds}] [start- Specifies an IP SLAs operation group
time{hh:mm[:ss] [month day | day month] | pending | now | after number and the range of operation numbers
hh:mm:ss}] to be scheduled in global configuration
mode.
Example:
Router(config)# ip sla schedule 10 start-time now life forever
Example:
Router(config)# ip sla group schedule 1 3,4,6-9
Example:
Router(config)# exit
Step 5 show ip sla group schedule (Optional) Displays the IP SLAs group
schedule details.
Example:
Router# show ip sla group schedule
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
This example sets a Path Echo operation (ip sla 3) from Router B to Router A using IP/ICMP. The
operation attempts to execute three times in 25 seconds (first attempt at 0 seconds).
Router B Configuration
ip sla 3
path-echo 172.29.139.134
frequency 10
tag SGN-RO
timeout 1000
ip sla schedule 3 life 25
Additional References
Related Documents
Cisco IOS IP SLAs: general information Cisco IOS IP SLAs Overview chapter of the Cisco
IOS IP SLAs Configuration Guide
Standards
Standards Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by this feature.
MIBs
RFCs
RFCs Title
RFC 862 Echo Protocol
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Table 24: Feature Information for IP SLAs ICMP Path Echo Operations
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
The operation first discovers the hop-by-hop IP route from the source to the destination using a traceroute
utility, and then uses ICMP echoes to determine the response times, packet loss and approximate jitter
values for each hop along the path. The jitter values obtained using the ICMP Path Jitter operation are
approximates because ICMP only provides round trip times.
The ICMP Path Jitter operation functions by tracing the IP path from a source device to a specified
destination device, then sending N number of Echo probes to each hop along the traced path, with a time
interval of T milliseconds between each Echo probe. The operation as a whole is repeated at a frequency of
once every F seconds. The attributes are user-configurable, as shown here:
Note An IP SLAs Responder is not required on either the target device or intermediate devices for Path Jitter
operations. However, operational efficiency may improve if you enable the IP SLAs Responder.
The networking device to be used as the responder must be a Cisco device and you must have connectivity
to that device through the network.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla responder
4. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla responder (Optional) Temporarily enables IP SLAs Responder functionality on a Cisco device
in response to control messages from source.
Example: Control is enabled by default.
Example:
Router(config)# ip sla responder
Step 4 exit (Optional) Exits global configuration mode and returns to privileged EXEC mode.
Example:
Router(config)# exit
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. path-jitter {destination-ip-address | destination-hostname} [source-ip {ip-address | hostname}] [num-
packets packet-number] [interval milliseconds] [targetOnly]
5. frequency seconds
6. end
DETAILED STEPS
Example:
Router# configure terminal
Step 4 path-jitter {destination-ip-address | destination-hostname} [source- Defines an ICMP Path Jitter operation and enters IP
ip {ip-address | hostname}] [num-packets packet-number] [interval SLA Path Jitter configuration mode.
milliseconds] [targetOnly]
Example:
Router(config-ip-sla)# path-jitter 172.31.1.129 source-ip
10.2.30.1 num-packets 12 interval 22
Example:
Router(config-ip-sla-pathJitter)# end
Example
In the following example, the targetOnly keyword is used to bypass the hop-by-hop measurements. With
this version of the command, echo probes will be sent to the destination only.
Router(config)# ip sla 1
Router(config-ip-sla)# path-jitter 172.17.246.20 num-packets 50 interval 30 targetOnly
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. path-jitter {destination-ip-address | destination-hostname} [source-ip {ip-address | hostname}] [num-
packets packet-number] [interval milliseconds] [targetOnly]
5. frequency seconds
6. owner owner-id
7. request-data-size bytes
8. tag text
9. timeout milliseconds
10. vrf vrf-name
11. end
DETAILED STEPS
Example:
Router# configure terminal
Step 4 path-jitter {destination-ip-address | destination-hostname} Defines an ICMP Path Jitter operation and enters IP
[source-ip {ip-address | hostname}] [num-packets packet- SLA Path Jitter configuration mode.
number] [interval milliseconds] [targetOnly]
Example:
Router(config-ip-sla)# path-jitter 172.31.1.129
source-ip 10.2.30.1 num-packets 12 interval 22
Step 5 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-pathJitter)# frequency 30
Step 7 request-data-size bytes (Optional) Sets the protocol data size in the payload of
an IP SLAs operation's request packet.
Example:
Router(config-ip-sla-pathJitter)# request-data-size
64
Step 9 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-ip-sla-pathJitter)# timeout 10000
Example:
Router(config-ip-sla-pathJitter)# end
Note
All IP SLAs operations to be scheduled must be already configured.
The frequency of all operations scheduled in a multioperation group must be the same.
List of one or more operation ID numbers to be added to a multioperation group is limited to a
maximum of 125 characters, including commas (,).
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
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]
ip sla group schedule group-operation-number operation-id-numbers schedule-period schedule-
period-range [ageout seconds] [frequency group-operation-frequency] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
4. exit
5. show ip sla group schedule
6. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
ip sla schedule operation-number [life {forever | seconds}] [start-time Configures the scheduling parameters for an
{hh : mm[: ss] [month day | day month] | pending | now | after hh : mm individual IP SLAs operation.
: ss}] [ageout seconds] [recurring] or
ip sla group schedule group-operation-number operation-id-numbers For multioperation scheduler only:
schedule-period schedule-period-range [ageout seconds] [frequency
group-operation-frequency] [life{forever | seconds}] [start- Specifies an IP SLAs operation group
time{hh:mm[:ss] [month day | day month] | pending | now | after number and the range of operation numbers
hh:mm:ss}] to be scheduled in global configuration
mode.
Example:
Router(config)# ip sla schedule 10 start-time now life forever
Example:
Router(config)# ip sla group schedule 1 3,4,6-9
Example:
Router(config)# exit
Step 5 show ip sla group schedule (Optional) Displays the IP SLAs group
schedule details.
Example:
Router# show ip sla group schedule
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
The following example shows the output when the ICMP Path Jitter operation is configured. Because the
path jitter operation does not support hourly statistics and hop information, the output for the show ip sla
statistics command for the path jitter operation displays only the statistics for the first hop.
The following example shows the output when the ICMP Path Jitter operation is configured.
Additional References
Related Documents
Cisco IOS IP SLAs: general information Cisco IOS IP SLAs Overview chapter of the Cisco
IOS IP SLAs Configuration Guide.
Standards
Standards Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by features in this document.
MIBs
RFCs
RFCs Title
RFC 18894 RTP: A Transport Protocol for Real-Time
Applications ; see the section Estimating the
Interarrival Jitter
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
4 Support for the listed RFC is not claimed; listed as a reference only.
Table 25: Feature Information for IP SLAs ICMP Path Jitter Operations
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
FTP Operation
The FTP operation measures the round-trip time (RTT) between a Cisco device and an FTP server to
retrieve a file. FTP is an application protocol, part of the Transmission Control Protocol (TCP)/IP protocol
stack, used for transferring files between network nodes.
In the figure below Router B is configured as the source IP SLAs device and an FTP operation is
configured with the FTP server as the destination device.
Connection response time is computed by measuring the time taken to download a file to Router B from the
remote FTP server using FTP over TCP. This operation does not use the IP SLAs Responder.
Note To test the response time to connect to an FTP port (Port 21), use the IP SLAs TCP Connect operation.
Both active and passive FTP transfer modes are supported. The passive mode is enabled by default. Only
the FTP GET (download) operation type is supported. The URL specified for the FTP GET operation must
be in one of the following formats:
ftp://username:password@host/filename
ftp://host/filename
If the username and password are not specified, the defaults are anonymous and test, respectively.
FTP carries a significant amount of data traffic and can affect the performance of your network. The results
of an IP SLAs FTP operation to retrieve a large file can be used to determine the capacity of the network
but retrieve large files with caution because the FTP operation will consume more bandwidth. The FTP
operation also measures your FTP server performance levels by determining the RTT taken to retrieve a
file.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. ftp get url [source-ip {ip-address | hostname}] [mode {passive | active}
5. frequency seconds
6. end
DETAILED STEPS
Example:
Router# configure terminal
Step 4 ftp get url [source-ip {ip-address | hostname}] [mode {passive | Defines an FTP operation and enters IP SLA FTP
active} configuration mode.
Example:
Router(config-ip-sla)# ftp get ftp://
username:password@hostip/test.cap
Example:
Router(config-ip-sla-ftp)# exit
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. ftp get url [source-ip {ip-address | hostname}] [mode {passive | active}
5. history buckets-kept size
6. history distributions-of-statistics-kept size
7. history enhanced [interval seconds] [buckets number-of-buckets]
8. history filter {none | all | overThreshold | failures}
9. frequency seconds
10. history hours-of-statistics-kept hours
11. history lives-kept lives
12. owner owner-id
13. history statistics-distribution-interval milliseconds
14. tag text
15. threshold milliseconds
16. timeout milliseconds
17. end
DETAILED STEPS
Example:
Router# configure terminal
Step 4 ftp get url [source-ip {ip-address | hostname}] [mode {passive | Defines an FTP operation and enters IP SLA FTP
active} configuration mode.
Example:
Router(config-ip-sla)# ftp get ftp://
username:password@hostip/filename
Step 5 history buckets-kept size (Optional) Sets the number of history buckets that
are kept during the lifetime of an IP SLAs operation.
Example:
Router(config-ip-sla-ftp)# history buckets-kept 25
Step 6 history distributions-of-statistics-kept size (Optional) Sets the number of statistics distributions
kept per hop during an IP SLAs operation.
Example:
Router(config-ip-sla-ftp)# history distributions-of-
statistics-kept 5
Step 7 history enhanced [interval seconds] [buckets number-of-buckets] (Optional) Enables enhanced history gathering for an
IP SLAs operation.
Example:
Router(config-ip-sla-ftp)# history enhanced interval
900 buckets 100
Step 8 history filter {none | all | overThreshold | failures} (Optional) Defines the type of information kept in
the history table for an IP SLAs operation.
Example:
Router(config-ip-sla-ftp)# history filter failures
Step 9 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-ftp)# frequency 30
Step 10 history hours-of-statistics-kept hours (Optional) Sets the number of hours for which
statistics are maintained for an IP SLAs operation.
Example:
Router(config-ip-sla-ftp)# history hours-of-statistics-
kept 4
Step 11 history lives-kept lives (Optional) Sets the number of lives maintained in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-ftp)# history lives-kept 5
Step 13 history statistics-distribution-interval milliseconds (Optional) Sets the time interval for each statistics
distribution kept for an IP SLAs operation.
Example:
Router(config-ip-sla-ftp)# history statistics-
distribution-interval 10
Step 15 threshold milliseconds (Optional) Sets the upper threshold value for
calculating network monitoring statistics created by
Example: an IP SLAs operation.
Example:
Router(config-ip-sla-ftp)# end
Note
All IP SLAs operations to be scheduled must be already configured.
The frequency of all operations scheduled in a multioperation group must be the same.
List of one or more operation ID numbers to be added to a multioperation group is limited to a
maximum of 125 characters, including commas (,).
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
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]
ip sla group schedule group-operation-number operation-id-numbers schedule-period schedule-
period-range [ageout seconds] [frequency group-operation-frequency] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
4. exit
5. show ip sla group schedule
6. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
ip sla schedule operation-number [life {forever | seconds}] [start-time Configures the scheduling parameters for an
{hh : mm[: ss] [month day | day month] | pending | now | after hh : mm individual IP SLAs operation.
: ss}] [ageout seconds] [recurring] or
ip sla group schedule group-operation-number operation-id-numbers For multioperation scheduler only:
schedule-period schedule-period-range [ageout seconds] [frequency
group-operation-frequency] [life{forever | seconds}] [start- Specifies an IP SLAs operation group
number and the range of operation numbers
Example:
Router(config)# ip sla schedule 10 start-time now life forever
Example:
Router(config)# ip sla group schedule 1 3,4,6-9
Example:
Router(config)# exit
Step 5 show ip sla group schedule (Optional) Displays the IP SLAs group
schedule details.
Example:
Router# show ip sla group schedule
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
Router B Configuration
ip sla 10
ftp get ftp://user1:abc@test.cisco.com/test.cap mode active
frequency 20
tos 128
timeout 40000
tag FLL-FTP
ip sla schedule 10 start-time 01:30:00 recurring
Additional References
Related Documents
Cisco IOS IP SLAs: general information Cisco IOS IP SLAs Overview chapter of the Cisco
IOS IP SLAs Configuration Guide.
Standards
Standards Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by this feature.
MIBs
RFCs
RFCs Title
No new or modified RFCs are supported by this --
feature, and support for existing RFCs has not been
modified by this feature.
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
DNS Operation
The DNS operation measures the difference between the time taken to send a DNS request and receive a
reply. DNS is used in the Internet for translating names of network nodes into addresses. The IP SLAs DNS
operation queries for an IP address if you specify a host name, or queries for a host name if you specify an
IP address.
In the figure below Router B is configured as the source IP SLAs device and a DNS operation is configured
with the DNS server as the destination device.
Connection response time is computed by measuring the difference between the time taken to send a
request to the DNS server and the time a reply is received by Router B. The resulting DNS lookup time can
help you analyze your DNS performance. Faster DNS lookup times translate to a faster web server access
experience.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. dns {destination-ip-address | destination-hostname} name-server ip-address [source-ip {ip-address |
hostname} source-port port-number]
5. frequency seconds
6. end
DETAILED STEPS
Example:
Router# configure terminal
Step 4 dns {destination-ip-address | destination-hostname} name-server ip- Defines a DNS operation and enters IP SLA DNS
address [source-ip {ip-address | hostname} source-port port- configuration mode.
number]
Example:
Router(config-ip-sla)# dns host1 name-server 172.20.2.132
Example:
Router(config-ip-sla-dns)# end
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. dns {destination-ip-address | destination-hostname} name-server ip-address [source-ip {ip-address |
hostname} source-port port-number]
5. history buckets-kept size
6. history distributions-of-statistics-kept size
7. history enhanced [interval seconds] [buckets number-of-buckets]
8. history filter {none | all | overThreshold | failures}
9. frequency seconds
10. history hours-of-statistics-kept hours
11. history lives-kept lives
12. owner owner-id
13. history statistics-distribution-interval milliseconds
14. tag text
15. threshold milliseconds
16. timeout milliseconds
17. end
DETAILED STEPS
Example:
Router# configure terminal
Step 4 dns {destination-ip-address | destination-hostname} name- Defines a DNS operation and enters IP SLA DNS
server ip-address [source-ip {ip-address | hostname} source- configuration mode.
port port-number]
Example:
Router(config-ip-sla)# dns host1 name-server
172.20.2.132
Step 5 history buckets-kept size (Optional) Sets the number of history buckets that are
kept during the lifetime of an IP SLAs operation.
Example:
Router(config-ip-sla-dns)# history buckets-kept 25
Step 6 history distributions-of-statistics-kept size (Optional) Sets the number of statistics distributions
kept per hop during an IP SLAs operation.
Example:
Router(config-ip-sla-dns)# history distributions-of-
statistics-kept 5
Step 7 history enhanced [interval seconds] [buckets number-of- (Optional) Enables enhanced history gathering for an IP
buckets] SLAs operation.
Example:
Router(config-ip-sla-dns)# history enhanced interval
900 buckets 100
Step 8 history filter {none | all | overThreshold | failures} (Optional) Defines the type of information kept in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-dns)# history filter failures
Step 9 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-dns)# frequency 30
Step 10 history hours-of-statistics-kept hours (Optional) Sets the number of hours for which statistics
are maintained for an IP SLAs operation.
Example:
Router(config-ip-sla-dns)# history hours-of-
statistics-kept 4
Step 11 history lives-kept lives (Optional) Sets the number of lives maintained in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-dns)# history lives-kept 5
Example:
Router(config-ip-sla-dns)# owner admin
Step 13 history statistics-distribution-interval milliseconds (Optional) Sets the time interval for each statistics
distribution kept for an IP SLAs operation.
Example:
Router(config-ip-sla-dns)# history statistics-
distribution-interval 10
Step 15 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
Example: operation.
Example:
Router(config-ip-sla-dns)# end
Note
All IP SLAs operations to be scheduled must be already configured.
The frequency of all operations scheduled in a multioperation group must be the same.
List of one or more operation ID numbers to be added to a multioperation group is limited to a
maximum of 125 characters, including commas (,).
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
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]
ip sla group schedule group-operation-number operation-id-numbers schedule-period schedule-
period-range [ageout seconds] [frequency group-operation-frequency] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
4. exit
5. show ip sla group schedule
6. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
ip sla schedule operation-number [life {forever | seconds}] [start-time Configures the scheduling parameters for an
{hh : mm[: ss] [month day | day month] | pending | now | after hh : mm individual IP SLAs operation.
: ss}] [ageout seconds] [recurring] or
ip sla group schedule group-operation-number operation-id-numbers For multioperation scheduler only:
schedule-period schedule-period-range [ageout seconds] [frequency
group-operation-frequency] [life{forever | seconds}] [start- Specifies an IP SLAs operation group
time{hh:mm[:ss] [month day | day month] | pending | now | after number and the range of operation numbers
hh:mm:ss}] to be scheduled in global configuration
mode.
Example:
Router(config)# ip sla schedule 10 start-time now life forever
Example:
Router(config)# ip sla group schedule 1 3,4,6-9
Example:
Router(config)# exit
Step 5 show ip sla group schedule (Optional) Displays the IP SLAs group
schedule details.
Example:
Router# show ip sla group schedule
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
operation will query the DNS server for the IP address associated with the hostname host1. No
configuration is required at the DNS server.
Router B Configuration
ip sla 11
dns host1 name-server 172.20.2.132
frequency 50
timeout 8000
tag DNS-Test
ip sla schedule 11 start-time now
Additional References
Related Documents
Cisco IOS IP SLAs: general information Configuring IOS IP SLAs Overview chapter of the
Cisco IOS IP SLAs Configuration Guide
Standards
Standards Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by this feature.
MIBs
RFCs
RFCs Title
No new or modified RFCs are supported by this --
feature, and support for existing RFCs has not been
modified by this feature.
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
DHCP Operation
DHCP provides a mechanism for allocating IP addresses dynamically so that addresses can be reused when
hosts no longer need them. The DHCP operation measures the round-trip time (RTT) taken to discover a
DHCP server and obtain a leased IP address from it. IP SLAs releases the leased IP address after the
operation.
You can use the RTT information to determine DHCP performance levels.
There are two modes for the DHCP operation. By default, the DHCP operation sends discovery packets on
every available IP interface on the router. If a specific server is configured on the router, discovery packets
are sent only to the specified DHCP server.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. dhcp {destination-ip-address | destination-hostname} [source-ip {ip-address | hostname}] [option-82
[circuit-id circuit-id] [remote-id remote-id] [subnet-mask subnet-mask]]
5. frequency seconds
6. end
DETAILED STEPS
Example:
Router# configure terminal
Step 4 dhcp {destination-ip-address | destination-hostname} [source-ip {ip- Defines a DHCP operation and enters IP SLA
address | hostname}] [option-82 [circuit-id circuit-id] [remote-id DHCP configuration mode.
remote-id] [subnet-mask subnet-mask]]
Example:
Router(config-ip-sla)# dhcp 10.10.10.3
Example:
Router(config-ip-sla-dhcp)# end
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. dhcp {destination-ip-address | destination-hostname} [source-ip {ip-address | hostname}] [option-82
[circuit-id circuit-id] [remote-id remote-id] [subnet-mask subnet-mask]]
5. history buckets-kept size
6. history distributions-of-statistics-kept size
7. history enhanced [interval seconds] [buckets number-of-buckets]
8. history filter {none | all | overThreshold | failures}
9. frequency seconds
10. history hours-of-statistics-kept hours
11. history lives-kept lives
12. owner owner-id
13. history statistics-distribution-interval milliseconds
14. tag text
15. threshold milliseconds
16. timeout milliseconds
17. end
DETAILED STEPS
Example:
Router# configure terminal
Step 4 dhcp {destination-ip-address | destination-hostname} [source- Defines a DHCP operation and enters IP SLA DHCP
ip {ip-address | hostname}] [option-82 [circuit-id circuit-id] configuration mode.
[remote-id remote-id] [subnet-mask subnet-mask]]
Example:
Router(config-ip-sla)# dhcp 10.10.10.3 option-82
circuit-id 10005A6F1234
Step 5 history buckets-kept size (Optional) Sets the number of history buckets that are
kept during the lifetime of an IP SLAs operation.
Example:
Router(config-ip-sla-dhcp)# history buckets-kept 25
Step 6 history distributions-of-statistics-kept size (Optional) Sets the number of statistics distributions
kept per hop during an IP SLAs operation.
Example:
Router(config-ip-sla-dhcp)# history distributions-of-
statistics-kept 5
Step 7 history enhanced [interval seconds] [buckets number-of- (Optional) Enables enhanced history gathering for an IP
buckets] SLAs operation.
Example:
Router(config-ip-sla-dhcp)# history enhanced interval
900 buckets 100
Step 8 history filter {none | all | overThreshold | failures} (Optional) Defines the type of information kept in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-dhcp)# history filter failures
Step 9 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-dhcp)# frequency 30
Step 10 history hours-of-statistics-kept hours (Optional) Sets the number of hours for which statistics
are maintained for an IP SLAs operation.
Example:
Router(config-ip-sla-dhcp)# history hours-of-
statistics-kept 4
Step 11 history lives-kept lives (Optional) Sets the number of lives maintained in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-dhcp)# history lives-kept 5
Example:
Router(config-ip-sla-dhcp)# owner admin
Step 13 history statistics-distribution-interval milliseconds (Optional) Sets the time interval for each statistics
distribution kept for an IP SLAs operation.
Example:
Router(config-ip-sla-dhcp)# history statistics-
distribution-interval 10
Step 15 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
Example: operation.
Example:
Router(config-ip-sla-dhcp)# end
Note
All IP SLAs operations to be scheduled must be already configured.
The frequency of all operations scheduled in a multioperation group must be the same.
List of one or more operation ID numbers to be added to a multioperation group is limited to a
maximum of 125 characters, including commas (,).
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
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]
ip sla group schedule group-operation-number operation-id-numbers schedule-period schedule-
period-range [ageout seconds] [frequency group-operation-frequency] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
4. exit
5. show ip sla group schedule
6. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
ip sla schedule operation-number [life {forever | seconds}] [start-time Configures the scheduling parameters for an
{hh : mm[: ss] [month day | day month] | pending | now | after hh : mm individual IP SLAs operation.
: ss}] [ageout seconds] [recurring] or
ip sla group schedule group-operation-number operation-id-numbers For multioperation scheduler only:
schedule-period schedule-period-range [ageout seconds] [frequency
group-operation-frequency] [life{forever | seconds}] [start- Specifies an IP SLAs operation group
time{hh:mm[:ss] [month day | day month] | pending | now | after number and the range of operation numbers
hh:mm:ss}] to be scheduled in global configuration
mode.
Example:
Router(config)# ip sla schedule 10 start-time now life forever
Example:
Router(config)# ip sla group schedule 1 3,4,6-9
Example:
Router(config)# exit
Step 5 show ip sla group schedule (Optional) Displays the IP SLAs group
schedule details.
Example:
Router# show ip sla group schedule
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
Router B Configuration
ip dhcp-server 172.16.20.3
!
ip sla 12
dhcp 10.10.10.3 option-82 circuit-id 10005A6F1234
frequency 30
timeout 5000
tag DHCP_Test
!
ip sla schedule 12 start-time now
Additional References
Related Documents
Cisco IOS IP SLAs: general information Configuring IOS IP SLAs Overview chapter of the
Cisco IP SLAs Configuration Guide.
Standards
Standards Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by this feature.
MIBs
RFCs
RFCs Title
No new or modified RFCs are supported by this --
feature, and support for existing RFCs has not been
modified by this feature.
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
Prerequisites
A connected DLSw+ peer between the source and destination networking devices must be configured.
DLSw+ Operation
The Cisco IOS IP SLAs DLSw+ operation measures the DLSw+ protocol stack and network response time
between DLSw+ peers. DLSw+ is the enhanced Cisco version of RFC 1795. DLSw+ tunnels non-routable
Layer 2 traffic such as Systems Network Architecture (SNA) traffic over IP backbones via TCP. The
networking devices performing the tunneling of non-routable traffic into TCP/IP are referred to as DLSw+
peers. DLSw+ peers normally communicate through TCP port 2065. The destination networking device
does not have to be a Cisco router if it supports RFC 1795.
In the figure below, Router A is configured as the source IP SLAs device and a DLSw+ operation is
configured with Router B as the remote DLSw+ peer. Router A and Router B are configured as connected
DLSw+ peers. The peer (destination device) does not have to run a Cisco IOS IP SLA-capable image.
Network response time is computed by measuring the round-trip time (RTT) taken to connect to the remote
DLSw+ peer using TCP. This operation does not use the IP SLAs Responder.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. dlsw peer-ipaddr ip-address
5. frequency seconds
6. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla operation-number Begins configuration for an IP SLAs operation and enters
IP SLA configuration mode.
Example:
Router(config)# ip sla 10
Step 4 dlsw peer-ipaddr ip-address Defines a DLSw+ operation and enters IP SLA DLSw+
configuration mode.
Example:
Router(config-ip-sla)# dlsw peer-ipaddr 172.21.27.11
Step 5 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-dlsw)# frequency 30
Example:
Router(config-ip-sla-dlsw)# end
Configuring an IP SLAs DLSw+ Operation with Optional Parameters on the Source Device
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. dlsw peer-ipaddr ip-address
5. history buckets-kept size
6. history distributions-of-statistics-kept size
7. history enhanced [interval seconds] [buckets number-of-buckets]
8. history filter {none | all | overThreshold | failures}
9. frequency seconds
10. history hours-of-statistics-kept hours
11. history lives-kept lives
12. owner owner-id
13. request-data-size bytes
14. history statistics-distribution-interval milliseconds
15. tag text
16. threshold milliseconds
17. timeout milliseconds
18. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla operation-number Begins configuration for an IP SLAs operation and enters
IP SLA configuration mode.
Example:
Router(config)# ip sla 10
Step 4 dlsw peer-ipaddr ip-address Defines a DLSw+ operation and enters IP SLA DLSw
configuration mode.
Example:
Router(config-ip-sla)# dlsw peer-ipaddr 172.21.27.11
Step 6 history distributions-of-statistics-kept size (Optional) Sets the number of statistics distributions kept
per hop during an IP SLAs operation.
Example:
Router(config-ip-sla-dlsw)# history distributions-
of-statistics-kept 5
Step 7 history enhanced [interval seconds] [buckets number-of- (Optional) Enables enhanced history gathering for an IP
buckets] SLAs operation.
Example:
Router(config-ip-sla-dlsw)# history enhanced
interval 900 buckets 100
Step 8 history filter {none | all | overThreshold | failures} (Optional) Defines the type of information kept in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-dlsw)# history filter failures
Step 9 frequency seconds (Optional) Sets the rate at which a specified IP SLAs
operation repeats.
Example:
Router(config-ip-sla-dlsw)# frequency 30
Step 10 history hours-of-statistics-kept hours (Optional) Sets the number of hours for which statistics
are maintained for an IP SLAs operation.
Example:
Router(config-ip-sla-dlsw)# hours-of-statistics-
kept 4
Step 11 history lives-kept lives (Optional) Sets the number of lives maintained in the
history table for an IP SLAs operation.
Example:
Router(config-ip-sla-dlsw)# history lives-kept 5
Step 13 request-data-size bytes (Optional) Sets the protocol data size in the payload of an
IP SLAs operation's request packet.
Example:
Router(config-ip-sla-dlsw)# request-data-size 64
Step 14 history statistics-distribution-interval milliseconds (Optional) Sets the time interval for each statistics
distribution kept for an IP SLAs operation.
Example:
Router(config-ip-sla-dlsw)# history statistics-
distribution-interval 10
Step 16 threshold milliseconds (Optional) Sets the upper threshold value for calculating
network monitoring statistics created by an IP SLAs
Example: operation.
Step 17 timeout milliseconds (Optional) Sets the amount of time an IP SLAs operation
waits for a response from its request packet.
Example:
Router(config-ip-sla-dlsw)# timeout 10000
Example:
Router(config-ip-sla-dlsw)# exit
Note
All IP SLAs operations to be scheduled must be already configured.
The frequency of all operations scheduled in a multioperation group must be the same.
List of one or more operation ID numbers to be added to a multioperation group is limited to a
maximum of 125 characters, including commas (,).
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
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]
ip sla group schedule group-operation-number operation-id-numbers schedule-period schedule-
period-range [ageout seconds] [frequency group-operation-frequency] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
4. exit
5. show ip sla group schedule
6. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
ip sla schedule operation-number [life {forever | seconds}] [start-time Configures the scheduling parameters for an
{hh : mm[: ss] [month day | day month] | pending | now | after hh : mm individual IP SLAs operation.
: ss}] [ageout seconds] [recurring] or
ip sla group schedule group-operation-number operation-id-numbers For multioperation scheduler only:
schedule-period schedule-period-range [ageout seconds] [frequency
group-operation-frequency] [life{forever | seconds}] [start- Specifies an IP SLAs operation group
time{hh:mm[:ss] [month day | day month] | pending | now | after number and the range of operation numbers
hh:mm:ss}] to be scheduled in global configuration
mode.
Example:
Router(config)# ip sla schedule 10 start-time now life forever
Example:
Router(config)# ip sla group schedule 1 3,4,6-9
Example:
Router(config)# exit
Step 5 show ip sla group schedule (Optional) Displays the IP SLAs group
schedule details.
Example:
Router# show ip sla group schedule
Troubleshooting Tips
If the IP SLAs operation is not running and generating statistics, add the verify-data command to the
configuration of the operation (while configuring in IP SLA configuration mode) to enable data
verification. When enabled, each operation response is checked for corruption. Use the verify-data
command with caution during normal operations because it generates unnecessary overhead.
Use the debugipsla trace and debug ip sla error commands to help troubleshoot issues with an IP
SLAs operation.
What to Do Next
To add proactive threshold conditions and reactive triggering for generating traps, or for starting another
operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section.
To view and interpret the results of an IP SLAs operation use the show ip sla statistics command.
Checking the output for fields that correspond to criteria in your service level agreement will help you
determine whether the service metrics are acceptable.
DLSw+ peer, and the IP SLAs DLSw+ operation parameters are configured. The operation is scheduled to
start immediately and run for 7200 seconds (2 hours).
Router B Configuration
configure terminal
dlsw local-peer peer-id 172.21.27.11
dlsw remote-peer 0 tcp 172.20.26.10
Router A Configuration
Additional References
Related Documents
Cisco IOS IP SLAs: general information Configuring IOS IP SLAs Overview chapter of the
Cisco IOS IP SLAs Configuration Guide.
Standards
Standards Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by this feature.
MIBs
RFCs
RFCs Title
RFC 1795 Data Link Switching: Switch-to-Switch Protocol
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
the 60 operations are distributed equally at 1-second intervals over a 60-second schedule period, then some
of the operations would detect the network failure. Conversely, if a network failure occurs when all 60
operations are active, then all 60 operations would fail, indicating that the failure is possibly more severe
than it really is.
Operations of the same type and same frequency should be used for IP SLAs multiple operations
scheduling. If you do not specify a frequency, the default frequency will be the same as that of the schedule
period. The schedule period is the period of time in which all the specified operations should run.
The following sections focus on the interaction of the schedule period and frequency values, additional
values, such as start time and lifetime values, are not included in the illustrations.
Default Behavior of IP SLAs Multiple Operations Scheduling, page 267
IP SLAs Multiple Operations Scheduling with Scheduling Period Less Than Frequency, page 268
Multiple Operations Scheduling When the Number of IP SLAs Operations Are Greater Than the
Schedule Period, page 269
IP SLAs Multiple Operations Scheduling with Scheduling Period Greater Than Frequency, page 270
In this example, the first operation (operation 1) in operation group 1 will start at 0 seconds. All 10
operations in operation group 1 (operation 1 to operation 10) must be started in the schedule period of 20
seconds. The start time of each IP SLAs operation is evenly distributed over the schedule period by
dividing the schedule period by the number of operations (20 seconds divided by 10 operations). Therefore,
each operation will start 2 seconds after the previous operation.
The frequency is the period of time that passes before the operation group is started again (repeated). If the
frequency is not specified, the frequency is set to the value of the schedule period. In the example shown
above, operation group 1 will start again every 20 seconds. This configuration provides optimal division
(spacing) of operations over the specified schedule period.
IP SLAs Multiple Operations Scheduling with Scheduling Period Less Than Frequency
The frequency value is the amount of time that passes before the schedule group is restarted, if the schedule
period is less than the frequency, there will be a period of time in which no operations are started.
The figure below illustrates the scheduling of operation 1 to operation 10 within operation group 2.
Operation group 2 has a schedule period of 20 seconds and a frequency of 30 seconds.
In this example, the first operation (operation 1) in operation group 2 will start at 0 seconds. All 10
operations in operation group 2 (operation 1 to operation 10) must be started in the schedule period of 20
seconds. The start time of each IP SLAs operation is evenly distributed over the schedule period by
dividing the schedule period by the number of operations (20 seconds divided by 10 operations). Therefore,
each operation will start 2 seconds after the previous operation.
In the first iteration of operation group 2, operation 1 starts at 0 seconds, and the last operation (operation
10) starts at 18 seconds. However, because the group frequency has been configured to 30 seconds each
operation in the operation group is restarted every 30 seconds. So, after 18 seconds, there is a gap of 10
seconds as no operations are started in the time from 19 seconds to 29 seconds. Hence, at 30 seconds, the
second iteration of operation group 2 starts. As all ten operations in the operation group 2 must start at an
evenly distributed interval in the configured schedule period of 20 seconds, the last operation (operation
10) in the operation group 2 will always start 18 seconds after the first operation (operation 1).
As illustrated in the figure above, the following events occur:
At 0 seconds, the first operation (operation 1) in operation group 2 is started.
At 18 seconds, the last operation (operation 10) in operation group 2 is started. This means that the
first iteration (schedule period) of operation group 1 ends here.
From 19 to 29 seconds, no operations are started.
At 30 seconds, the first operation (operation 1) in operation group 2 is started again. The second
iteration of operation group 2 starts here.
At 48 seconds (18 seconds after the second iteration started) the last operation (operation 10) in
operation group 2 is started, and the second iteration of operation group 2 ends.
At 60 seconds, the third iteration of operation group 2 starts.
This process continues until the lifetime of operation group 2 ends. The lifetime value is configurable. The
default lifetime for an operation group is forever.
Multiple Operations Scheduling When the Number of IP SLAs Operations Are Greater Than
the Schedule Period
The minimum time interval between the start of IP SLAs operations in a group operation is 1 second.
Therefore, if the number of operations to be multiple scheduled is greater than the schedule period, the IP
SLAs multiple operations scheduling functionality will schedule more than one operation to start within the
same 1-second interval. If the number of operations getting scheduled does not equally divide into 1-second
intervals, then the operations are equally divided at the start of the schedule period with the remaining
operations to start at the last 1-second interval.
The figure below illustrates the scheduling of operation 1 to operation 10 within operation group 3.
Operation group 3 has a schedule period of 5 seconds and a frequency of 10 seconds.
Figure 20: Number of IP SLAs Operations Is Greater Than the Schedule Period--Even Distribution
In this example, when dividing the schedule period by the number of operations (5 seconds divided by 10
operations, which equals one operation every 0.5 seconds) the start time of each IP SLAs operation is less
than 1 second. Since the minimum time interval between the start of IP SLAs operations in a group
operation is 1 second, the IP SLAs multiple operations scheduling functionality instead calculates how
many operations it should start in each 1-second interval by dividing the number of operations by the
schedule period (10 operations divided by 5 seconds). Therefore, as shown in the figure above, two
operations will be started every 1 second.
As the frequency is set to 10 in this example, each iteration of operation group 3 will start 10 seconds after
the start of the previous iteration. However, this distribution is not optimal as there is a gap of 5 seconds
(frequency minus schedule period) between the cycles.
If the number of operations getting scheduled does not equally divide into 1-second intervals, then the
operations are equally divided at the start of the schedule period with the remaining operations to start at
the last 1-second interval.
The figure below illustrates the scheduling of operation 1 to operation 10 within operation group 4.
Operation group 4 has a schedule period of 4 seconds and a frequency of 5 seconds.
Figure 21: Number of IP SLAs Operations Is Greater Than the Schedule Period--Uneven Distribution
In this example, the IP SLAs multiple operations scheduling functionality calculates how many operations
it should start in each 1-second interval by dividing the number of operations by the schedule period (10
operations divided by 4 seconds, which equals 2.5 operations every 1 second). Since the number of
operations does not equally divide into 1-second intervals, this number will be rounded off to the next
whole number (see the figure above) with the remaining operations to start at the last 1-second interval.
IP SLAs Multiple Operations Scheduling with Scheduling Period Greater Than Frequency
The value of frequency is the amount of time that passes before the schedule group is restarted. If the
schedule period is greater than the frequency, there will be a period of time in which the operations in one
iteration of an operation group overlap with the operations of the following iteration.
The figure below illustrates the scheduling of operation 1 to operation 10 within operation group 5.
Operation group 5 has a schedule period of 20 seconds and a frequency of 10 seconds.
Figure 22: IP SLAs Group Scheduling with Schedule Period Greater Than Frequency
In this example, the first operation (operation 1) in operation group 5 will start at 0 seconds. All 10
operations in operation group 5 (operation 1 to operation 10) must be started in the schedule period of 20
seconds. The start time of each IP SLAs operation is evenly distributed over the schedule period by
dividing the schedule period by the number of operations (20 seconds divided by 10 operations). Therefore,
each operation will start 2 seconds after the previous operation.
In the first iteration of operation group 5, operation 1 starts at 0 seconds, and operation 10, the last
operation in the operation group, starts at 18 seconds. Because the operation group is configured to restart
every 10 seconds (frequency 10), the second iteration of operation group 5 starts again at 10 seconds,
before the first iteration is completed. Therefore, an overlap of operations 6 to 10 of the first iteration
occurs with operations 1 to 5 of the second iteration during the time period of 10 to 18 seconds (see the
figure above). Similarly, there is an overlap of operations 6 to 10 of the second iteration with operations 1
to 5 of the third iteration during the time period of 20 to 28 seconds.
In this example, the start time of operation 1 and operation 6 need not be at exactly the same time, but will
be within the same 2-second interval.
The configuration described in this section is not recommended as you can configure multiple operations to
start within the same 1-second interval by configuring the number of operations greater than the schedule
period. For information, see the "Multiple Operations Scheduling When the Number of IP SLAs Operations
Are Greater Than the Schedule Period" section.
Note The IP SLAs Random Scheduler feature is not in compliance with RFC2330 because it does not account
for inter-packet randomness.
The IP SLAs random scheduler option is disabled by default. To enable the random scheduler option, you
must set a frequency range when configuring a group schedule in global configuration mode. The group of
operations restarts at uniformly distributed random frequencies within the specified frequency range. The
following guidelines apply for setting the frequency range:
The starting value of the frequency range should be greater than the timeout values of all the
operations in the group operation.
The starting value of the frequency range should be greater than the schedule period (amount of time
for which the group operation is scheduled). This guideline ensures that the same operation does not
get scheduled more than once within the schedule period.
The following guidelines apply if the random scheduler option is enabled:
The individual operations in a group operation will be uniformly distributed to begin at random
intervals over the schedule period.
The group of operations restarts at uniformly distributed random frequencies within the specified
frequency range.
The minimum time interval between the start of each operation in a group operation is 100
milliseconds (0.1 seconds). If the random scheduler option is disabled, the minimum time interval is 1
second.
Only one operation can be scheduled to begin at any given time. If the random scheduler option is
disabled, multiple operations can begin at the same time.
The first operation will always begin at 0 milliseconds of the schedule period.
The order in which each operation in a group operation begins is random.
Note
All IP SLAs operations to be scheduled must be already configured.
The frequency of all operations scheduled in a multioperation group should be the same.
List of one or more operation ID numbers to be added to a multioperation group is limited to a
maximum of 125 characters, including commas (,).
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla group schedule group-operation-number operation-id-numbers schedule-period schedule-
period-range [ageout seconds] [frequency group-operation-frequency] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
4. exit
5. show ip sla group schedule
6. show ip sla configuration
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla group schedule group-operation-number operation-id-numbers Specifies an IP SLAs operation group number
schedule-period schedule-period-range [ageout seconds] [frequency and the range of operation numbers to be
group-operation-frequency] [life{forever | seconds}] [start- scheduled in global configuration mode.
time{hh:mm[:ss] [month day | day month] | pending | now | after
hh:mm:ss}]
Example:
Router(config)# ip sla group schedule 1 3,4,6-9
Example:
Router(config)# exit
Step 5 show ip sla group schedule (Optional) Displays the IP SLAs group
schedule details.
Example:
Router# show ip sla group schedule
1. enable
2. configure terminal
3. ip sla group schedule group-operation-number operation-id-numbers schedule-period seconds
[ageout seconds] [frequency [seconds| range random-frequency-range]] [life{forever | seconds}]
[start-time{hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}]
4. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla group schedule group-operation-number operation-id- Specifies the scheduling parameters of a group of IP
numbers schedule-period seconds [ageout seconds] [frequency SLAs operations.
[seconds| range random-frequency-range]] [life{forever | seconds}] To enable the IP SLAs random scheduler option,
[start-time{hh:mm[:ss] [month day | day month] | pending | now | you must configure the frequency range
after hh:mm:ss}] random-frequency-range keywords and
argument.
Example:
Router(config)# ip sla group schedule 2 1-3 schedule-
period 50 frequency range 80-100
DETAILED STEPS
Example:
Router# show ip sla statistics
Step 2 show ip sla group schedule (Optional) Displays the IP SLAs group schedule details.
Example:
Router# show ip sla group schedule
Step 3 show ip sla configuration (Optional) Displays the IP SLAs configuration details.
Example:
Router# show ip sla configuration
Examples
After you have scheduled the multiple IP SLAs operations, you can verify the latest operation details using
the appropriate show commands.
The following example schedules IP SLAs operations 1 through 20 in the operation group 1 with a
schedule period of 60 seconds and a life value of 1200 seconds. By default, the frequency is equivalent to
the schedule period. In this example, the start interval is 3 seconds (schedule period divided by number of
operations).
The following example shows the details of the scheduled multiple IP SLAs operation using the show ip
sla configuration command. The last line in the example indicates that the IP SLAs operations are multiple
scheduled (TRUE).
The following example shows the latest operation start time of the scheduled multiple IP SLAs operation,
when the operations are scheduled at equal intervals, using the show ip sla statistics command:
The following example shows the details of the scheduled multiple IP SLAs operation using the show ip
sla group schedule command. The last line in the example indicates that the IP SLAs operations are
multiple scheduled (TRUE).
ip sla group schedule 2 1-3 schedule-period 50 frequency range 80-100 start-time now
Additional References
Related Documents
Standards
Standards Title
No new or modified standards are supported by this --
feature.
MIBs
RFCs
RFCs Title
No new or modified RFCs are supported by this --
feature.
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/
provides online resources to download index.html
documentation, software, and tools. Use these
resources to install and configure the software and
to troubleshoot and resolve technical issues with
Cisco products and technologies. Access to most
tools on the Cisco Support and Documentation
website requires a Cisco.com user ID and
password.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.
Reaction ICMP Path Echo UDP UDP Echo TCP DHCP DLSW ICMP DNS Frame
Echo Jitter Connect Jitter Relay
Failure Y -- Y Y Y Y -- Y Y --
RTT Y Y -- Y Y Y Y -- Y Y
RTTAvg -- -- Y -- -- -- -- Y -- --
timeout Y Y Y Y Y Y Y Y Y Y
connectio -- -- Y Y Y -- -- -- --
nLoss
verifyErr -- -- Y Y -- -- -- Y -- Y
or
jitterSDA -- -- Y -- -- -- Y -- --
vg
jitterAvg -- -- Y -- -- -- -- Y -- --
packetLat -- -- Y -- -- -- -- Y -- --
eArrival
packetOu -- -- Y -- -- -- -- Y -- --
tOfSeque
nce
MaxOfPo -- -- Y -- -- -- Y -- --
stiveSD
MaxOfNe -- -- Y -- -- -- -- Y -- --
gativeSD
MaxOfPo -- -- Y -- -- -- -- Y -- --
stiveDS
MaxOfNe -- -- Y -- -- -- -- Y -- --
gativeDS
MOS -- -- Y -- -- -- -- -- --
ICPIF -- -- Y -- -- -- -- -- -- --
PacketLo -- -- Y -- -- -- -- -- -- --
ssDS
Reaction ICMP Path Echo UDP UDP Echo TCP DHCP DLSW ICMP DNS Frame
Echo Jitter Connect Jitter Relay
PacketLo -- -- Y -- -- -- -- -- -- --
ssSD
PacketMI -- -- Y -- -- -- -- -- --
A
iaJitterDS -- -- -- -- -- -- -- -- -- --
frameLos -- -- -- -- -- -- -- -- -- --
sDS
mosLQD -- -- -- -- -- -- -- -- -- --
SS
mosCQD -- -- -- -- -- -- -- -- -- --
S
rfactorDS -- -- -- -- -- -- -- -- -- --
iaJitterSD -- -- -- -- -- -- -- -- -- --
successiv -- -- -- -- -- -- -- Y -- --
ePacketL
oss
MaxOfLa -- -- -- -- -- -- -- Y -- --
tencyDS
MaxOfLa -- -- -- -- -- -- -- Y -- --
tencySD
LatencyD -- -- -- -- -- -- -- Y -- --
S
LatencyS -- -- -- -- -- -- -- Y -- --
D
packetLo -- -- -- -- -- -- -- Y -- --
ss
Reaction HTTP SLM RTP FTP Lsp Trace Post delay Path Jitter LSP Ping Gatekeepe
r
Registratio
n
Failure -- -- -- -- -- -- -- -- --
RTT Y Y Y Y Y Y Y Y Y
Reaction HTTP SLM RTP FTP Lsp Trace Post delay Path Jitter LSP Ping Gatekeepe
r
Registratio
n
RTTAvg -- -- -- -- -- -- -- -- --
timeout Y Y Y Y -- Y Y Y Y
connection Y Y Y Y -- -- Y --
Loss
verifyError -- -- -- -- -- -- -- -- --
jitterSDAv -- -- -- -- -- -- Y -- --
g
jitterAvg -- -- -- -- -- -- Y -- --
packetLate -- -- -- -- -- -- Y -- --
Arrival
packetOut -- -- -- -- -- -- Y -- --
OfSequenc
e
MaxOfPos -- -- -- -- -- -- Y -- --
tiveSD
MaxOfNe -- -- -- -- -- -- Y -- --
gativeSD
MaxOfPos -- -- -- -- -- -- Y -- --
tiveDS
MaxOfNe -- -- -- -- -- -- Y -- --
gativeDS
MOS -- -- -- -- -- -- -- -- --
ICPIF -- -- -- -- -- -- -- -- --
PacketLos -- -- Y -- -- -- -- -- --
sDS
PacketLos -- -- Y -- -- -- -- -- --
sSD
PacketMI -- -- Y -- -- -- -- -- --
A
iaJitterDS -- -- Y -- -- -- -- -- --
frameLoss -- -- Y -- -- -- -- -- --
DS
Reaction HTTP SLM RTP FTP Lsp Trace Post delay Path Jitter LSP Ping Gatekeepe
r
Registratio
n
mosLQDS -- -- Y -- -- -- -- -- --
S
mosCQDS -- -- Y -- -- -- -- -- --
rfactorDS -- -- Y
iaJitterSD -- -- Y -- -- -- -- -- --
successive -- -- -- -- -- -- -- -- --
PacketLos
s
MaxOfLat -- -- -- -- -- -- -- -- --
encyDS
MaxOfLat -- -- -- -- -- -- -- -- --
encySD
LatencyDS -- -- -- -- -- -- -- -- --
LatencySD -- -- -- -- -- -- -- -- --
packetLoss -- -- -- -- -- -- -- -- --
IP SLAs Threshold violations are logged as level 6 (informational) within the Cisco system logging process
but are sent as level 7 (info) traps from the CISCO-SYSLOG-MIB.
Notifications are not issued for every occurrence of a threshold violation. The figure below illustrates the
sequence for a triggered reaction that occurs when the monitored element exceeds the upper threshold. An
event is sent and a notification is issued when the rising threshold is exceeded for the first time. Subsequent
threshold-exceeded notifications are issued only after the monitored value falls below the falling threshold
before exceeding the rising threshold ag ain .
Figure 23: IP SLAs Triggered Reaction Condition and Notifications for Threshold Exceeded
Note A lower-threshold notification is also issued the first time that the monitored element falls below the falling
threshold (3). As described, subsequent notifications for lower-threshold violations will be issued only after
the rising threshold is exceeded before the monitored value falls below the falling threshold again.
RTT reactions for jitter operations are triggered only at the end of the operation and use the latest value for
the return-trip time (LatestRTT), which matches the value of the average return-trip time (RTTAvg).
SNMP traps for RTT for jitter operations are based on the value of the average return-trip time (RTTAvg)
for the whole operation and do not include RTT values for each individual packet sent during the operation.
For example, if the average is below the threshold, up to half of the packets can actually be above threshold
but this detail is not included in the notification because the value is for the whole operation only.
Only syslog messages are supported for RTTAvg threshold violations. Syslog nmessages are sent from the
CISCO-RTTMON-MIB.
Note
RTT reactions for jitter operations are triggered only at the end of the operation and use the latest
value for the return-trip time (LatestRTT).
SNMP traps for RTT for jitter operations are based on the average value for the return-trip time
(RTTAvg) for the whole operation only and do not include return-trip time values for individual
packets sent during the operation. Only syslog messages are supported for RTTAvg threshold
violations.
Only syslog messages are supported for RTT violations during Jitter operations.
Only SNMP traps are supported for RTT violations during non-Jitter operations.
Only syslog messages are supported for non-RTT violations other than timeout, connectionLoss, or
verifyError.
Both SNMP traps and syslog messages are supported for timeout, connectionLoss, or verifyError
violations only.
SUMMARY STEPS
1. enable
2. configure terminal
3. 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]
4. ip sla reaction-trigger operation-number target-operation
5. ip sla logging traps
6. Do one of the following:
snmp-server enable traps rtr
snmp-server enable traps syslog
7. snmp-server host {hostname | ip-address} [vrf vrf-name] [traps | informs] [version {1 | 2c | 3 [auth |
noauth | priv]}] community-string [udp-port port] [notification-type]
8. exit
9. show ip sla reaction configuration [operation-number]
10. show ip sla reaction trigger [operation-number]
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ip sla reaction-configuration operation-number react Configures the action (SNMP trap or IP SLAs trigger)
monitored-element [action-type option] [threshold-type that is to occur based on violations of specified
{average [number-of-measurements] | consecutive thresholds.
[occurrences] | immediate | never | xofy [x-value y-value]}]
[threshold-value upper-threshold lower-threshold]
Example:
Router(config)# ip sla reaction-configuration 10
react jitterAvg threshold-type immediate threshold-
value 5000 3000 action-type trapAndTrigger
Step 4 ip sla reaction-trigger operation-number target-operation (Optional) Starts another IP SLAs operation when the
violation conditions are met.
Example:
Router(config)# ip sla reaction-trigger 10 2
Example:
Router(config)# snmp-server enable traps syslog
Step 7 snmp-server host {hostname | ip-address} [vrf vrf-name] (Optional) Sends traps to a remote host.
[traps | informs] [version {1 | 2c | 3 [auth | noauth | priv]}] Required if the snmp-server enable traps
community-string [udp-port port] [notification-type] command is configured.
Example:
Router(config)# snmp-server host 10.1.1.1 public
syslog
Step 9 show ip sla reaction configuration [operation-number] (Optional) Displays the configuration of proactive
threshold monitoring.
Example:
Router# show ip sla reaction configuration 10
Step 10 show ip sla reaction trigger [operation-number] (Optional) Displays the configuration status and
operational state of target operations to be triggered.
Example:
Router# show ip sla reaction trigger 2
Entry Number: 1
Reaction: RTT
Threshold type: Never
Rising (milliseconds): 5000
Falling (milliseconds): 3000
Threshold Count: 5
Threshold Count2: 5
Action Type: None
Reaction: jitterDSAvg
Threshold type: average
Rising (milliseconds): 5
Falling (milliseconds): 3
Threshold Count: 5
Threshold Count2: 5
Action Type: triggerOnly
Reaction: jitterDSAvg
Threshold type: immediate
Rising (milliseconds): 5
Falling (milliseconds): 3
Threshold Count: 5
Threshold Count2: 5
Action Type: trapOnly
Reaction: PacketLossSD
Threshold type: immediate
Rising (milliseconds): 5
Threshold Falling (milliseconds): 3
Threshold Count: 5
Threshold Count2: 5
! The following command is needed for the system to generate CISCO-SYSLOG-MIB traps.
Router(config)# snmp-server enable traps syslog
The following sample system logging messages shows that IP SLAs threshold violation notifications are
generated as level 6 (informational) in the Cisco system logging process:
This following sample SNMP notification from the CISCO-SYSLOG-MIB for the same violation is a level
7 (info) notification:
Additional References
Related Documents
Standards
Standards Title
No new or modified standards are supported by this --
feature, and support for existing standards has not
been modified by features in this document.
MIBs
RFCs
RFCs Title
No specific RFCs are supported by the features in --
this document.
Technical Assistance
Description Link
The Cisco Support website provides extensive http://www.cisco.com/cisco/web/support/
online resources, including documentation and index.html
tools for troubleshooting and resolving technical
issues with Cisco products and technologies.
To receive security and technical information about
your products, you can subscribe to various
services, such as the Product Alert Tool (accessed
from Field Notices), the Cisco Technical Services
Newsletter, and Really Simple Syndication (RSS)
Feeds.
Access to most tools on the Cisco Support website
requires a Cisco.com user ID and password.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support.
To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not
required.
IP SLAs VoIP Threshold Traps 12.2(31)SB2 12.2(33)SRB1 Cisco IOS IP SLAs VoIP
12.2(33)SXH 12.3(14)T 15.0(1)S proactive threshold monitoring
capability allows you to configure
an IP SLAs operation to react to
certain measured network
conditions.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other
countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party
trademarks mentioned are the property of their respective owners. The use of the word partner does not
imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be
actual addresses and phone numbers. Any examples, command display output, network topology diagrams,
and other figures included in the document are shown for illustrative purposes only. Any use of actual IP
addresses or phone numbers in illustrative content is unintentional and coincidental.