OcNOS DC : Layer 3 Guide : Fundamental Layer 3 Command Reference : IP Service Level Agreements Commands
IP Service Level Agreements Commands
IP Service Level Agreements (SLAs) is a diagnostic method which generates and analyses the traffic between an OcNOS device and your network. IP SLA monitors and reports network performance data which helps you to identify the actual root cause of a problem when the performance level drops.
This chapter describes the commands used to manage the IP SLA for ICMP echo.
• ip sla
clear ip sla statistics
Use this command to clear the IP SLA statistics.
Command Syntax
clear ip sla statistics <1-65535>
Parameters
1-65535
IP SLA identifier
Default
N/A
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced in OcNOS version 5.0.
Examples
#clear ip sla statistics 1
frequency
Use this command to configure the frequency/interval to send ICMP echo packets one by one.
Use the no form of this command to remove the configured ICMP echo frequency.
Command Syntax
frequency <1-60>
no frequency
Parameters
1-60
Frequency in seconds
Default
5 seconds
Command Mode
IP SLA ICMP Echo mode (config-ip-sla-echo)
Applicability
This command was introduced in OcNOS version 5.0.
Examples
#configure terminal
(config)#ip sla 1
(config-ip-sla)#icmp-echo ipv4 10.12.28.1 source-interface xe1
(config-ip-sla-echo)#frequency 3
icmp-echo
Use this command to select and configure the ICMP echo SLA operation. ICMP echo packets are constructed in the device and sent to the destination address that you specify. These packets are transferred on a specific interface by setting the source-interface parameter.
Use the no form of this command to un-configure or remove the configured ICMP echo measurement sessions.
Command Syntax
icmp-echo (ipv4 A.B.C.D|ipv6 X:X::X:X|HOSTNAME) (source-interface IFNAME|)
no icmp-echo (ipv4 A.B.C.D | ipv6 X:X::X:X | HOSTNAME)
Parameters
A.B.C.D
IPv4 address
X:X::X:X
IPv6 address
HOSTNAME
Host name
IFNAME
Source interface name
Default
N/A
Command Mode
IP SLA mode (config-ip-sla)
Applicability
This command was introduced in OcNOS version 5.0.
Examples
#configure terminal
(config)#ip sla 1
(config-ip-sla)#icmp-echo ipv4 10.12.28.1 source-interface xe1
(config-ip-sla-echo)#
ip sla
Use this command to create an IP SLA instance. One instance maps to a single SLA operation. You can create multiple SLA operations to perform multiple similar or different SLA operations.
Use the no form of this command to remove a configured IP SLA configurations.
Command Syntax
ip sla <1-65535>
no ip sla <1-65535>
Parameters
1-65535
IP SLA identifier
Default
N/A
Command Mode
Configuration mode
Applicability
This command was introduced in OcNOS version 5.0.
Example
#configure terminal
(config)#ip sla 1
(config-ip-sla)#
ip sla schedule
Use this command to schedule an IP SLA operation by associating a time-range object with the IP SLA operation.
Use the no form of this command to stop the configured IP SLA measurement.
Command Syntax
ip sla schedule <1-65535> time-range WORD (vrf (NAME)|)
Parameters
<1-65535>
IP SLA identifier.
time-range
Time Range
TR_NAME
Time range name that you set with the time-range command.
vrf
VPN Routing/Forwarding instance
NAME
VPN Routing/Forwarding instance name. Maximum limit 32 characters
Default
N/A
Command Mode
Configuration mode
Applicability
This command was introduced in OcNOS version 5.0.
Examples
#configure terminal
(config)#ip sla schedule 1 time-range t1 vrf v1
show ip sla statistics
Use this command to display the statistics of IP SLA measurement.
Command Syntax
show ip sla statistics (1-65535) detail
Parameters
1-65535
IP SLA identifier.
Default
N/A
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced in OcNOS version 5.0.
Examples
#show ip sla statistics 1 detail
=========================================
IP SLA Statistics
=========================================
IP SLA ID : 1
Start Time : 2021 Aug 30 17:40:04
Elapsed time(milli sec) : 46015
Packets Sent : 23
Packets Received : 23
Packet Loss(%) : 0.0000
Invalid Tests : 0
Round Trip Delay(usec)
Minimum : 1000
Maximum : 1000
Average : 1000
 
Table P‑4-3 explains the output fields.
Table 4-3: show ip sla statistics fields 
Field
Description
IP SLA ID
IP SLA Identifier (1-65535)
Start Time
Measurement start time
Elapsed time(milli sec)
Time taken to complete the measurement in milliseconds
Packets Sent
Number of packet sent
Packets Received
Number of packet received
Packet Loss(%)
Packet lost in percentage
Invalid Tests
Received ICMP echo reply packets after configured threshold limit will be marked as invalid tests
Round Trip Delay(usec)
Round trip delay between ICMP echo request and ICMP echo reply: minimum, maximum and average round trip delay in microseconds
 
show ip sla summary
Use this command to display the summary of all IP SLA measurements.
Command Syntax
show ip sla summary
Parameters
None
Default
N/A
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced in OcNOS version 5.0.
Examples
#show ip sla summary
IPSLAs Latest Operation Summary
Codes: * active, ^ inactive
 
ID Type Destination Stats Return Last
(usec) Code Run
-------------------------------------------------------------------
^1 icmp-echo 20.2.2.3 0 OK 2021 Aug 23 13:53:37
 
Table P‑4-4 explains the output fields.
Table 4-4: show ip sla summary fields 
Field
Description
ID
IP SLA Identifier (1-65535)
Type
Measurement type
Destination
Destination address
Stats (usec)
Round trip time in microseconds for the measurement
Return Code
Measurement status
Last Run
Measurement last run date and time
 
show running-config ip sla
Use this command to display the IP SLA running configuration alone.
Command Syntax
show running-config ip sla
Parameters
None
Default
N/A
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced in OcNOS version 5.0.
Examples
#show running-config ip sla
ip sla 1
icmp-echo ipv4 20.2.2.3
frequency 2
threshold 2000
timeout 5000
ip sla schedule 1 time-range t1 vrf v1
threshold
Use this command to configure the threshold for every ICMP echo packet.
Use the no form of this command to remove the configured ICMP echo threshold.
Command Syntax
threshold <1000-60000>
no threshold
Parameters
1000-60000
Threshold in milliseconds.
Default
10000 milliseconds
Command Mode
IP SLA ICMP Echo mode (config-ip-sla-echo)
Applicability
This command was introduced in OcNOS version 5.0.
Examples
#configure terminal
(config)#ip sla 1
(config-ip-sla)#icmp-echo ipv4 10.12.28.1 source-interface xe1
(config-ip-sla-echo)#threshold 5000
timeout
Use this command to configure the timeout for every ICMP echo packet. Any packet arriving beyond this interval is considered to be lost.
Use the no form of this command to remove the configured ICMP echo timeout.
Command Syntax
timeout <1000-60000>
no timeout
Parameters
1000-60000
Timeout in milliseconds.
Default
10000 milliseconds
Command Mode
IP SLA ICMP Echo mode (config-ip-sla-echo)
Applicability
This command was introduced in OcNOS version 5.0.
Examples
#configure terminal
(config)#ip sla 1
(config-ip-sla)#icmp-echo ipv4 10.12.28.1 source-interface xe1
(config-ip-sla-echo)#timeout 5000