To set the amount of time a Cisco IOS IP Service Level Agreements (SLAs) operation waits for a response from its request
packet, use the
timeout (IP SLA) command in the appropriate submode of IP SLA configuration, auto IP SLA MPLS configuration, IP SLA auto Ethernet
configuration, IP SLA monitor configuration or IP SLA template parameters configuration mode. To return to the default value,
use the
no form of this command.
timeout milliseconds
no timeout
Syntax Description
milliseconds
|
Length of time the operation waits to receive a response from its request packet, in milliseconds (ms). Range is 0 to 604800000.
We recommend that the value of the
milliseconds argument be based on the sum of both the maximum round-trip time (RTT) value for the packets and the processing time of the
IP SLAs operation.
|
Command Default
The default timeout value varies depending on the type of IP SLAs operation you are configuring.
IP SLA Configuration
DHCP configuration (config-ip-sla-dhcp)
DLSw configuration (config-ip-sla-dlsw)
DNS configuration (config-ip-sla-dns)
Ethernet echo (config-ip-sla-ethernet-echo)
Ethernet jitter (config-ip-sla-ethernet-jitter)
FTP configuration (config-ip-sla-ftp)
HTTP configuration (config-ip-sla-http)
ICMP echo configuration (config-ip-sla-echo)
ICMP jitter configuration (config-ip-sla-icmpjitter)
ICMP path echo configuration (config-ip-sla-pathEcho)
ICMP path jitter configuration (config-ip-sla-pathJitter)
Multicast UDP jitter configuration (config-ip-sla-multicast-jitter-oper)
TCP connect configuration (config-ip-sla-tcp)
UDP echo configuration (config-ip-sla-udp)
UDP jitter configuration (config-ip-sla-jitter)
VCCV configuration (config-sla-vccv)
VoIP configuration (config-ip-sla-voip)
MPLS parameters configuration (config-auto-ip-sla-mpls-params)
Ethernet parameters configuration (config-ip-sla-ethernet-params)
DHCP configuration (config-sla-monitor-dhcp)
DLSw configuration (config-sla-monitor-dlsw)
DNS configuration (config-sla-monitor-dns)
FTP configuration (config-sla-monitor-ftp)
HTTP configuration (config-sla-monitor-http)
ICMP echo configuration (config-sla-monitor-echo)
ICMP path echo configuration (config-sla-monitor-pathEcho)
ICMP path jitter configuration (config-sla-monitor-pathJitter)
TCP connect configuration (config-sla-monitor-tcp)
UDP echo configuration (config-sla-monitor-udp)
UDP jitter configuration (config-sla-monitor-jitter)
VoIP configuration (config-sla-monitor-voip)
ICMP echo configuration (config-icmp-ech-params)
ICMP jitter configuration (config-icmp-jtr-params)
TCP connect configuration (config-tcp-conn-params)
UDP echo configuration (config-udp-ech-params)
UDP jitter configuration (config-udp-jtr-params)
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SRB
|
The Ethernet echo, Ethernet jitter, and Ethernet parameters configuration modes were added.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends
on your feature set, platform, and platform hardware.
|
12.2(33)SRC
|
The VCCV configuration mode was added.
|
12.2(33)SB
|
The following configuration modes were added:
-
Ethernet echo
-
Ethernet jitter
-
Ethernet parameters
-
VCCV
|
12.4(20)T
|
The Ethernet echo, Ethernet jitter, and Ethernet parameters configuration modes were added.
|
12.2(33)SXI
|
The Ethernet echo, Ethernet jitter, and Ethernet parameters configuration modes were added.
|
15.1(1)T
|
This command was modified. The IP SLA template parameters configuration mode was added.
|
15.2(4)M
|
This command was modified. The multicast UDP jitter configuration mode was added.
|
15.3(1)S
|
This command was integrated into Cisco IOS Release 15.3(1)S.
|
Cisco IOS XE Release 3.8S
|
This command was integrated into Cisco IOS XE Release 3.8S.
|
15.1(2)SG
|
This command was integrated into Cisco IOS Release 15.1(2)SG.
|
Cisco IOS XE Release 3.4SG
|
This command was integrated into Cisco IOS XE Release 3.4SG.
|
Usage Guidelines
We recommend that the value of the
milliseconds argument be based on the sum of both the maximum round-trip time (RTT) value for the packets and the processing time of the
IP SLAs operation.
Use the
timeout (IP SLA) command to set how long the operation waits to receive a response from its request packet, and use the
frequency (IP SLA) command to set the rate at which the IP SLAs operation restarts. The value specified for the
timeout (IP SLA) command cannot be greater than the value specified for the
frequency (IP SLA) command.
Consider the following guidelines before configuring the
frequency (IP SLA),
timeout (IP SLA), and
threshold (IP SLA) commands. For the IP SLAs User Datagram Protocol (UDP) jitter operation, the following guidelines are recommended:
where N = (num-packets number-of-packets ) * (interval interpacket-interval ). If you are running Cisco IOS IP SLAs Engine 3.0, use the
num-packets command and the
interval (params) commands to configure the values that define N. Otherwise, use the
udp-jitter command to configure the
num-packets number-of-packets and
interval interpacket-interval values.
For all other IP SLAs operations, the following configuration guideline is recommended:
(frequency seconds ) > (timeout milliseconds ) > (threshold milliseconds )
The
timeout (IP SLA) command is supported in IPv4 networks. This command is also supported in IPv6 networks to configure an IP SLA operation
that supports IPv6 addresses.
IP SLAs Operation Configuration Dependence on Cisco IOS Release
The Cisco IOS command used to begin configuration for an IP SLAs operation varies depending on the Cisco IOS release you
are running (see the Command Used to Begin Configuration of an IP SLAs Operation Based on Cisco IOS Release table). Note that
if you are configuring an IP SLAs label switched path (LSP) Health Monitor operation, see the Command Used to Begin Configuration
of an IP SLAs LSP Health Monitor Operation Based on Cisco IOS Release table for information on Cisco IOS release dependencies.
You must configure the type of IP SLAs operation, such as User Datagram Protocol (UDP) jitter or Internet Control Message
Protocol (ICMP) echo, before you can configure any of the other parameters of the operation.
The configuration mode for the
timeout command varies depending on the Cisco IOS release you are running and the operation type configured.
If you are running Cisco IOS IP SLAs Engine 3.0, you must enter the
parameters command in IP SLA template configuration mode before you can use the
timeout command.
Table 5. Command Used to Begin Configuration of an IP SLAs Operation Based on Cisco IOS Release
Cisco IOS Release
|
Global Configuration Command
|
Command Mode Entered
|
12.4(4)T, 12.0(32)SY, 12.2(33)SRB, 12.2(33)SB, 12.2(33)SXI, or later releases
|
ip
sla
|
IP SLA configuration
|
12.3(14)T, 12.4, 12.4(2)T, 12.2(31)SB2, or 12.2(33)SXH
|
ip
sla
monitor
|
IP SLA monitor configuration
|
15.1(1)T
|
ip sla auto template
|
IP SLA template configuration
|
Table 6. Command Used to Begin Configuration of an IP SLAs LSP Health Monitor Operation Based on Cisco IOS Release
Cisco IOS Release
|
Global Configuration Command
|
Command Mode Entered
|
12.4(6)T, 12.0(32)SY, 12.2(31)SB2, 12.2(33)SRB, 12.2(33)SXH, or later releases
|
auto
ip
sla
mpls-lsp-monitor
|
Auto IP SLA MPLS configuration
|
Examples
In the following examples, the timeout value for an IP SLAs operation 1 is set for 2500 ms:
Examples
ip sla 1
icmp-echo 172.16.1.176
timeout 2500
!
ip sla schedule 1 start-time now
Examples
ip sla monitor 1
type echo protocol ipIcmpEcho 172.16.1.176
timeout 2500
!
ip sla monitor schedule 1 start-time now
Examples
Router(config)#ip sla auto template type ip icmp-echo 1
Router(config-tplt-icmp-ech)#parameters
Router(config-icmp-ech-params)#timeout 2500
Router(config-icmp-ech-params)#end
Router#
00:02:26: %SYS-5-CONFIG_I: Configured from console by console
Router# show
ip sla auto template type ip udp-echo
IP SLAs Auto Template: 1
Measure Type: udp-echo (control enabled)
Description:
.
.
.
Operation Parameters:
Request Data Size: 16 Verify Data: false
Timeout: 2500 Threshold: 5000
Statistics Aggregation option:
Hours of statistics kept: 2
History options:
History filter: none
Max number of history records kept: 15
Lives of history kept: 0
Statistics Distributions options:
Distributions characteristics: RTT
Distributions bucket size: 20
Max number of distributions buckets: 1
Reaction Configuration: None