To display global information about Cisco IOS IP Service Level Agreements (SLAs), use the
showipslaapplication command in user EXEC or privileged EXEC mode.
showipslaapplication
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
Modification
12.4(4)T
This command was introduced. This command replaces the
showipslamonitorapplicationcommand.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the
showrtrapplicationcommand.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitorapplicationcommand.
12.2(33)SRD
The command output was modified to include information on IP SLAs Ethernet operation EVC support.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the
showipslamonitorapplicationcommand.
12.4(22)T
This command was modified. The command output was modified to include information on IP SLAs Event Publisher.
12.2(33)SRE
This command was modified. The command output was modified to include information on IP SLAs Ethernet operation port level support and IP SLAs Event Publisher.
12.2(58)SE
This command was modified. The command output was modified to include information about IP SLAs video operation support.
15.2(4)M
This command was modified. The command output was modified to include information about IP SLAs multicast (mcast) operation support.
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
Use the
showipslaapplicationcommand to display information such as supported operation types and supported protocols.
Examples
The following is sample output from the
showipslaapplication command:
Router# show ip sla application
IP Service Level Agreement Technologies
Version: Round Trip Time MIB 2.2.0, Infrastructure Engine-III
Supported Operation Types:
icmpEcho, path-echo, path-jitter, udpEcho, tcpConnect, http
dns, udpJitter, dhcp, ftp, VoIP, rtp, lsp Group, icmpJitter
lspPing, lspTrace, 802.1agEcho VLAN, Port
802.1agJitter VLAN, Port, pseudowirePing, udpApp, wspApp
mcast, generic
Supported Features:
IPSLAs Event Publisher
IP SLAs low memory water mark: 0
Estimated system max number of entries: 63840
Estimated number of configurable operations: 63840
Number of Entries configured : 0
Number of active Entries : 0
Number of pending Entries : 0
Number of inactive Entries : 0
Last time the operation configuration changed: *07:22:13.183 UTC Fri Feb 13 2009
The table below describes the significant fields shown in the display.
Table 1 show ip sla application Field Descriptions
Field
Description
Version
The version of the IP SLAs infrastructure supported on the router.
Supported Operation Types
The types of operations supported by the command.
Supported Features
The features supported by the command.
Related Commands
Command
Description
showipslaconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
show ip sla authentication
To display Cisco IOS IP Service Level Agreements (SLAs) authentication information, use the showipslaauthentication command in user EXEC or privileged EXEC mode.
showipslaauthentication
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.4(4)T
This command was introduced. This command replaces the showipslamonitorauthentication command.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the showrtrauthenticationcommand.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the showipslamonitorauthenticationcommand.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the showipslamonitorauthenticationcommand.
Usage Guidelines
Use the showipslaauthenticationcommand to display information such as supported operation types and supported protocols.
Examples
The following is sample output from the showipslaauthenticationcommand:
Router# show ip sla authentication
IP SLA Monitor control message uses MD5 authentication, key chain name is: ipsla
Related Commands
Command
Description
showipslaconfiguration
Displays configuration values for IP SLAs operations.
show ip sla auto discovery
To display the status of IP Service Level Agreements (SLAs) auto discovery and the configuration of auto IP SLAs endpoint lists configured to use auto discovery, use the
showipslaautodiscovery command in user EXEC or privileged EXEC mode.
showipslaautodiscovery
Syntax Description
This command has no arguments or keywords.
Command Default
Displays the configuration of IP SLAs auto discovery.
Command Modes
User EXEC (>) Privileged EXEC (#)
Command History
Release
Modification
15.1(1)T
This command was introduced.
Examples
The following is sample output from the
showipslaautodiscovery command before, and after, auto discovery was enabled. Note that no IP SLAs endpoint lists are configured yet.
Router>show ip sla auto discovery
IP SLAs auto-discovery status: Disabled
The following Endpoint-list are configured to auto-discovery:
Router>enable
Router#configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)#ip sla auto discovery
Router(config)#exit
Router#
Router# show ip sla auto discovery
IP SLAs auto-discovery status: Enabled
The following Endpoint-list are configured to auto-discovery:
The table below describes the significant fields shown in the display.
Table 2
showipslaautodiscovery Field Descriptions
Field
Description
IP SLAs auto-discovery status
Configuration of the
ipslaautodiscovery command.
Related Commands
Command
Description
ipslaautodiscovery
Enables IP SLAs auto discovery in Cisco IP SLAs Engine 3.0.
show ip sla auto endpoint-list
Note
Effective with Cisco IOS Release 15.2(3)T, the
show ip sla auto endpoint-list command is replaced with the
show ip sla endpoint-list command. See the
show ip sla endpoint-list command for more information.
To display the configuration including default values of all auto IP Service Level Agreements (SLAs) endpoint lists, all auto IP SLAs endpoint lists for a specified operation type, or a specified auto IP SLAs endpoint list, use the
showipslaautoendpoint-list command in user EXEC or privileged EXEC mode.
(Optional) Specifies that the operation type is Internet Protocol.
template-name
(Optional) Unique identifier of the endpoint list. String of 1 to 64 alphanumeric characters.
Command Default
Default display includes configuration for all auto IP SLAs endpoint lists.
Command Modes
User EXEC (>) Privileged EXEC (#)
Command History
Release
Modification
15.1(1)T
This command was introduced.
15.2(3)T
This command was replaced by the
show ip sla endpoint-list command.
Examples
The following is sample output from the
showipslaautoendpoint-list command for all configured endpoint lists. Because all of the destinations are for IP operations, the
typeip keyword is not configured.
Router# show ip sla auto endpoint-list
Endpoint-list Name: man1
Description: testing manual build
ip-address 10.1.1.1-7 port 23
ip-address 10.1.1.9,10.1.1.15,10.1.1.23 port 23
Endpoint-list Name: autolist
Description:
Auto Discover Parameters
Destination Port: 5000
Access-list: 3
Ageout: 3600 Measurement-retry: 3
0 endpoints are discovered for autolist
The table below describes the significant fields shown in the display.
Table 3
showipslaautoendpoint-list Field Descriptions
Field
Description
Destination Port
Port number of target device or Cisco IP SLAs Responder.
Access-list
Name of list of discovered endpoints.
Ageout
Length of time that operation is kept in memory, in seconds (sec).
Measurement-retry
Number of times the endpoints belonging to an auto IP SLAs destination templates are retested when an operation fails.
Related Commands
Command
Description
access-list (epl-disc)
Adds list of discovered endpoints to an auto IP SLAs endpoint list.
ageout
Adds ageout timer to auto IP SLAs scheduler or endpoint list.
ipslaautoendpoint-list
Enters IP SLA endpoint-list configuration mode and begins creating an auto IP SLAs endpoint list.
measurement-retry
Specifies the number of times an operation associated with an auto IP SLAs endpoint list is retried when a failure is detected.
show ip sla auto group
To display configuration values including all defaults for all Cisco IOS IP Service Level Agreements (SLAs) auto-measure groups or a specified group, use the
showipslaautogroup command in user EXEC or privileged EXEC mode.
showipslaautogroup
[ typeip [group-name] ]
Syntax Description
typeip
(Optional) Specifies that the operation type is Internet Protocol.
group-name
(Optional) Unique identifier of auto-measure group. String of 1 to 64 alphanumeric characters.
Command Default
Displays configuration for all IP SLAs endpoint lists.
Command Modes
User EXEC (>) Privileged EXEC (#)
Command History
Release
Modification
15.1(1)T
This command was introduced.
Usage Guidelines
This command displays the configuration of an IP SLAs auto-measure group including all default values and information about operations created for each destination in the specified endpoint-list for this group.
Examples
The following is sample output from the
showipslaautogroup command for an IP SLAs auto-measure group (test) and the created operations within the group:
Router# show ip sla auto grou
p test
Group Name: test
Description:
Activation Trigger: Immediate
Destination: testeplist
Schedule: testsched
Measure Template: testtplt(icmp-jitter)
IP SLAs auto-generated operations of group test
sno oper-id type dest-ip-addr/port
1 299389922 icmp-jitter 20.1.1.32/NA
The table below describes the significant fields shown in the display.
Table 4
showipslaautogroup Field Descriptions
Field
Description
Activation Trigger
Start time of operation.
Destination
Name of auto IP SLAs endpoint list referenced by the auto-measure group.
Schedule
Name of auto IP SLAs scheduler referenced by the auto-measure group.
Measure Template
Name of auto IP SLAs template referenced by the auto-measure group.
sno
Serial number of IP SLAs operation created for specified endpoint.
oper-id
Entry number of IP SLAs operation created for specified endpoint.
type
Type of IP SLAs operation created for specified endpoint.
dest-ip-addr/port
IP address and port of destination for operation in current display.
Related Commands
Command
Description
ipslaautogroup
Begins configuration for an IP SLAs auto-measure group and enters IP SLA auto-measure group configuration mode.
show ip sla auto schedule
To display configuration values including all defaults for all auto IP Service Level Agreements (SLAs) schedulers or a specified scheduler, use the
showipslaautotemplate command in user EXEC or privileged EXEC mode.
showipslaautoschedule [schedule-id]
Syntax Description
schedule-id
(Optional) Unique identifier for IP SLAs schedule. String of 1 to 64 alphanumeric characters.
Command Default
The default output includes the configuration for all auto IP SLAs schedulers.
Command Modes
User EXEC (>) Privileged EXEC (#)
Command History
Release
Modification
15.1(1)T
This command was introduced.
Examples
The following is sample output from the
showipslaautoschedulecommand when you specify an auto IP SLAs scheduler by name (basic-default):
Router# show ip sla auto schedule basic-default
Group sched-id: basic-default
Probe Interval (ms): 1000
Group operation frequency (sec): 60
Status of entry (SNMP RowStatus): Active
Next Scheduled Start Time: Pending trigger
Life (sec): 3600
Entry Ageout (sec): never
The table below describes the significant fields shown in the display.
Table 5
showipslaautoschedule Field Descriptions
Field
Description
Probe Interval (ms)
Length of time, in milliseconds (ms), between operations that share the same auto IP SLAs scheduler.
Group operation frequency (sec)
Frequency at which each operation repeats, in seconds (sec).
Next Scheduled Start Time
Start time of operation. “Pending trigger” indicates that neither a specific start time nor a reaction trigger is configured.
Life (sec)
Length of time that the operation runs, in seconds (sec).
Entry Ageout (sec)
Length of time that operation is kept in memory, in seconds (sec).
Related Commands
Command
Description
ageout (IP SLA)
Adds ageout timer to auto IP SLAs scheduler or endpoint list.
frequency
Specifies how often an operation in an IP SLAs auto-measure group will repeat once it is started.
ipslaautoschedule
Enters IP SLA auto-measure schedule configuration mode and begins creating an auto IP SLAs scheduler.
life
Specifies lifetime characteristic in an auto IP SLAs scheduler.
probe-interval
Specifies interval between operations for staggering operations that share the same auto IP SLAs scheduler.
react
Configures reaction and proactive threshold monitoring parameters in an auto IP SLAs operation template.
start-time
Specifies start time for an IP SLAs auto-measure group.
show ip sla auto summary-statistics
To display the current operational status and statistics for a Cisco IOS IP Service Level Agreements (SLAs) auto-measure group or for a specified destination of a group, use the
showipslaautosummary-statistics command in user EXEC or privileged EXEC mode.
Unique identifier for IP SLAs auto-measure group. String of 1 to 64 alphanumeric characters.
ip-addressip-address
(Optional) Specifies IPv4 address of destination routing device or destination Cisco IP SLAs Responder.
portport
(Optional) Specifies port number of destination routing device or destination Cisco IP SLAs Responder. Range is from 1 to 65535.
Command Default
The default output includes statistics for all endpoints of the operation in an IP SLA auto-measure group.
Command Modes
User EXEC (>) Privileged EXEC (#)
Command History
Release
Modification
15.1(1)T
This command was introduced.
Examples
The following is sample output from the
showipslaautosummary-statistics for an IP SLAs auto-measure group (test) that started immediately upon configuration. The partial output from the
showrunning-config and
showipslagroup command are included to illustrate the relationship between the group, operation, and scheduler. Notice that the command to start the operations was configured after the auto IP SLAs scheduler (testsched) was added to the group configuration.
Router# show running-config
.
.
.
ip sla auto template type ip icmp-jitter test
ip sla auto endpoint-list type ip test
ip-address 10.1.1.32 port 2222
ip sla auto group type ip test
schedule testsched
template icmp-jitter testtplt
destination testeplist
ip sla auto schedule testsched <<=====
start-time now
.
.
.
Router# show ip sla auto summary-statistics group type ip icmp-jitter test
IP SLAs Auto Group Summary Statistics
Legend -
sno: Serial Number in current display
oper-id: Entry Number of IPSLAs operation
type: Type of IPSLAs operation
n-rtts: Number of successful round trips in current hour
of operation
rtt (min/av/max): The min, max and avg values of latency in
current hour of operation
avg-jitter(DS/SD): average jitter value in destination to
source and source to destination direction
pak-loss: accumulated sum of source to destination and
destination to source packet loss in current hour
Summary Statistics:
Auto Group Name: test
Template: testtplt
Number of Operations: 1
sno oper-id type n-rtts rtt avg-jitter packet
(min/avg/max) (DS/SD) loss
1 299389922 icmp-jitter 10 8/16/24 ms 9/0 ms 0
Router# show ip sla auto grou
p
Group Name: test
Description:
Activation Trigger: Immediate
Destination: testeplist
Schedule: testsched
Measure Template: testtplt(icmp-jitter)
IP SLAs auto-generated operations of group test
sno oper-id type dest-ip-addr/port
1 299389922 icmp-jitter 10.1.1.32/NA
Related Commands
Command
Description
ipslaautogroup
Begins configuration for an IP SLAs auto-measure group and enters IP SLA auto-measure group configuration mode.
ipslaautoendpoint-list
Begins configuration for an auto IP SLAs endpoint-list and enters IP SLA endpoint-list configuration mode.
ipslaautoschedule
Begins configuration for an auto IP SLAs scheduler and enters IP SLA auto-measure schedule configuration mode.
ipslaautotemplate
Begins configuration for an auto IP SLAs operation template and enters IP SLA template configuration mode.
show ip sla auto template
To display configuration values including all defaults for all Cisco IOS IP Service Level Agreements (SLAs) operation templates, all operation templates for a specified type of operation, or a specified operation template, use the
showipslaautotemplate command in user EXEC or privileged EXEC mode.
Unique identifier of an IP SLAs operation template. String of 1 to 64 alphanumeric characters.
Command Default
Default output includes configuration for all auto IP SLAs operation templates.
Command Modes
User EXEC (>) Privileged EXEC (#)
Command History
Release
Modification
15.1(1)T
This command was introduced.
Examples
The following is sample shows output for the
showipslaautotemplatecommand when you specify a template by name (basic_icmp_jtr):
Router# show ip sla auto template type ip icmp-jitter basic_icmp_jtr
IP SLAs Auto Template: basic_icmp_jtr
Measure Type: icmp-jitter
Description: default oper temp for icmp jitter
IP options:
Source IP: 0.0.0.0
VRF: TOS: 0x0
Operation Parameters:
Number of Packets: 10 Inter packet interval: 20
Timeout: 5000 Threshold: 5000
Statistics Aggregation option:
Hours of statistics kept: 2
Statistics Distributions options:
Distributions characteristics: RTT
Distributions bucket size: 20
Max number of distributions buckets: 1
Reaction Configuration: None
The following is sample output for the
showipslaautotemplatecommand when you use the
typeipoperation keyword and argument combination to specifiy a certain type of operation:
Router# show ip sla auto template type ip udp-jitter
IP SLAs Auto Template: basic_udp_jitter
Measure Type: udp-jitter (control enabled)
Description: default oper temp for udp jitter
IP options:
Source IP: 0.0.0.0 Source Port: 0
VRF: TOS: 0x0
Operation Parameters:
Request Data Size: 32 Verify Data: false
Number of Packets: 10 Inter packet interval: 20
Timeout: 5000 Threshold: 5000
Granularity: msec Operation packet priority: normal
Statistics Aggregation option:
Hours of statistics kept: 2
Statistics Distributions options:
Distributions characteristics: RTT
Distributions bucket size: 20
Max number of distributions buckets: 1
Reaction Configuration: None
IP SLAs Auto Template: voip_g711alaw
Measure Type: udp-jitter (control enabled)
Description: oper template for voip udp
IP options:
Source IP: 0.0.0.0 Source Port: 0
VRF: TOS: 0x0
Operation Parameters:
Verify Data: false
Timeout: 5000 Threshold: 5000
Codec: g711alaw Number of packets: 1000
Interval: 20 Payload size: 16 Advantage factor: 0
Granularity: msec Operation packet priority: normal
Statistics Aggregation option:
Hours of statistics kept: 2
Statistics Distributions options:
Distributions characteristics: RTT
Distributions bucket size: 20
Max number of distributions buckets: 1
Reaction Configuration: None
The following is sample output for the
showipslaautotemplatecommand for all configured IP SLAs operation templates. Because all of the templates are for IP operations, the
typeip keyword is not configured.
Router# show ip sla auto template
IP SLAs Auto Template: basic_icmp_echo
Measure Type: icmp-echo
Description:
IP options:
Source IP: 0.0.0.0
VRF: TOS: 0x0
Operation Parameters:
Request Data Size: 28 Verify Data: false
Timeout: 5000 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
IP SLAs Auto Template: basic_icmp_jtr
Measure Type: icmp-jitter
Description: default oper temp for icmp jitter
IP options:
Source IP: 0.0.0.0
VRF: TOS: 0x0
Operation Parameters:
Number of Packets: 10 Inter packet interval: 20
Timeout: 5000 Threshold: 5000
Statistics Aggregation option:
Hours of statistics kept: 2
Statistics Distributions options:
Distributions characteristics: RTT
Distributions bucket size: 20
Max number of distributions buckets: 1
Reaction Configuration: None
IP SLAs Auto Template: basic_udp_jitter
Measure Type: udp-jitter (control enabled)
Description: default oper temp for udp jitter
IP options:
Source IP: 0.0.0.0 Source Port: 0
VRF: TOS: 0x0
Operation Parameters:
Request Data Size: 32 Verify Data: false
Number of Packets: 10 Inter packet interval: 20
Timeout: 5000 Threshold: 5000
Granularity: msec Operation packet priority: normal
Statistics Aggregation option:
Hours of statistics kept: 2
Statistics Distributions options:
Distributions characteristics: RTT
Distributions bucket size: 20
Max number of distributions buckets: 1
Reaction Configuration: None
IP SLAs Auto Template: voip_g711alaw
Measure Type: udp-jitter (control enabled)
Description: oper template for voip udp
IP options:
Source IP: 0.0.0.0 Source Port: 0
VRF: TOS: 0x0
Operation Parameters:
Verify Data: false
Timeout: 5000 Threshold: 5000
Codec: g711alaw Number of packets: 1000
Interval: 20 Payload size: 16 Advantage factor: 0
Granularity: msec Operation packet priority: normal
Statistics Aggregation option:
Hours of statistics kept: 2
Statistics Distributions options:
Distributions characteristics: RTT
Distributions bucket size: 20
Max number of distributions buckets: 1
Reaction Configuration: None
IP SLAs Auto Template: basic_tcp_conn
Measure Type: tcp-connect (control enabled)
Description:
IP options:
Source IP: 0.0.0.0 Source Port: 0
VRF: TOS: 0x0
Operation Parameters:
Timeout: 5000 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
The table below describes the significant fields shown in the display.
Table 6
showipslaautotemplate Field Descriptions
Field
Description
IP SLAs Auto Template
Name of auto IP SLAs operation template in current display.
Measure Type
Type of IP operation defined for auto IP SLAs operation template in current display, including status of protocol control.
Related Commands
Command
Description
ipslaautotemplate
Begins configuring an auto IP SLAs operation template and enters IP SLA template configuration mode.
show ip sla configuration
To display configuration values including all default values for all Cisco IOS IP Service Level Agreements (SLAs) operations or a specified operation, use the
showipslaconfiguration command in user EXEC or privileged EXEC mode.
showipslaconfigurationoperation
Syntax Description
operation
(Optional) Number of IP SLAs operations for which the details are displayed.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
Modification
12.4(4)T
This command was introduced. This command replaces the
showipslamonitorconfiguration command.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the
showrtrconfigurationcommand.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitorconfiguration command.
12.2(33)SRD
This command was modified. The command output has been modified to include information on IP SLAs Ethernet operation EVC support.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the
showipslamonitorconfiguration command.
12.2(33)SRE
This command was modified. The command output has been modified to include information on IP SLAs Ethernet operation port level support.
12.2(58)SE
This command was modified. The command output has been modified to include information about IP SLAs video operations.
15.1(1)SG
This command was integrated into Cisco IOS Release 15.1(1)SG.
Cisco IOS XE Release 3.3SG
This command was integrated into Cisco IOS XE Release 3.3SG.
15.2(3)T
This command was modified. The command output was modified to display IPv4 and IPv6 addresses for Domain Name System (DNS), FTP, HTTP, Path Echo, and Path Jitter IP SLAs operations.
Cisco IOS XE 3.7S
This command was integrated into Cisco IOS XE Release 3.7S.
15.2(4)M
This command was modified. The command output was modified to display multicast UDP jitter operations.
15.3(1)S
This command was integrated into Cisco IOS Release 15.3(1)S.
15.3(2)T
This command was modified. The output was modified to display the percentile configuration.
15.3(2)S
This command was modified. The output was modified to display the configuration for a service performance operation.
This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
15.3(3)M
This command was modified. The output was modified to display the response data size for UDP jitter operations in IPv4 and IPv6 networks.
Usage Guidelines
The IPv4 and IPv6 support for different IP SLAs operations are
described below:
IP SLAs Internet Control Message Protocol (ICMP) echo operations support both IPv4 and IPv6 addresses.
IP SLAs UDP echo operations support both IPv4 and IPv6 addresses.
IP SLAs TCP connect operations support both IPv4 and IPv6 addresses.
IP SLAs UDP jitter connect operations support both IPv4 and IPv6 addresses.
IP SLAs video operations support only IPv4 addresses.
Examples
This section shows sample output from the
showipslaconfiguration command for different IP SLAs operations in IPv4 and IPv6 networks.
The following sample output from the
showipslaconfiguration command displays that the specified operation is an ICMP echo operation in an IPv4 network:
Device# show ip sla configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: echo
Target address/Source address: 192.0.2.10/192.0.2.9
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Vrf Name:
Request size (ARR data portion): 28
Verify data: No
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
Enhanced History:
The following sample output from the
showipslaconfiguration command displays that the specified operation is an ICMP echo operation in an IPv6 network:
Device# show ip sla configuration 1
IP SLAs, Infrastructure Engine-II.
Entry number: 1
Owner:
Tag:
Type of operation to perform: echo
Target address/Source address: 2001:DB8:100::1/2001:DB8:200::FFFE
Traffic-Class parameter: 0x80
Flow-Label parameter: 0x1B669
Request size (ARR data portion): 28
Operation timeout (milliseconds): 5000
Verify data: No
Vrf Name:
Schedule:
Operation frequency (seconds): 60
Next Scheduled Start Time: Pending trigger
Group Scheduled : FALSE
Randomly Scheduled : FALSE
Life (seconds): 3600
Entry Ageout (seconds): never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): notInService
Threshold (milliseconds): 5000
The following sample output from the
showipslaconfiguration command displays that the specified operation is an HTTP operation:
Device# show ip sla configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: http
Target address/Source address: 192.0.2.100/192.0.2.98
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
HTTP Operation: get
HTTP Server Version: 1.0
URL: http://www.cisco.com
Proxy:
Raw String(s):
Cache Control: enable
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
The following sample output from the
showipslaconfiguration command displays that the specified operation is an ICMP path jitter operation:
Device# show ip sla configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: pathJitter
Target address/Source address: 192.0.2.50/192.0.2.34
Packet Interval/Number of Packets: 20 ms/10
Target Only: Disabled
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Loose Source Routing: Disabled
LSR Path:
Vrf Name:
Request size (ARR data portion): 28
Verify data: No
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
The following sample output from the
showipslaconfiguration command displays that the specified operation is an ICMP path echo operation:
Device# show ip sla configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: pathEcho
Target address/Source address: 192.0.2.20/192.0.2.11
Packet Interval/Number of Packets: 20 ms/10
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Loose Source Routing: Disabled
Vrf Name:
LSR Path:
Request size (ARR data portion): 28
Verify data: No
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic paths kept: 5
Number of statistic hops kept: 16
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
The following sample output from the
showipslaconfiguration command displays that the specified operation is a Domain Name System (DNS) operation:
Device# show ip sla configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: dns
Target Address/Source address: 192.0.2.3/192.0.2.2
Target Port/Source Port: 1111/0
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
The following sample output from the
showipslaconfiguration command displays that the specified operation is a UDP echo operation in an IPv4 network:
Device# show ip sla configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: udpEcho
Target address/Source address: 192.0.2.5/192.0.2.4
Target Port/Source Port: 1111/0
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Data Pattern:
Vrf Name:
Request size (ARR data portion): 28
Verify data: No
Control Packets: enabled
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
Enhanced History:
The following sample output from the
showipslaconfiguration command displays that the specified operation is a UDP echo operation in an IPv6 network:
Device# show ip sla configuration 1
IP SLAs, Infrastructure Engine-II.
Entry number: 1
Owner:
Tag:
Type of operation to perform: udp-echo
Target address/Source address: 2001:DB8:100::1/2001:0DB8:200::FFFE
Target port/Source port: 3/7
Traffic-Class parameter: 0x80
Flow-Label parameter: 0x1B669
Request size (ARR data portion): 16
Operation timeout (milliseconds): 5000
Verify data: No
Data pattern:
Vrf Name:
Control Packets: enabled
Schedule:
Operation frequency (seconds): 60
Next Scheduled Start Time: Pending trigger
Group Scheduled : FALSE
Randomly Scheduled : FALSE
Life (seconds): 3600
Entry Ageout (seconds): never
The following sample output from the
showipslaconfiguration command displays that the specified operation is a TCP connect operation in an IPv4 network:
Device# show ip sla configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: tcpConnect
Target Address/Source address: 192.0.2.10/192.0.2.9
Target Port/Source Port: 1111/0
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Control Packets: enabled
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
Enhanced History:
The following sample output from the
showipslaconfiguration command displays that the specified operation is a TCP connect operation in an IPv6 network:
Device# show ip sla configuration 1
IP SLAs, Infrastructure Engine-II.
Entry number: 1
Owner:
Tag:
Type of operation to perform: tcp-connect
Target address/Source address: 2001:DB8:100::1/2001:0DB8:200::FFFE
Target port/Source port: 3/7
Traffic-Class parameter: 0x80
Flow-Label parameter: 0x1B669
Operation timeout (milliseconds): 60000
Control Packets: enabled
Schedule:
Operation frequency (seconds): 60
Next Scheduled Start Time: Pending trigger
Group Scheduled : FALSE
Randomly Scheduled : FALSE
Life (seconds): 3600
Entry Ageout (seconds): never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): notInService
Threshold (milliseconds): 5000
Distribution Statistics:
The following sample output from the
showipslaconfiguration command displays that the specified operation is a Dynamic Host Configuration Protocol (DHCP) operation:
Device# show ip sla configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: dhcp
Target Address/Source address: 192.0.2.18/192.0.2.12
Operation timeout (milliseconds): 5000
Dhcp option:
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
The following sample output from the
showipslaconfiguration command displays that the specified operation is an FTP operation:
Device# show ip sla configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: ftp
Source address: 0.0.0.0
FTP URL: ftp://ipsla:ipsla@192.0.2.109/test.txt
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
The following sample output from the
showipslaconfiguration command displays that the specified operation is a UDP jitter operation in an IPv4 network:
Device# show ip sla configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: jitter
Target Address/Source address: 192.0.2.33/192.0.2.20
Target Port/Source Port: 1111/0
Packet Interval/Number of Packets: 20 ms/10
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Vrf Name:
Request size (ARR data portion): 28
Response size (ARR data portion): 100
Verify data: No
Control Packets: enabled
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Enhanced History:
The following sample output from the
showipslaconfiguration command displays that the specified operation is a UDP jitter operation in an IPv6 network:
Device# show ip sla configuration 1
IP SLAs, Infrastructure Engine-II.
Entry number: 1
Owner:
Tag:
Type of operation to perform: udp-jitter
Target address/Source address: 2001:DB8:100::1/2001:0DB8:200::FFFE
Target port/Source port: 3/7
Traffic-Class parameter: 0x0
Flow-Label parameter: 0x0
Request size (ARR data portion): 32
Response size (ARR data portion): 100
Operation timeout (milliseconds): 5000
Packet Interval (milliseconds)/Number of packets: 30/15
Verify data: No
Vrf Name:
Control Packets: enabled
Schedule:
Operation frequency (seconds): 60
Next Scheduled Start Time: Pending trigger
Group Scheduled : FALSE
Randomly Scheduled : FALSE
Life (seconds): 3600
Entry Ageout (seconds): never
The following sample output from the
showipslaconfiguration command displays that the specified operation is a multicast UDP jitter operation. The output includes the list of responders associated with the multicast UDP jitter operation, extracted from the endpoint list for this operation. Each multicast responder has a corresponding operation ID (oper-id) generated for the responder by the multicast operation.
Device# show ip sla config 10
IP SLAs Infrastructure Engine-III
Entry number: 10
Owner:
Tag:
Operation timeout (milliseconds): 5000
Type of operation to perform: udp-jitter
Target address/Source address: 192.0.2.2/3000 !<---multicast address
Target port/Source port: 2460/0
Type Of Service parameter: 0x0
Request size (ARR data portion): 32
Packet Interval (milliseconds)/Number of packets: 20/10
Verify data: No
Vrf Name:
Control Packets: enabled
Schedule:
Operation frequency (seconds): 60 (not considered if randomly scheduled)
Next Scheduled Start Time: Pending trigger
Group Scheduled : FALSE
Randomly Scheduled : FALSE
Life (seconds): 3600
Entry Ageout (seconds): never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): notInService
Threshold (milliseconds): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 1
Statistic distribution interval (milliseconds): 20
Enhanced History:
sno oper-id dest-ip-addr !<---responders in endpoint list
1 728338 192.0.2.4
2 728339 192.0.2.5
3 2138021658 198.51.100.3
The table below describes the significant fields shown in the display.
Table 7 show ip sla configuration Field Descriptions
Field
Description
sno
Serial Number
oper-id
Operation ID
dest-ip-addr
IP address of the destination
The following sample output from the
showipslaconfiguration command displays that the specified operation is a video operation:
Device# show ip sla configuration 600
IP SLAs Infrastructure Engine-III
Entry number: 600
Owner:
Tag:
Operation timeout (milliseconds): 5000
Type of operation to perform: video
Video profile name: TELEPRESENCE
Target address/Source address: 192.0.2.9/192.0.2.5
Target port/Source port: 1/1
Vrf Name:
Control Packets: enabled
Schedule:
Operation frequency (seconds): 60 (not considered if randomly scheduled)
Next Scheduled Start Time: Pending trigger
Group Scheduled : FALSE
Randomly Scheduled : FALSE
Life (seconds): 3600
Entry Ageout (seconds): never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): notInService
Threshold (milliseconds): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 1
Statistic distribution interval (milliseconds): 20
Enhanced History:
IP SLAs Infrastructure Engine-III
Entry number: 1
Service Performance Operation
Type: ethernet
Destination
MAC Address: 4055.398d.8bd2
VLAN:
Interface: GigabitEthernet0/4
Service Instance: 10
EVC Name:
Duration Time: 20
Interval Buckets: 5
Signature:
05060708
Description: this is with all operation modes
Measurement Type:
throughput, loss
Direction: internal
Profile Traffic:
Direction: internal
CIR: 0
EIR: 0
CBS: 0
EBS: 0
Burst Size: 3
Burst Interval: 20
Rate Step (kbps): 1000 2000
Profile Packet:
Inner COS: 6
Outer COS: 6
Inner VLAN: 100
Outer VLAN: 100
Source MAC Address: 4055.398d.8d4c
Packet Size: 512
Schedule:
Operation frequency (seconds): 64 (not considered if randomly scheduled)
Next Scheduled Start Time: Start Time already passed
Group Scheduled : FALSE
Randomly Scheduled : FALSE
Life (seconds): Forever
Entry Ageout (seconds): never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Related Commands
Command
Description
ipsla
Begins configuration for an IP SLAs operation and enters IP SLA configuration mode.
show ip sla endpoint-list
To display the configuration including default values of all IP Service Level Agreements (SLAs) endpoint lists, all P SLAs endpoint lists for a specified operation type, or a specified IP SLAs endpoint list, use the
showipslaendpoint-list command in user EXEC or privileged EXEC mode.
showipendpoint-list
[ type
{ ip | ipv6 }
[template-name] ]
Syntax Description
typeip
(Optional) Specifies that the operation type is IPv4.
typeipv6
(Optional) Specifies that the operation type is IPv6.
template-name
(Optional) Unique identifier of the endpoint list. String of 1 to 64 alphanumeric characters.
Command Default
Default display includes configuration for all IP SLAs endpoint lists.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
Modification
15.2(3)T
This command was introduced. This command replaced the
show ip sla auto endpoint-list command.
15.2(4)M
This command was modified. The command output has been modified to display multicast UDP jitter operations.
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.
Examples
The following is sample output from the
showipslaendpoint-list command for all configured endpoint lists. Because all of the destinations are for IP operations, the
typeip keyword is not configured.
Router# show ip sla endpoint-list
Endpoint-list Name: man1
Description: testing manual build
ip-address 10.1.1.1-7 port 23
ip-address 10.1.1.9,10.1.1.15,10.1.1.23 port 23
Endpoint-list Name: autolist
Description:
Auto Discover Parameters
Destination Port: 5000
Access-list: 3
Ageout: 3600 Measurement-retry: 3
0 endpoints are discovered for autolist
The following sample output displays a list of unicast IP addresses that are part of an endpoint list for a multicast UDP jitter operation. Because this endpoint list is for a multicast UDP jitter operation, the port configuration is ignored by the operation.
Router# show ip sla auto endpoint-list multicast
Endpoint-list Name: multicast
Description:
ip-address 1.1.1.1 port 1111
ip-address 2.2.2.2 port 2222
ip-address 3.3.3.3 port 3333
The table below describes the significant fields shown in the display.
Table 8
showipslaendpoint-list Field Descriptions
Field
Description
Destination Port
Port number of target device or Cisco IP SLAs Responder.
Access-list
Name of list of discovered endpoints.
Ageout
Length of time that operation is kept in memory, in seconds (sec).
Measurement-retry
Number of times the endpoints belonging to an auto IP SLAs destination templates are retested when an operation fails.
Related Commands
Command
Description
access-list (epl-disc)
Adds list of discovered endpoints to an auto IP SLAs endpoint list.
ageout
Adds ageout timer to auto IP SLAs scheduler or endpoint list.
ipslaendpoint-list
Enters IP SLA endpoint-list configuration mode and begins creating an IP SLAs endpoint list.
measurement-retry
Specifies the number of times an operation associated with an auto IP SLAs endpoint list is retried when a failure is detected.
show ip sla enhanced-history collection-statistics
To display enhanced history statistics for all collected history buckets for the specified Cisco IOS IP Service Level Agreements (SLAs) operation, use the
showipslaenhanced-historycollection-statistics command in user EXEC or privileged EXEC mode.
(Optional) Number of the operation for which enhanced history statistics is displayed.
intervalseconds
(Optional) Displays enhanced history distribution statistics for only the specified aggregation interval.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.4(4)T
This command was introduced. This command replaces the
showipslamonitorenhanced-historycollection-statistics command.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the
showrtrenhanced-historycollection-statisticscommand.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitorenhanced-historycollection-statisticscommand.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the
showipslamonitorenhanced-historycollection-statisticscommand.
Usage Guidelines
This command displays data for each bucket of enhanced history data. Data is shown individually (one after the other).
The number of buckets and the collection interval is set using thehistoryenhanced command.
You can also use the following commands to display additional statistics or history information, or to view the status of the operation:
showipslaenhanced-historydistribution-statistics
showipslastatistics
showipslastatisticsaggregated
Tip
If the letter n appears in your output, or not all fields are displayed, you should increase the screen width for your command line interface display (for example, using the
width line configuration command or the
terminalwidth EXEC mode command).
Examples
The following example shows sample output for the
showipslaenhanced-historycollection-statistics command. The output of this command will vary depending on the type of IP SLAs operation.
Router# show ip sla enhanced-history collection-statistics 1
Entry number: 1
Aggregation Interval: 900
Bucket Index: 1
Aggregation start time 00:15:00.003 UTC Thur May 1 2003
Target Address:
Number of failed operations due to a Disconnect: 0
Number of failed operations due to a Timeout: 0
Number of failed operations due to a Busy: 0
Number of failed operations due to a No Connection: 0
Number of failed operations due to an Internal Error: 0
Number of failed operations due to a Sequence Error: 0
Number of failed operations due to a Verify Error: 0
.
.
.
The table below describes the significant fields shown in the display.
Table 9 show ip sla enhanced-history collection-statistics Field Descriptions
Field
Description
Aggregation Interval
The number of seconds the operation runs for each enhanced history bucket. For example, a value of 900 indicates that statistics were gathered for 15 minutes before the next bucket was created.
Bucket Index
The number identifying the collection bucket. The number of buckets is set using the
historyenhancedIP SLA configuration command.
Related Commands
Command
Description
ipsla
Allows configuration of IP SLA operations by entering IP SLA configuration mode for the specified operation number.
showipslaenhanced-historydistribution-statistics
Displays enhanced history distribution statistics for IP SLAs operations in tabular format.
showipslastatistics
Displays the current operational status and statistics of all IP SLAs operations or a specified operation.
showipslastatisticsaggregated
Displays the aggregated statistical errors and distribution information for all IP SLAs operations or a specified operation.
show ip sla enhanced-history distribution-statistics
To display enhanced history distribution statistics for Cisco IOS IP Service Level Agreements (SLAs) operations in tabular format, use the
showipslaenhanced-historydistribution-statistics command in user EXEC or privileged EXEC mode.
(Optional) Number of the operation for which enhanced history statistics is displayed.
intervalseconds
(Optional) Displays enhanced history distribution statistics for only the specified aggregation interval for only the specified operation.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.4(4)T
This command was introduced. This command replaces the
showipslamonitorenhanced-historydistribution-statistics command.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the
showrtrenhanced-historydistribution-statisticscommand.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitorenhanced-historydistribution-statisticscommand.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the
showipslamonitorenhanced-historydistribution-statisticscommand.
Usage Guidelines
The distribution statistics consist of the following:
The sum of completion times (used to calculate the mean)
The sum of the completion times squared (used to calculate standard deviation)
The maximum and minimum completion times
The number of completed attempts
You can also use the following commands to display additional statistics or history information, or to view the status of the operation:
showipslaenhanced-historycollection-statistics
showipslastatistics
showipslastatisticsaggregated
Tip
If the letter n appears in your output, or not all fields are displayed, you should increase the screen width for your command line interface display (for example, using the
width line configuration command or the
terminalwidth EXEC mode command).
Examples
The following is sample output from the
showipslaenhanced-historydistribution-statistics command. The fields are defined at the beginning of the output for the command. RTT means round-trip time.
Router# show ip sla enhanced-history distribution-statistics 3
Point by point Enhanced History
Entry = Entry Number
Int = Aggregation Interval (seconds)
BucI = Bucket Index
StartT = Aggregation Start Time
Pth = Path index
Hop = Hop in path index
Comps = Operations completed
OvrTh = Operations completed over thresholds
SumCmp = Sum of RTT (milliseconds)
SumCmp2L = Sum of RTT squared low 32 bits (milliseconds)
SumCmp2H = Sum of RTT squared high 32 bits (milliseconds)
TMax = RTT maximum (milliseconds)
TMin = RTT minimum (milliseconds)
Entry Int BucI StartT Pth Hop Comps OvrTh SumCmp SumCmp2L SumCmp2H TMax TMin
3 900 1 257850000 1 1 3 0 43 617 0 15 14
3 900 2 258750002 1 1 3 0 45 677 0 16 14
3 900 3 259650000 1 1 3 0 44 646 0 15 14
3 900 4 260550002 1 1 3 0 42 594 0 15 12
3 900 5 261450003 1 1 3 0 42 590 0 15 13
3 900 6 262350001 1 1 3 0 46 706 0 16 15
3 900 7 263250003 1 1 3 0 46 708 0 16 14
.
.
.
The time elapsed between BucketIndex 1 (started at 257,850,000) and BucketIndex 2 (started at 258,750,002) in this example is 900,002 milliseconds, or 900 seconds.
The table below describes the significant fields shown in the display.
Table 10 show ip sla enhanced-history distribution-statistics Field Descriptions
Field
Description
Entry
The operation ID number you specified for the IP SLAs operation.
Int
Aggregation interval--The configured statistical distribution buckets interval, in seconds. For example, a value of 900 for Int means that statistics are gathered for 900 seconds per bucket.
BucI
Bucket index number--A number uniquely identifying the statistical distribution (aggregation) bucket.
The number of history buckets to be kept is configured using the
historybuckets-kept command.
A bucket will gather statistics for the specified interval of time (aggregation interval), after which a new statistics bucket is created.
If a number-of-buckets-kept value is configured, the interval for the last bucket is infinity (until the end of the operation).
Buckets are not applicable to HTTP and UDP jitter monitoring operations.
This field is equivalent to the rttMonStatsCaptureDistIndex object in the Cisco RTTMON MIB.
StartT
Aggregation start time--Start time for the aggregation interval (per Bucket Index).
Shows the start time as the number of milliseconds since the router started; in other words, the time stamp is the number of milliseconds since the last system bootup.
Pth
Path index number--An identifier for a set of different paths to the target destination that have been discovered. For example, if the first operation iteration finds the path h1, h2, h3, h4, then this path is labeled as 1. If, on a later iteration, a new path is discovered, (such as h1, h2, h5, h6, h4) then this new path will be identified as 2, and so on.
Data collection per path is available only for ICMP path echo operations (“pathEcho probes”). For all other operations, a value of 1 will always appear.
Data collection per path is configured using the
paths-of-statistics-keptnumber command when configuring the operation.
Hop
Hop Index Number--Statistics data per hop. A hop is data transmission between two points in a path (for example, from device h2 to device h3).
Data collection per hop is available only for ICMP path echo operations (“pathEcho probes”). For all other operations, a value of “1” will always appear.
Data collection per hop is configured using the
hops-of-statistics-keptnumber command when configuring the operation.
This field is equivalent to the rrttMonStatsCaptureHopIndex object in the Cisco RTTMON MIB.
Comps
Completions--The number of round-trip time operations that have completed without an error and without timing out, per bucket index.
This object has the special behavior as defined by the ROLLOVER NOTE in the DESCRIPTION of the Cisco Rttmon MIB object.
SumCmp
Sum of completed operation times (1)--The total of all round-trip time values for all successful operations in the row, in milliseconds.
SumCmp2L
Sum of the squares of completed operation times (2), Low-Order--The sum of the square roots of round-trip times for operations that were successfully measured, in milliseconds; displays the low-order 32 bits of the value only.
32 low-order bits and 32 high-order bits are ordered in unsigned 64-bit integers (Int64) as follows:
-------------------------------------------------
| High-order 32 bits | Low-order 32 bits |
-------------------------------------------------
The “SumCmp2” values are split into “high-order” and “low-order” numbers because of limitations of Simple Network Management Protocol (SNMP). The maximum value allowed for an SNMP object is 4,294,967,295 (the Gauge32 limit).
If the sum of the square roots for your operation exceeds this value, then the “high-order” value will be utilized. (For example, the number 4,294,967,296 would have all low-order bits as 0, and the right-most high-order bit would be 1).
The low-order value (SumCmp2L) appears first in the output because in most cases, the value will be less than 4,294,967,295, which means that the value of SumCmp2H will appear as zero.
SumCmp2H
Sum of the squares of completed operation times (2), High-Order--The high-order 32 bits of the accumulated squares of completion times (in milliseconds) of operations that completed successfully.
TMax
Round-trip time, maximum--The highest recorded round-trip time, in milliseconds, per aggregation interval.
TMin
Round-trip time, minimum--The lowest recorded round-trip time, in milliseconds, per aggregation interval.
Related Commands
Command
Description
ipsla
Allows configuration of IP SLA operations by entering IP SLA configuration mode for the specified operation number.
showipslaenhanced-historycollection-statistics
Displays enhanced history statistics for all collected history buckets for the specified IP SLAs operation.
showipslastatistics
Displays the current operational status and statistics of all IP SLAs operations or a specified operation.
showipslastatisticsaggregated
Displays the aggregated statistical errors and distribution information for all IP SLAs operations or a specified operation.
show ip sla ethernet-monitor configuration
To display configuration settings for IP Service Level Agreements (SLAs) auto Ethernet operations, use the
showipslaethernet-monitorconfiguration command in user EXEC or privileged EXEC mode.
(Optional) Number of the auto Ethernet operation for which the details will be displayed.
Command Modes
User EXEC (>) Privileged EXEC (#)
Command History
Release
Modification
12.2(33)SRB
This command was introduced.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB.
12.4(20)T
This command was integrated into Cisco IOS Release 12.4(20)T.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI.
Usage Guidelines
If the identification number of an auto Ethernet operation is not specified, configuration values for all the configured auto Ethernet operations will be displayed.
Examples
The following is sample output from the
showipslaethernet-monitorconfiguration command:
Router# show ip sla ethernet-monitor configuration 1
Entry Number : 1
Modification time : *00:47:46.703 GMT Thu Jan 11 2007
Operation Type : echo
Domain Name : a
VLAN ID : 11
Excluded MPIDs :
Owner :
Tag :
Timeout(ms) : 5000
Threshold(ms) : 5000
Frequency(sec) : 60
Operations List : Empty
Schedule Period(sec): 0
Request size : 0
CoS : 0
Start Time : Pending trigger
SNMP RowStatus : notInService
Reaction Configs :
Reaction Index : 1
Reaction : RTT
Threshold Type : Never
Threshold Rising : 300
Threshold Falling : 200
Threshold CountX : 5
Threshold CountY : 5
Action Type : None
The table below describes the significant fields shown in the display.
Table 11 show ip sla ethernet-monitor configuration Field Descriptions
Field
Description
Entry Number
Identification number for the auto Ethernet operation.
Operation Type
Type of IP SLAs operation configured by the auto Ethernet operation.
Domain Name
Name of the Ethernet Connectivity Fault Management (CFM) maintenance domain.
VLAN ID
VLAN identification number
Excluded MPIDs
List of maintenance endpoint identification numbers to be excluded from the auto Ethernet operation.
Owner
Simple Network Management Protocol (SNMP) owner of an IP SLAs operation.
Tag
User-specified identifier for an IP SLAs operation.
Timeout(ms)
Amount of time the IP SLAs operation waits for a response from its request packet.
Threshold(ms)
Upper threshold value for calculating network monitoring statistics created by an IP SLAs operation.
Frequency(sec)
Time after which an individual IP SLAs operation is restarted.
Operations List
Identification numbers of the individual operations created by the auto Ethernet operation.
Schedule Period(sec)
Time period (in seconds) in which the start times of the individual Ethernet operations are distributed.
Request size
Padding size for the data frame of the individual operations created by the auto Ethernet operation.
CoS
Class of Service of the individual operations created by the auto Ethernet operation.
Start Time
Status of the start time for the auto Ethernet operation.
SNMP RowStatus
Indicates whether SNMP RowStatus is active or inactive.
Reaction Configs
Reaction configuration of the IP SLAs operation.
Reaction Index
Identification number used to identify different reaction configurations for an IP SLAs operation.
Reaction
Reaction condition being monitored.
Threshold Type
Specifies when an action should be performed as a result of a reaction event.
Threshold Rising
The upper threshold value of the reaction condition being monitored.
Corresponds to the
upper-thresholdargument of the
threshold-valueupper-thresholdlower-thresholdsyntax in the
ipslaethernet-monitorreaction-configuration command.
Threshold Falling
The lower threshold value of the reaction condition being monitored.
Corresponds to the
lower-thresholdargument of the
threshold-valueupper-thresholdlower-threshold syntax in the
ipslaethernet-monitorreaction-configuration command.
Threshold CountX
Corresponds to the
x-value argument of the
threshold-typexofyx-valuey-valuesyntax in the
ipslaethernet-monitorreaction-configuration command.
Threshold CountY
Corresponds to the
y-value argument of the
threshold-typexofyx-valuey-valuesyntax in the
ipslaethernet-monitorreaction-configuration command.
Action Type
Type of action that should be performed as a result of a reaction event.
Related Commands
Command
Description
ipslaethernet-monitor
Begins configuration for an IP SLAs auto Ethernet operation and enters Ethernet monitor configuration mode.
ipslaethernet-monitorreaction-configuration
Configures the proactive threshold monitoring parameters for an IP SLAs auto Ethernet operation.
ipslaethernet-monitorschedule
Configures the scheduling parameters for an IP SLAs LSP Health Monitor operation.
show ip sla event-publisher
To display the list of client applications that are registered to receive IP Service Level Agreements (SLAs) notifications, use the
showipslaevent-publisher command in user EXEC or privileged EXEC mode.
showipslaevent-publisher
Command Modes
User EXEC (>) Privileged EXEC (#)
Command History
Release
Modification
12.4(22)T
This command was introduced.
12.2(33)SRE
This command was integrated into Cisco IOS Release 12.2(33)SRE.
Examples
The following is sample output from the
showipslaevent-publisher command:
Router# show ip sla event-publisher
client-id process-id event-type
------------------------------------
appl1 1111 react-alert
appl1 1221 react-alert
appl1 1331 react-alert
Router#
The table below describes the fields shown in the display.
Table 12 show ip sla event-publisher Field Descriptions
Field
Description
client-id
The identity of the client registered to receive IP SLAs notifications.
process-id
The process identity associated with the client.
event-type
The type of notification (event) that the client has registered to receive.
Related Commands
Command
Description
ip sla enable reaction-alerts
Enables IP SLA notifications to be sent to all registered applications.
show ip sla application
Displays global information about Cisco IOS IP SLAs.
show ip sla group schedule
To display the group schedule details for Cisco IOS IP Service Level Agreements (SLAs) operations, use the
showipslagroupschedulecommand in user EXEC or privileged EXEC mode.
showipslagroupschedule [group-operation-number]
Syntax Description
group-operation-number
(Optional) Number of the IP SLAs group operation to display.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.4(4)T
This command was introduced. This command replaces the
showipslamonitorgroupschedule command.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the
showrtrgroupschedulecommand.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitorgroupschedulecommand.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the
showipslamonitorgroupschedulecommand.
15.1(1)SG
This command was integrated into Cisco IOS Release 15.1(1)SG.
Cisco IOS XE Release 3.3SG
This command was integrated into Cisco IOS XE Release 3.3SG.
Examples
The following is sample output from the
showipslagroupschedule command that shows information about group (multiple) scheduling. The last line in the example indicates that the IP SLAs operations are multiple scheduled (TRUE):
Router# show ip sla group schedule
Multi-Scheduling Configuration:
Group Entry Number: 1
Probes to be scheduled: 2,3,4,9-30,89
Schedule period :60
Group operation frequency: 30
Multi-scheduled: TRUE
The following is sample output from the
showipslagroupschedule command that shows information about group (multiple) scheduling, with the frequency value the same as the schedule period value, the life value as 3600 seconds, and the ageout value as never:
Router# show ip sla group schedule
Group Entry Number: 1
Probes to be scheduled: 3,4,6-10
Total number of probes: 7
Schedule period: 20
Group operation frequency: Equals schedule period
Status of entry (SNMP RowStatus): Active
Next Scheduled Start Time: Start Time already passed
Life (seconds): 3600
Entry Ageout (seconds): never
The table below describes the significant fields shown in the displays.
Table 13 show ip sla group schedule Field Descriptions
Field
Description
Group Entry Number
The operation group number specified for IP SLAs multiple operations scheduling.
Probes to be scheduled
The operations numbers specified in the operation group 1.
Scheduled period
The time (in seconds) for which the IP SLAs group is scheduled.
Group operation frequency
The frequency at which each operation is started.
Multi-scheduled
The value TRUE shows that group scheduling is active.
Related Commands
Command
Description
showipslaconfiguration
Displays the configuration details for IP SLAs operations.
show ip sla history
To display history collected for all Cisco IOS IP Service Level Agreements (SLAs) operations or for a specified operation, use the
showipslahistorycommand in user EXEC or privileged EXEC mode.
showipslahistory [operation-number]
[ tabular | full | interval-statistics ]
Syntax Description
operation-number
(Optional) Number of the operation for which history details is displayed.
tabular
(Optional) Displays information in a column format, reducing the number of screens required to display the information. This is the default.
full
(Optional) Displays all information, using identifiers next to each displayed value.
interval-statistics
(Optional) Displays interval statistics.
Command Default
Tabular format history for all operations is displayed.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.4(4)T
This command was introduced. This command replaces the
showipslamonitorhistory command.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the
showrtrhistorycommand.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitorhistorycommand.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the
showipslamonitorhistorycommand.
Cisco IOS XE Release 3.3S
This command was integrated into Cisco IOS XE Release 3.3S. This command was modified. The
interval-statistics keyword was added.
15.2(2)S
This command was modified. The Available and Unavailable counters that cause the state change are counted towards the new state.
Cisco IOS XE Release 3.6S
This command was integrated into Cisco IOS XE Release 3.6S.
15.3(2)S
This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
Usage Guidelines
The table below lists the Response Return values used in the output of the
showipslahistory command.
If the default (tabular) format is used, the Response Return description is displayed as a code in the Sense column. If the full format is used, the Response Return is displayed as indicated in the Description column.
Table 14 Response Return (Sense Column) Codes
Code
Description
1
Okay.
2
Disconnected.
3
Over threshold.
4
Timeout.
5
Busy.
6
Not connected.
7
Dropped.
8
Sequence error.
9
Verify error.
10
Application specific.
Before Cisco IOS Release 15.2(2)S, the counters were incremented only after state change. In Cisco IOS Release 15.2(2)S and later releases, the Available and Unavailable counters that cause the state change are also counted towards the new state.
This command with the
interval-statistics keyword displays the Available and Unavailable indicators for an IP SLAs Ethernet Frame Loss (FRL) operation.
Prior to Cisco IOS Release 12.4(24)T, the value for SampleT was displayed in centiseconds. In Cisco IOS Release 12.4(24)T and later releases, the value for SampleT is displayed in milliseconds. SampleT is the system uptime value at the start of the operation iteration.
Examples
The following is sample output from the
showipslahistorycommand in tabular format.
Device# show ip sla history
Point by point History
Multiple Lines per Entry
Line 1
Entry = Entry Number
LifeI = Life Index
BucketI = Bucket Index
SampleI = Sample Index
SampleT = Sample Start Time (milliseconds)
CompT = Completion Time (milliseconds)
Sense = Response Return Code
Line 2 has the Target Address
Entry LifeI BucketI SampleI SampleT CompT Sense
2 1 1 1 174365480 16 1
AB 45 A0 16
2 1 2 1 174365510 4 1
AC 12 7 29
2 1 2 2 174365510 1 1
AC 12 5 22
2 1 2 3 174365520 4 1
AB 45 A7 22
2 1 2 4 174365520 4 1
AB 45 A0 16
The following sample output from the
show ip sla history command with the interval-statistics keyword includes the Available and Unavailable indicators for an IP SLAs Ethernet Frame Loss (FRL) operation.
Note
Before Cisco IOS Release 15.2(2)S, the counters were incremented only after state change. In Cisco IOS Release 15.2(2)S and later releases, the Available and Unavailable counters that cause the state change are also counted towards the new state.
Device# show ip sla history 10 interval-statistics
Loss Statistics for Y1731 Operation 10
Type of operation: Y1731 Loss Measurement
Latest operation start time: *23:04:24.450 UTC Wed Feb 15 2012
Latest operation return code: OK
Distribution Statistics:
Interval 1
Start time: *23:04:24.450 UTC Wed Feb 15 2012
End time: *23:09:24.446 UTC Wed Feb 15 2012
Number of measurements initiated: 300
Number of measurements completed: 300
Flag: OK
Forward
Number of Observations 30
Available indicators: 21
Unavailable indicators: 9
Tx frame count: 300
Rx frame count: 300
Min/Avg/Max - (FLR % ): 0:9/000.00%/0:9
Cumulative - (FLR % ): 000.00%
Timestamps forward:
Min - *23:09:24.070 UTC Wed Feb 15 2012
Max - *23:09:24.070 UTC Wed Feb 15 2012
Backward
Number of Observations 30
Available indicators: 21
Unavailable indicators: 9
Tx frame count: 300
Rx frame count: 300
Min/Avg/Max - (FLR % ): 0:9/000.00%/0:9
Cumulative - (FLR % ): 000.00%
Timestamps backward:
Min - *23:09:24.070 UTC Wed Feb 15 2012
Max - *23:09:24.070 UTC Wed Feb 15 2012
Related Commands
Command
Description
showipslaconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
show ip sla history interval
To display the latest history collected for all IP Service Level Agreements (SLAs) Metro Ethernet 3.0 (ITU-T Y.1731) operations or for a specified operation, use the
showipslahistoryinterval command in user EXEC or privileged EXEC mode.
show
ipslahistoryinterval [operation-number]
Syntax Description
operation-number
(Optional) Number of the operation for which history details are to be displayed.
Command Default
Latest history for all operations is displayed.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
Modification
15.1(2)S
This command was introduced.
Usage Guidelines
This command displays the current state of IP SLAs operations, including the monitoring data returned for the last (most recently completed) operation. One of the following Operation Return values is displayed for the latest operation. The values are self-explanatory.
OK
Over Threshold
Timeout
Unknown
Internal Error
The output of this command is the same as the output displayed for the
showipslastatistics command with the
detail.
Examples
The following is sample output from the
showipslahistoryinterval command for an Ethernet delay operation (3).
Router# show ip sla history interval 3
IPSLA operation id: 3
Delay Statistics for Y1731 Operation 3
Type of operation: Y1731 Delay Measurement
Latest operation start time: *02:12:49.772 PST Thu Jul 1 2010
Latest operation return code: OK
Distribution Statistics:
Interval
Start time: *02:12:49.772 PST Thu Jul 1 2010
End time: *00:00:00.000 PST Mon Jan 1 1900
Number of measurements initiated: 31
Number of measurements completed: 31
Flag: OK
Delay:
Max/Avg/Min TwoWay: 2014/637/0
Time of occurrence TwoWay: Max - *02:13:11.210 PST Thu Jul 1 2010/Min - *02:17:51.339 PST Thu Jul 1 2010
Bucket TwoWay:
Bucket Range: 0 - < 5000 microseconds
Total observations: 22
Bucket Range: 5000 - < 10000 microseconds
Total observations: 0
Bucket Range: 10000 - < 15000 microseconds
Total observations: 0
Bucket Range: 15000 - < 20000 microseconds
Total observations: 0
Bucket Range: 20000 - < 25000 microseconds
Total observations: 0
Bucket Range: 25000 - < 30000 microseconds
Total observations: 0
Bucket Range: 30000 - < 35000 microseconds
Total observations: 0
Bucket Range: 35000 - < 40000 microseconds
Total observations: 0
Bucket Range: 40000 - < 45000 microseconds
Total observations: 0
Bucket Range: 45000 - < 4294967295 microseconds
Total observations: 0
Delay Variance:
Max/Avg TwoWay positive: 0/0
Time of occurrence TwoWay positive: Max - *00:00:00.000 PST Mon Jan 1 1900
Max/Avg TwoWay negative: 0/0
Time of occurrence TwoWay negative: Max - *00:00:00.000 PST Mon Jan 1 1900
Bucket TwoWay positive:
Bucket Range: 0 - < 5000 microseconds
Total observations: 0
Bucket Range: 5000 - < 10000 microseconds
Total observations: 0
Bucket Range: 10000 - < 15000 microseconds
Total observations: 0
Bucket Range: 15000 - < 20000 microseconds
Total observations: 0
Bucket Range: 20000 - < 25000 microseconds
Total observations: 0
Bucket Range: 25000 - < 30000 microseconds
Total observations: 0
Bucket Range: 30000 - < 35000 microseconds
Total observations: 0
Bucket Range: 35000 - < 40000 microseconds
Total observations: 0
Bucket Range: 40000 - < 45000 microseconds
Total observations: 0
Bucket Range: 45000 - < 4294967295 microseconds
Total observations: 0
Bucket TwoWay negative:
Bucket Range: 0 - < 5000 microseconds
Total observations: 0
Bucket Range: 5000 - < 10000 microseconds
Total observations: 0
Bucket Range: 10000 - < 15000 microseconds
Total observations: 0
Bucket Range: 15000 - < 20000 microseconds
Total observations: 0
Bucket Range: 20000 - < 25000 microseconds
Total observations: 0
Bucket Range: 25000 - < 30000 microseconds
Total observations: 0
Bucket Range: 30000 - < 35000 microseconds
Total observations: 0
Bucket Range: 35000 - < 40000 microseconds
Total observations: 0
Bucket Range: 40000 - < 45000 microseconds
Total observations: 0
Bucket Range: 45000 - < 4294967295 microseconds
Total observations: 0
Bucket TwoWay negative:
Related Commands
Command
Description
showipslastatistics
Displays the current operational status and statistics of all Cisco IOS IP Service Level Agreements (SLAs) operations or a specified operation.
show ip sla monitor application
Note
Effective with Cisco IOS Release 12.4(4)T, 12.2(33)SB, and 12.2(33)SXI, the showipslamonitorapplicationcommand is replaced by the showipslaapplicationcommand. See the showipslaapplicationcommand for more information.
To display global information about Cisco IOS IP Service Level Agreements (SLAs), use the showipslamonitorapplication command in user EXEC or privileged EXEC mode.
showipslamonitorapplication
[ tabular | full ]
Syntax Description
tabular
(Optional) Displays information in a column format, reducing the number of screens required to display the information.
full
(Optional) Displays all information, using identifiers next to each displayed value. This is the default.
Command Default
Full format
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.3(14)T
This command was introduced.
12.4(4)T
This command was replaced by the showipslaapplicationcommand.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the showrtrapplicationcommand.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was replaced by the showipslaapplicationcommand.
12.2(33)SXI
This command was replaced by the showipslaapplicationcommand.
Usage Guidelines
Use the showipslamonitorapplicationcommand to display information such as supported operation types and supported protocols.
Examples
The following is sample output from the showipslamonitorapplication command in full format:
Router# show ip sla monitor application
IP Service Level Agreement Monitor
Version: 2.2.0 Round Trip Time MIB
Time of last change in whole IP SLA Monitor: *17:21:30.819 UTC Tue Mar 19 2002
Estimated system max number of entries: 4699
Number of Entries configured:5
Number of active Entries:5
Number of pending Entries:0
Number of inactive Entries:0
Supported Operation Types
Type of Operation to Perform: echo
Type of Operation to Perform: pathEcho
Type of Operation to Perform: udpEcho
Type of Operation to Perform: tcpConnect
Type of Operation to Perform: http
Type of Operation to Perform: dns
Type of Operation to Perform: jitter
Type of Operation to Perform: dlsw
Type of Operation to Perform: dhcp
Type of Operation to Perform: ftp
Supported Protocols
Protocol Type: ipIcmpEcho
Protocol Type: ipUdpEchoAppl
Protocol Type: snaRUEcho
Protocol Type: snaLU0EchoAppl
Protocol Type: snaLU2EchoAppl
Protocol Type: ipTcpConn
Protocol Type: httpAppl
Protocol Type: dnsAppl
Protocol Type: jitterAppl
Protocol Type: dlsw
Protocol Type: dhcp
Protocol Type: ftpAppl
Number of configurable probe is 490
Related Commands
Command
Description
showipslamonitorconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
show ip sla monitor authentication
Note
Effective with Cisco IOS Release 12.4(4)T, 12.2(33)SB, and 12.2(33)SXI, the showipslamonitorauthenticationcommand is replaced by the showipslaauthenticationcommand. See the showipslaauthenticationcommand for more information.
To display Cisco IOS IP Service Level Agreements (SLAs) authentication information, use the showipslamonitorauthentication command in user EXEC or privileged EXEC mode.
showipslamonitorauthentication
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.3(14)T
This command was introduced.
12.4(4)T
This command was replaced by the showipslaauthenticationcommand.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the showrtrauthentication command.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was replaced by the showipslaauthenticationcommand.
12.2(33)SXI
This command was replaced by the showipslaauthenticationcommand.
Usage Guidelines
Use the showipslamonitorauthenticationcommand to display information such as supported operation types and supported protocols.
Examples
The following is sample output from the showipslamonitorauthenticationcommand:
Router# show ip sla monitor authentication
IP SLA Monitor control message uses MD5 authentication, key chain name is: ipsla
Related Commands
Command
Description
showipslamonitorconfiguration
Displays configuration values for IP SLAs operations.
show ip sla monitor collection-statistics
Note
Effective with Cisco IOS Release 12.4(2)T, the
showipslamonitorcollection-statistics command is replaced by the
showipslamonitorstatisticsaggregated command. See the
showipslamonitorstatisticsaggregated command for more information.
To display statistical errors for all Cisco IOS IP Service Level Agreements (SLAs) operations or a specified operation, use the
showipslamonitorcollection-statisticscommand in user EXEC or privileged EXEC mode.
(Optional) Number of the IP SLAs operation to display.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.3(14)T
This command was introduced.
12.4(2)T
This command was replaced by the
showipslamonitorstatisticsaggregated command.
Usage Guidelines
Use the
showipslamonitorcollection-statistics command to display information such as the number of failed operations and the failure reason. You can also use the
showipslamonitordistribution-statistics and
showipslamonitortotals-statistics commands to display additional statistical information.
This command shows information collected over the past two hours, unless you specify a different amount of time using the
hours-of-statistics-kept command.
For one-way delay jitter operations, the clocks on each device must be synchronized using Network Time Protocol (NTP) or global positioning systems. If the clocks are not synchronized, one-way measurements are discarded. (If the sum of the source to destination (SD) and the destination to source (DS) values is not within 10 percent of the round-trip time, the one-way measurement values are assumed to be faulty, and are discarded.)
Note
This command does not support the IP SLAs ICMP path jitter operation.
Examples
The following is sample output from the
showipslamonitorcollection-statistics command:
Router# show ip sla monitor collection-statistics 1
Collected Statistics
Entry Number: 1
Start Time Index: *17:15:41.000 UTC Thu May 16 1996
Path Index: 1
Hop in Path Index: 1
Number of Failed Operations due to a Disconnect: 0
Number of Failed Operations due to a Timeout: 0
Number of Failed Operations due to a Busy: 0
Number of Failed Operations due to a No Connection: 0
Number of Failed Operations due to an Internal Error: 0
Number of Failed Operations due to a Sequence Error: 0
Number of Failed Operations due to a Verify Error: 0
Target Address: 172.16.1.176
Examples
The following is output from the
showipslamonitorcollection-statistics command when the specified operation is an HTTP operation:
The following is sample output from the
showipslamonitorcollection-statistics command, where operation 2 is a jitter operation that includes one-way statistics. The table below describes the significant fields shown in the display.
The following is sample output from the
showipslamonitorcollection-statistics command, where operation 10 is a UDP jitter (codec) operation. The table above describes the significant fields shown in the display.
Router# show ip sla monitor collection-statistics 10
Entry Number: 10
Start Time Index: 12:57:45.931 UTC Wed Mar 12 2003
Number of successful operations: 60
Number of operations over threshold: 0
Number of failed operations due to a Disconnect: 0
Number of failed operations due to a Timeout: 0
Number of failed operations due to a Busy: 0
Number of failed operations due to a No Connection: 0
Number of failed operations due to an Internal Error: 0
Number of failed operations due to a Sequence Error: 0
Number of failed operations due to a Verify Error: 0
Voice Scores:
MinOfICPIF: 2 MaxOfICPIF: 20 MinOfMos: 3.20 MaxOfMos: 4.80
RTT Values:
NumOfRTT: 600 RTTSum: 3789 RTTSum2: 138665
Packet Loss Values:
PacketLossSD: 0 PacketLossDS: 0
PacketOutOfSequence: 0 PacketMIA: 0 PacketLateArrival: 0
InternalError: 0 Busies: 0
Jitter Values:
NumOfJitterSamples: 540
MinOfPositivesSD: 1 MaxOfPositivesSD: 2
NumOfPositivesSD: 26 SumOfPositivesSD: 31 Sum2PositivesSD: 41
MinOfNegativesSD: 1 MaxOfNegativesSD: 4
NumOfNegativesSD: 56 SumOfNegativesSD: 73 Sum2NegativesSD: 133
MinOfPositivesDS: 1 MaxOfPositivesDS: 338
NumOfPositivesDS: 58 SumOfPositivesDS: 409 Sum2PositivesDS: 114347
MinOfNegativesDS: 1 MaxOfNegativesDS: 338
NumOfNegativesDS: 48 SumOfNegativesDS: 396 Sum2NegativesDS: 114332
Interarrival jitterout: 0 Interarrival jitterin: 0
One Way Values:
NumOfOW: 440
OWMinSD: 2 OWMaxSD: 6 OWSumSD: 1273 OWSum2SD: 4021
OWMinDS: 2 OWMaxDS: 341 OWSumDS: 1643 OWSum2DS: 120295
Table 15 show ip sla monitor collection-statistics Field Descriptions
Field
Description
Voice Scores
Indicates that Voice over IP statistics appear on the following lines. Voice score data is computed when the operation type is configured as
typejitter (codec).
ICPIF
The Calculated Planning Impairment Factor (ICPIF) value for the operation. The ICPIF value is computed by IP SLAs using the formula
Icpif=Io+Iq+Idte+Idd+Ie-A, where
The values for
Io ,
Iq , and
Idte are set to zero.
The value
Idd is computed based on the measured one-way delay.
The value
Ie is computed based on the measured packet loss.
The value of A is specified by the user.
ICPIF values are expressed in a typical range of 5 (very low impairment) to 55 (very high impairment). ICPIF values numerically lower than 20 are generally considered “adequate.”
Note
This value is intended only for relative comparisons, and may not match ICPIF values generated using alternate methods.
MinOfICPIF
The lowest (minimum) ICPIF value computed for the collected statistics.
MaxOfICPIF
The highest (maximum) ICPIF value computed for the collected statistics.
Mos
The estimated Mean Opinion Score (Conversational Quality, Estimated) for the latest iteration of the operation. The MOS-CQE is computed by IP SLAs as a function of the ICPIF.
MOS values are expressed as a number from 1 (1.00) to 5 (5.00), with 5 being the highest level of quality, and 1 being the lowest level of quality. A MOS value of 0 (zero) indicates that MOS data could not be generated for the operation.
MinOfMos
The lowest (minimum) MOS value computed for the collected statistics.
MaxOfMos
The highest (maximum) ICPIF value computed for the collected statistics.
RTT Values
Indicates that round-trip-time statistics appear on the following lines.
NumOfRTT
The number of successful round-trips.
RTTSum
The sum of all successful round-trip values (in milliseconds).
RTTSum2
The sum of squares of those round-trip values (in milliseconds).
PacketLossSD
The number of packets lost from source to destination.
PacketLossDS
The number of packets lost from destination to source.
PacketOutOfSequence
The number of packets returned out of order.
PacketMIA
The number of packets lost where the direction (SD/DS) cannot be determined.
PacketLateArrival
The number of packets that arrived after the timeout.
InternalError
The number of times an operation could not be started due to other internal failures.
Busies
The number of times this operation could not be started because the previously scheduled run was not finished.
Jitter Values:
Indicates that jitter statistics appear on the following lines. Jitter is interpacket delay variance.
NumOfJitterSamples
The number of jitter samples collected. This is the number of samples that are used to calculate the following jitter statistics.
MinOfPositivesSD MaxOfPositivesSD
The minimum and maximum positive jitter values from source to destination, in milliseconds.
NumOfPositivesSD
The number of jitter values from source to destination that are positive (that is, network latency increases for two consecutive test packets).
SumOfPositivesSD
The sum of those positive values (in milliseconds).
Sum2PositivesSD
The sum of squares of those positive values.
MinOfNegativesSD MaxOfNegativesSD
The minimum and maximum negative jitter values from source to destination. The absolute value is given.
NumOfNegativesSD
The number of jitter values from source to destination that are negative (that is, network latency decreases for two consecutive test packets).
SumOfNegativesSD
The sum of those values.
Sum2NegativesSD
The sum of the squares of those values.
Interarrival jitterout
The source-to-destination (SD) jitter value calculation, as defined in RFC 1889.
Interarrival jitterin
The destination-to-source (DS) jitter value calculation, as defined in RFC 1889.
One Way Values
Indicates that one-way measurement statistics appear on the following lines.
One Way (OW) values are the amount of time required for the packet to travel from the source router to the target router (SD) or from the target router to the source router (DS).
NumOfOW
Number of successful one-way time measurements.
OWMinSD
Minimum time (in milliseconds) from the source to the destination.
OWMaxSD
Maximum time (in milliseconds) from the source to the destination.
OWSumSD
Sum of the OWMinSD and OWMaxSD values.
OWSum2SD
Sum of the squares of the OWMinSD and OWMaxSD values.
Related Commands
Command
Description
showipslamonitorconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
showipslamonitordistributions-statistics
Displays statistics distribution information (captured response times) for all IP SLAs operations or the specified operation.
showipslamonitortotals-statistics
Displays the total statistical values (accumulation of error counts and completions) for all IP SLAs operations or the specified operation.
showntpstatus
Displays the status of the NTP configuration on your system.
show ip sla monitor configuration
Note
Effective with Cisco IOS Release 12.4(4)T, 12.2(33)SB, and 12.2(33)SXI, the showipslamonitorconfigurationcommand is replaced by the showipslaconfigurationcommand. See the showipslaconfigurationcommand for more information.
To display configuration values including all defaults for all Cisco IOS IP Service Level Agreements (SLAs) operations or a specified operation, use the showipslamonitorconfiguration command in user EXEC or privileged EXEC mode.
showipslamonitorconfiguration [operation]
Syntax Description
operation
(Optional) Number of the IP SLAs operation for which the details will be displayed.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.3(14)T
This command was introduced.
12.4(2)T
The displayed information was reorganized.
12.4(4)T
This command was replaced by the showipslaconfigurationcommand.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the showrtrconfiguration command.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was replaced by the showipslaconfigurationcommand.
12.2(33)SXI
This command was replaced by the showipslaconfigurationcommand.
Examples
The following sections show sample output from the showipslamonitorconfiguration command for different IP SLAs operations.
Examples
The following example shows output from the showipslamonitorconfiguration command when the specified operation is an Internet Control Message Protocol (ICMP) echo operation:
Router# show ip sla monitor configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: echo
Target address/Source address: 1.1.1.1/0.0.0.0
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Vrf Name:
Request size (ARR data portion): 28
Verify data: No
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
Enhanced History:
Examples
The following example shows output from the showipslamonitorconfiguration command when the specified operation is a Hypertext Transfer Protocol (HTTP) operation:
Router# show ip sla monitor configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: http
Target address/Source address: 1.1.1.1/0.0.0.0
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
HTTP Operation: get
HTTP Server Version: 1.0
URL: http://www.cisco.com
Proxy:
Raw String(s):
Cache Control: enable
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
Examples
The following example shows output from the showipslamonitorconfiguration command when the specified operation is an ICMP path jitter operation:
Router# show ip sla monitor configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: pathJitter
Target address/Source address: 1.1.1.1/0.0.0.0
Packet Interval/Number of Packets: 20 ms/10
Target Only: Disabled
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Loose Source Routing: Disabled
LSR Path:
Vrf Name:
Request size (ARR data portion): 28
Verify data: No
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Examples
The following example shows output from the showipslamonitorconfiguration command when the specified operation is an ICMP path echo operation:
Router# show ip sla monitor configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: pathEcho
Target address/Source address: 1.1.1.1/0.0.0.0
Packet Interval/Number of Packets: 20 ms/10
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Loose Source Routing: Disabled
Vrf Name:
LSR Path:
Request size (ARR data portion): 28
Verify data: No
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic paths kept: 5
Number of statistic hops kept: 16
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
Examples
The following example shows output from the showipslamonitorconfiguration command when the specified operation is a Domain Name System (DNS) operation:
Router# show ip sla monitor configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: dns
Target Address/Source address: 1.1.1.1/0.0.0.0
Target Port/Source Port: 1111/0
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
Examples
The following example shows output from the showipslamonitorconfiguration command when the specified operation is a UDP echo operation:
Router# show ip sla monitor configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: udpEcho
Target address/Source address: 1.1.1.1/0.0.0.0
Target Port/Source Port: 1111/0
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Data Pattern:
Vrf Name:
Request size (ARR data portion): 28
Verify data: No
Control Packets: enabled
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
Enhanced History:
Examples
The following example shows output from the showipslamonitorconfiguration command when the specified operation is a Transmission Control Protocol (TCP) connect operation:
Router# show ip sla monitor configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: tcpConnect
Target Address/Source address: 1.1.1.1/0.0.0.0
Target Port/Source Port: 1111/0
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Control Packets: enabled
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
Enhanced History:
Examples
The following example shows output from the showipslamonitorconfiguration command when the specified operation is a Dynamic Host Configuration Protocol (DHCP) operation:
Router# show ip sla monitor configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: dhcp
Target Address/Source address: 1.1.1.1/0.0.0.0
Operation timeout (milliseconds): 5000
Dhcp option:
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
Examples
The following example shows output from the showipslamonitorconfiguration command when the specified operation is a File Transfer Protocol (FTP) operation:
Router# show ip sla monitor configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: ftp
Source address: 0.0.0.0
FTP URL: ftp://ipsla:ipsla@172.19.192.109/test.txt
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Number of history Lives kept: 0
Number of history Buckets kept: 15
History Filter Type: None
Examples
The following example shows output from the showipslamonitorconfiguration command when the specified operation is a User Datagram Protocol (UDP) jitter operation:
Router# show ip sla monitor configuration 3
Entry number: 3
Owner:
Tag:
Type of operation: jitter
Target Address/Source address: 1.1.1.1/0.0.0.0
Target Port/Source Port: 1111/0
Packet Interval/Number of Packets: 20 ms/10
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Vrf Name:
Request size (ARR data portion): 28
Verify data: No
Control Packets: enabled
Schedule:
Next Scheduled Start Time: Start Time already passed
Group Scheduled: False
Operation frequency (seconds): 60
Life/Entry Ageout (seconds): Forever/never
Recurring (Starting Everyday): FALSE
Status of entry (SNMP RowStatus): Active
Threshold (ms): 5000
Distribution Statistics:
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 5
Statistic distribution interval (milliseconds): 10
Enhanced History:
Related Commands
Command
Description
ipslamonitor
Begins configuration for an IP SLAs operation and enters IP SLA monitor configuration mode.
show ip sla monitor distributions-statistics
Note
Effective with Cisco IOS Release 12.4(2)T, the showipslamonitordistributions-statistics command is replaced by the showipslamonitorstatisticsaggregateddetailscommand. See the showipslamonitorstatisticsaggregated command for more information.
To display distribution statistics (captured response times) for all Cisco IOS IP Service Level Agreements (SLAs) operations or the specified operation, use the showipslamonitordistributions-statistics command in user EXEC or privileged EXEC mode.
showipslamonitordistributions-statistics [operation]
[ tabular | full ]
Syntax Description
operation
(Optional) Number of the IP SLAs operation to display.
tabular
(Optional) Displays information in a column format, reducing the number of screens required to display the information. This is the default.
full
(Optional) Displays all information, using identifiers next to each displayed value.
Command Default
Statistics are displayed for the past two hours.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.3(14)T
This command was introduced.
12.4(2)T
This command was replaced by the showipslamonitorstatisticsaggregateddetailscommand.
Usage Guidelines
The distribution statistics consist of the following:
The sum of completion times (used to calculate the mean)
The sum of the completion times squared (used to calculate standard deviation)
The maximum and minimum completion time
The number of completed attempts
Note
This command does not support the IP SLAs ICMP path jitter operation.
This command shows information collected over the past two hours, unless you specify a different amount of time using the hours-of-statistics-kept command.
You can also use the showipslamonitorcollection-statistics and showipslamonitortotals-statistics commands to display additional statistical information.
Examples
The following is sample output from the showipslamonitordistributions-statistics command:
Router# show ip sla monitor distributions-statistics
Captured Statistics
Multiple Lines per Entry
Line 1
Entry = Entry Number
StartT = Start Time of Entry (hundredths of seconds)
Pth = Path Index
Hop = Hop in Path Index
Dst = Time Distribution Index
Comps = Operations Completed
OvrTh = Operations Completed Over Thresholds
SumCmp = Sum of Completion Times (milliseconds)
Line 2
SumCmp2L = Sum of Completion Times Squared Low 32 Bits (milliseconds)
SumCmp2H = Sum of Completion Times Squared High 32 Bits (milliseconds)
TMax = Completion Time Maximum (milliseconds)
TMin = Completion Time Minimum (milliseconds)
Entry StartT Pth Hop Dst Comps OvrTh SumCmp SumCmp2L SumCmp2H TMax TMin
1 17417068 1 1 1 2 0 128 8192 0 64 64
The fields shown in the display are self-explanatory.
Related Commands
Command
Description
showipslamonitorcollection-statistics
Displays statistical errors for all IP SLAs operations or the specified operation.
showipslamonitorconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
showipslamonitortotals-statistics
Displays the total statistical values (accumulation of error counts and completions) for all IP SLAs operations or the specified operation.
show ip sla monitor enhanced-history collection-statistics
Note
Effective with Cisco IOS Release 12.4(4)T, 12.2(33)SB, and 12.2(33)SXI, the
showipslamonitorenhanced-historycollection-statisticscommand is replaced by the
showipslaenhanced-historycollection-statisticscommand. See the
showipslaenhanced-historycollection-statisticscommand for more information.
To display enhanced history statistics for all collected history buckets for the specified Cisco IOS IP Service Level Agreements (SLAs) operation, use the
showipslamonitorenhanced-historycollection-statistics command in user EXEC or privileged EXEC mode.
If the letter n appears in your output, or not all fields are displayed, you should increase the screen width for your command line interface display (for example, using the
width line configuration command or the
terminalwidth EXEC mode command).
Examples
The following example shows sample output for the
showipslamonitorenhanced-historycollection-statistics command. The output of this command will vary depending on the type of IP SLAs operation.
Router# show ip sla monitor enhanced-history collection-statistics 1
Entry number: 1
Aggregation Interval: 900
Bucket Index: 1
Aggregation start time 00:15:00.003 UTC Thur May 1 2003
Target Address:
Number of failed operations due to a Disconnect: 0
Number of failed operations due to a Timeout: 0
Number of failed operations due to a Busy: 0
Number of failed operations due to a No Connection: 0
Number of failed operations due to an Internal Error: 0
Number of failed operations due to a Sequence Error: 0
Number of failed operations due to a Verify Error: 0
.
.
.
The table below describes the significant fields shown in the display.
Table 16 show ip sla monitor enhanced-history collection-statistics Field Descriptions
Field
Description
Aggregation Interval
The number of seconds the operation runs for each enhanced history bucket. For example, a value of 900 indicates that statistics were gathered for 15 minutes before the next bucket was created.
Bucket Index
The number identifying the collection bucket. The number of buckets is set using the
enhanced-history IP SLA monitor configuration command.
Related Commands
Command
Description
ipslamonitor
Allows configuration of IP SLA operations by entering IP SLA monitor configuration mode for the specified operation number.
Displays enhanced history distribution statistics for IP SLAs operations in tabular format.
showipslamonitorstatistics
Displays the current operational status and statistics of all IP SLAs operations or a specified operation.
showipslamonitorstatisticsaggregated
Displays the aggregated statistical errors and distribution information for all IP SLAs operations or a specified operation.
show ip sla monitor enhanced-history distribution-statistics
Note
Effective with Cisco IOS Release 12.4(4)T, 12.2(33)SB, and 12.2(33)SXI, the
showipslamonitorenhanced-historydistribution-statisticscommand is replaced by the
showipslaenhanced-historydistribution-statisticscommand. See the
showipslaenhanced-historydistribution-statisticscommand for more information.
To display enhanced history distribution statistics for Cisco IOS IP Service Level Agreements (SLAs) operations in tabular format, use the
showipslamonitorenhanced-historydistribution-statistics command in user EXEC or privileged EXEC mode.
If the letter n appears in your output, or not all fields are displayed, you should increase the screen width for your command line interface display (for example, using the
width line configuration command or the
terminalwidth EXEC mode command).
Examples
The following is sample output from the
showipslamonitorenhanced-historydistribution-statistics command. The fields are defined at the beginning of the output for the command. RTT means round-trip time.
Router# show ip sla monitor enhanced-history distribution-statistics 3
Point by point Enhanced History
Entry = Entry Number
Int = Aggregation Interval (seconds)
BucI = Bucket Index
StartT = Aggregation Start Time
Pth = Path index
Hop = Hop in path index
Comps = Operations completed
OvrTh = Operations completed over thresholds
SumCmp = Sum of RTT (milliseconds)
SumCmp2L = Sum of RTT squared low 32 bits (milliseconds)
SumCmp2H = Sum of RTT squared high 32 bits (milliseconds)
TMax = RTT maximum (milliseconds)
TMin = RTT minimum (milliseconds)
Entry Int BucI StartT Pth Hop Comps OvrTh SumCmp SumCmp2L SumCmp2H TMax TMin
3 900 1 257850000 1 1 3 0 43 617 0 15 14
3 900 2 258750002 1 1 3 0 45 677 0 16 14
3 900 3 259650000 1 1 3 0 44 646 0 15 14
3 900 4 260550002 1 1 3 0 42 594 0 15 12
3 900 5 261450003 1 1 3 0 42 590 0 15 13
3 900 6 262350001 1 1 3 0 46 706 0 16 15
3 900 7 263250003 1 1 3 0 46 708 0 16 14
.
.
.
The time elapsed between BucketIndex 1 (started at 257,850,000) and BucketIndex 2 (started at 258,750,002) in this example is 900,002 milliseconds, or 900 seconds.
The table below describes the significant fields shown in the display.
Table 17 show ip sla monitor enhanced-history distribution-statistics Field Descriptions
Field
Description
Entry
The operation ID number you specified for the IP SLAs operation.
Int
Aggregation interval--The configured statistical distribution buckets interval, in seconds. For example, a value of 900 for Int means that statistics are gathered for 900 seconds per bucket.
BucI
Bucket index number--A number uniquely identifying the statistical distribution (aggregation) bucket.
The number of history buckets to be kept is configured using the
buckets-of-history-kept command.
A bucket will gather statistics for the specified interval of time (aggregation interval), after which a new statistics bucket is created.
If a number-of-buckets-kept value is configured, the interval for the last bucket is infinity (until the end of the operation).
Buckets are not applicable to HTTP and UDP jitter monitoring operations.
This field is equivalent to the rttMonStatsCaptureDistIndex object in the Cisco RTTMON MIB.
StartT
Aggregation start time--Start time for the aggregation interval (per Bucket Index).
Shows the start time as the number of milliseconds since the router started; in other words, the time stamp is the number of milliseconds since the last system bootup.
Pth
Path index number--An identifier for a set of different paths to the target destination that have been discovered. For example, if the first operation iteration finds the path h1, h2, h3, h4, then this path is labeled as 1. If, on a later iteration, a new path is discovered, (such as h1, h2, h5, h6, h4) then this new path will be identified as 2, and so on.
Data collection per path is available only for ICMP path echo operations (“pathEcho probes”). For all other operations, a value of 1 will always appear.
Data collection per path is configured using the
paths-of-statistics-keptnumber command when configuring the operation.
Hop
Hop Index Number--Statistics data per hop. A hop is data transmission between two points in a path (for example, from device h2 to device h3).
Data collection per hop is available only for ICMP path echo operations (“pathEcho probes”). For all other operations, a value of “1” will always appear.
Data collection per hop is configured using the
hops-of-statistics-keptnumber command when configuring the operation.
This field is equivalent to the rrttMonStatsCaptureHopIndex object in the Cisco RTTMON MIB.
Comps
Completions--The number of round-trip time operations that have completed without an error and without timing out, per bucket index.
This object has the special behavior as defined by the ROLLOVER NOTE in the DESCRIPTION of the Cisco Rttmon MIB object.
SumCmp
Sum of completed operation times (1)--The total of all round-trip time values for all successful operations in the row, in milliseconds.
SumCmp2L
Sum of the squares of completed operation times (2), Low-Order--The sum of the square roots of round-trip times for operations that were successfully measured, in milliseconds; displays the low-order 32 bits of the value only.
32 low-order bits and 32 high-order bits are ordered in unsigned 64-bit integers (Int64) as follows:
-------------------------------------------------
| High-order 32 bits | Low-order 32 bits |
-------------------------------------------------
The “SumCmp2” values are split into “high-order” and “low-order” numbers because of limitations of Simple Network Management Protocol (SNMP). The maximum value allowed for an SNMP object is 4,294,967,295 (the Gauge32 limit).
If the sum of the square roots for your operation exceeds this value, then the “high-order” value will be utilized. (For example, the number 4,294,967,296 would have all low-order bits as 0, and the right-most high-order bit would be 1).
The low-order value (SumCmp2L) appears first in the output because in most cases, the value will be less than 4,294,967,295, which means that the value of SumCmp2H will appear as zero.
SumCmp2H
Sum of the squares of completed operation times (2), High-Order--The high-order 32 bits of the accumulated squares of completion times (in milliseconds) of operations that completed successfully.
TMax
Round-trip time, maximum--The highest recorded round-trip time, in milliseconds, per aggregation interval.
TMin
Round-trip time, minimum--The lowest recorded round-trip time, in milliseconds, per aggregation interval.
Related Commands
Command
Description
ipslamonitor
Allows configuration of IP SLA operations by entering IP SLA monitor configuration mode for the specified operation number.
Displays enhanced history statistics for all collected history buckets for the specified IP SLAs operation.
showipslamonitorstatistics
Displays the current operational status and statistics of all IP SLAs operations or a specified operation.
showipslamonitorstatisticsaggregated
Displays the aggregated statistical errors and distribution information for all IP SLAs operations or a specified operation.
show ip sla monitor group schedule
Note
Effective with Cisco IOS Release 12.4(4)T, 12.2(33)SB, and 12.2(33)SXI, the
showipslamonitorgroupschedulecommand is replaced by the
showipslagroupschedulecommand. See the
showipslagroupschedulecommand for more information.
To display the group schedule details for Cisco IOS IP Service Level Agreements (SLAs) operations, use the
showipslamonitorgroupschedulecommand in user EXEC or privileged EXEC mode.
(Optional) Number of the IP SLAs group operation to display.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.3(14)T
This command was introduced.
12.4(4)T
This command was replaced by the
showipslagroupschedulecommand.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the
showrtrgroupschedule command.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was replaced by the
showipslagroupschedulecommand.
12.2(33)SXI
This command was replaced by the
showipslagroupschedulecommand.
Examples
The following is sample output from the
showipslamonitorgroupschedule command that shows information about group (multiple) scheduling. The last line in the example indicates that the IP SLAs operations are multiple scheduled (TRUE):
Router# show ip sla monitor group schedule
Multi-Scheduling Configuration:
Group Entry Number: 1
Probes to be scheduled: 2,3,4,9-30,89
Schedule period :60
Group operation frequency: 30
Multi-scheduled: TRUE
The following is sample output from the
showipslamonitorgroupschedule command that shows information about group (multiple) scheduling, with the frequency value the same as the schedule period value, the life value as 3600 seconds, and the ageout value as never:
Router# show ip sla monitor group schedule
Group Entry Number: 1
Probes to be scheduled: 3,4,6-10
Total number of probes: 7
Schedule period: 20
Group operation frequency: Equals schedule period
Status of entry (SNMP RowStatus): Active
Next Scheduled Start Time: Start Time already passed
Life (seconds): 3600
Entry Ageout (seconds): never
The table below describes the significant fields shown in the displays.
Table 18 show ip sla monitor group schedule Field Descriptions
Field
Description
Group Entry Number
The operation group number specified for IP SLAs multiple operations scheduling.
Probes to be scheduled
The operations numbers specified in the operation group 1.
Scheduled period
The time (in seconds) for which the IP SLAs group is scheduled.
Group operation frequency
The frequency at which each operation is started.
Multi-scheduled
The value TRUE shows that group scheduling is active.
Related Commands
Command
Description
showipslamonitorconfiguration
Displays the configuration details for IP SLAs operations.
show ip sla monitor history
Note
Effective with Cisco IOS Release 12.4(4)T, 12.2(33)SB, and 12.2(33)SXI, the
showipslamonitorhistorycommand is replaced by the
showipslahistorycommand. See the
showipslahistorycommand for more information.
To display history collected for all Cisco IOS IP Service Level Agreements (SLAs) operations or for a specified operation, use the
showipslamonitorhistorycommand in user EXEC or privileged EXEC mode.
showipslamonitorhistory [operation-number]
[ tabular | full ]
Syntax Description
operation-number
(Optional) Number of the operation for which history details is displayed.
tabular
(Optional) Displays information in a column format, reducing the number of screens required to display the information. This is the default.
full
(Optional) Displays all information, using identifiers next to each displayed value.
Command Default
Tabular format history for all operations is displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.3(14)T
This command was introduced.
12.4(4)T
This command was replaced by the
showipslahistorycommand.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the
showrtrhistory command.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was replaced by the
showipslahistorycommand.
12.2(33)SXI
This command was replaced by the
showipslahistorycommand.
Usage Guidelines
The table below lists the Response Return values used in the output of the
showipslamonitorhistory command. If the default (tabular) format is used, the Response Return description is displayed as a code in the Sense column. If the full format is used, the Response Return is displayed as indicated in the Description column.
Table 19 Response Return (Sense Column) Codes
Code
Description
1
Okay.
2
Disconnected.
3
Over threshold.
4
Timeout.
5
Busy.
6
Not connected.
7
Dropped.
8
Sequence error.
9
Verify error.
10
Application specific.
Examples
The following is sample output from the
showipslamonitorhistorycommand in tabular format:
Router# show ip sla monitor history
Point by point History
Multiple Lines per Entry
Line 1
Entry = Entry Number
LifeI = Life Index
BucketI = Bucket Index
SampleI = Sample Index
SampleT = Sample Start Time
CompT = Completion Time (milliseconds)
Sense = Response Return Code
Line 2 has the Target Address
Entry LifeI BucketI SampleI SampleT CompT Sense
2 1 1 1 17436548 16 1
AB 45 A0 16
2 1 2 1 17436551 4 1
AC 12 7 29
2 1 2 2 17436551 1 1
AC 12 5 22
2 1 2 3 17436552 4 1
AB 45 A7 22
2 1 2 4 17436552 4 1
AB 45 A0 16
Related Commands
Command
Description
showipslamonitorconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
show ip sla monitor mpls-lsp-monitor collection-statistics
Note
Effective with Cisco IOS Release 12.2(33)SB, the
showipslamonitormpls-lsp-monitorcollection-statisticscommand is replaced by the
showipslampls-lsp-monitorcollection-statisticscommand. See the
showipslampls-lsp-monitorcollection-statisticscommand for more information.
To display the statistics for Cisco IOS IP Service Level Agreements (SLAs) operations belonging to a label switched path (LSP) discovery group of an LSP Health Monitor operation, use the
showipslamonitormpls-lsp-monitorcollection-statisticscommand in user EXEC or privileged EXEC mode.
(Optional) Identification number of the LSP discovery group for which the details will be displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(31)SB2
This command was introduced.
12.2(33)SB
This command was replaced by the
showipslampls-lsp-monitorcollection-statisticscommand.
Usage Guidelines
Use the
showipslamonitormpls-lsp-monitorcollection-statisticscommand if the LSP discovery option is enabled for an LSP Health Monitor operation. This command is not applicable if the LSP discovery option is disabled.
When the LSP discovery option is enabled, an individual IP SLAs operation is created by the LSP Health Monitor for each equal-cost multipath belonging to an LSP discovery group of a particular LSP Health Monitor operation. The network connectivity statistics collected by each individual IP SLAs operation are 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 group for a given one-hour increment.
Examples
The following is sample output from the
showipslamonitormpls-lsp-monitorcollection-statistics command:
Router# show ip sla monitor mpls-lsp-monitor collection-statistics 100001
Entry number: 100001
Start Time Index: *19:32:37.995 EST Mon Feb 28 2005
Path Discovery Start Time: *20:23:43.919 EST Mon Feb 28 2005
Target destination IP address: 10.131.161.251
Path Discovery Status: OK
Path Discovery Completion Time: 1772
Path Discovery Minimum Paths: 12
Path Discovery Maximum Paths: 12
LSP Group Index: 100001
LSP Group Status: up
Total Pass: 1225
Total Timeout: 0 Total Fail: 0
Latest probe status: 'up,up,up,up,up,up,up,up,up,up,up,up'
Latest Path Identifier: '127.0.0.13-Se3/0-38,127.0.0.6-Se3/0-38,127.0.0.1-Se3/0-38,127.0.0.2-Se3/0-38,127.0.0.4-Se3/0-38,127.0.0.5-Se3/0-38,127.0.0.13-Se4/0-38,127.0.0.6-Se4/0-38,127.0.0.1-Se4/0-38,127.0.0.2-Se4/0-38,127.0.0.4-Se4/0-38,127.0.0.5-Se4/0-38'
Minimum RTT: 24 Maximum RTT: 100 Average RTT: 42
The table below describes the significant fields shown in the display.
Table 20 show ip sla monitor mpls-lsp-monitor collection-statistics Field Descriptions
Field
Description
Entry number
Identification number of the LSP discovery group.
Start Time Index
Start time of the LSP Health Monitor operation.
Path Discovery Start Time
Time in which the most recent iteration of LSP discovery started.
Target destination IP address
IP address of the Border Gateway Protocol (BGP) next hop neighbor.
Path Discovery Status
Return code of the most recent iteration of LSP discovery.
Path Discovery Completion Time
Amount of time (in milliseconds) it took to complete the most recent iteration of the LSP discovery process.
Path Discovery Minimum Paths
Minimum number of equal-cost multipaths discovered by the LSP discovery process.
Path Discovery Maximum Paths
Maximum number of equal-cost multipaths discovered by the LSP discovery process.
LSP Group Index
Identification number of the LSP discovery group.
LSP Group Status
Operation status of the LSP discovery group.
Total Pass
Total number of LSP discovery process iterations.
Total Timeout
Total number of LSPs in which a timeout violation was reported.
Total Fail
Total number of LSPs in which an operation failure was reported.
Latest probe status
Current operation status for each IP SLAs operation belonging to the specified LSP discovery group.
Latest Path Identifier
Current identification information (IP address used to select the LSP, outgoing interface, and label stack) for each IP SLAs operation belonging to the specified LSP discovery group.
Minimum RTT
Minimum round-trip time (in milliseconds) measured by the IP SLAs operations associated with the specified LSP discovery group.
Maximum RTT
Maximum round-trip time (in milliseconds) measured by the IP SLAs operations associated with the specified LSP discovery group.
Average RTT
Average round-trip time (in milliseconds) for all the IP SLAs operations associated with the specified LSP discovery group.
Related Commands
Command
Description
autoipslampls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters auto IP SLA MPLS configuration mode.
show ip sla monitor mpls-lsp-monitor configuration
Note
Effective with Cisco IOS Release 12.2(33)SB, the
showipslamonitormpls-lsp-monitorconfigurationcommand is replaced by the
showipslampls-lsp-monitorconfigurationcommand. See the
showipslampls-lsp-monitorconfigurationcommand for more information.
To display configuration settings for IP Service Level Agreements (SLAs) label switched path (LSP) Health Monitor operations, use the
showipslamonitormpls-lsp-monitorconfiguration command in user EXEC or privileged EXEC mode.
(Optional) Number of the LSP Health Monitor operation for which the details will be displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(31)SB2
This command was introduced. This command replaces the
showrtrmpls-lsp-monitorconfiguration command.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was replaced by the
showipslampls-lsp-monitorconfigurationcommand.
Usage Guidelines
If the identification number of an LSP Health Monitor operation is not specified, configuration values for all the configured LSP Health Monitor operations will be displayed.
Examples
The following is sample output from the
showipslamonitormpls-lsp-monitorconfiguration command:
Router# show ip sla monitor mpls-lsp-monitor configuration 1
Entry Number : 1
Modification time : *12:18:21.830 PDT Fri Aug 19 2005
Operation Type : echo
Vrf Name : ipsla-vrf-all
Tag :
EXP Value : 0
Timeout(ms) : 1000
Threshold(ms) : 5000
Frequency(sec) : Equals schedule period
LSP Selector : 127.0.0.1
ScanInterval(min) : 1
Delete Scan Factor : 1
Operations List : 100001-100003
Schedule Period(sec): 60
Request size : 100
Start Time : Start Time already passed
SNMP RowStatus : Active
TTL value : 255
Reply Mode : ipv4
Reply Dscp Bits :
Secondary Frequency : Enabled on Timeout
Value(sec) : 10
Reaction Configs :
Reaction : connectionLoss
Threshold Type : Consecutive
Threshold Count : 3
Action Type : Trap Only
Reaction : timeout
Threshold Type : Consecutive
Threshold Count : 3
Action Type : Trap Only
The following is sample output from the
showipslamonitormpls-lsp-monitorconfiguration command when the LSP discovery option is configured:
Router# show ip sla monitor mpls-lsp-monitor configuration 100
Entry Number : 100
Modification time : *21:50:16.411 GMT Tue Jun 20 2006
Operation Type : echo
Vrf Name : saa-vrf-all
Tag :
EXP Value : 0
Timeout(ms) : 5000
Threshold(ms) : 50
Frequency(sec) : Equals schedule period
ScanInterval(min) : 1
Delete Scan Factor : 1
Operations List : 100002
Schedule Period(sec): 30
Request size : 100
Start Time : Start Time already passed
SNMP RowStatus : Active
TTL value : 255
Reply Mode : ipv4
Reply Dscp Bits :
Path Discover : Enable
Maximum sessions : 1
Session Timeout(seconds) : 120
Base LSP Selector : 127.0.0.1
Echo Timeout(seconds) : 5
Send Interval(msec) : 0
Label Shimming Mode : force-explicit-null
Number of Stats Hours : 2
Scan Period(minutes) : 3
Secondary Frequency : Enabled on Connection Loss and Timeout
Value(sec) : 5
Reaction Configs :
Reaction : Lpd Group
Retry Number : 3
Action Type : Trap Only
The table below describes the significant fields shown in the displays.
Table 21 show ip sla monitor mpls-lsp-monitor configuration Field Descriptions
Field
Description
Entry Number
Identification number for the LSP Health Monitor operation.
Operation Type
Type of IP SLAs operation configured by the LSP Health Monitor operation.
Vrf Name
If a specific name is displayed in this field, then the LSP Health Monitor is configured to discover only those Border Gateway Protocol (BGP) next hop neighbors in use by the VPN routing or forwarding instance (VRF) specified.
If saa-vrf-all is displayed in this field, then the LSP Health Monitor is configured to discover all BGP next hop neighbors in use by all VRFs associated with the source Provider Edge (PE) router.
Tag
User-specified identifier for the LSP Health Monitor operation.
EXP Value
Experimental field value in the header for an echo request packet of the IP SLAs operation.
Timeout(ms)
Amount of time the IP SLAs operation waits for a response from its request packet.
Threshold(ms)
Threshold value of the IP SLAs operation for which a reaction event is generated if violated.
Frequency(sec)
Time after which the IP SLAs operation is restarted.
LSP Selector
Local host IP address used to select the LSP for the IP SLAs operation.
ScanInterval(min)
Time interval at which the LSP Health Monitor checks the scan queue for BGP next hop neighbor updates.
Delete Scan Factor
Specifies the number of times the LSP Health Monitor should check the scan queue before automatically deleting IP SLAs operations for BGP next hop neighbors that are no longer valid.
Operations List
Identification numbers IP SLAs operations created by the LSP Health Monitor operation.
Schedule Period(sec)
Amount of time for which the LSP Health Monitor operation is scheduled.
Request size
Protocol data size for the request packet of the IP SLAs operation.
Start Time
Status of the start time for the LSP Health Monitor operation.
SNMP RowStatus
Indicates whether SNMP RowStatus is active or inactive.
TTL value
The maximum hop count for an echo request packet of the IP SLAs operation.
Reply Mode
Reply mode for an echo request packet of the IP SLAs operation.
Reply Dscp Bits
Differentiated services codepoint (DSCP) value of an echo reply packet of the IP SLAs operation.
Path Discover
Indicates whether the LSP discovery option is enabled.
Maximum sessions
Maximum number of BGP next hop neighbors that can be concurrently undergoing LSP discovery for a single LSP Health Monitor operation.
Session Timeout (seconds)
The amount of time the LSP discovery process waits for a response to its LSP discovery request for a particular BGP next hop neighbor.
Base LSP Selector
The base IP address used to select the LSPs of the LSP discovery groups.
Echo Timeout (seconds)
The amount of time the LSP discovery process waits for a response to its echo request packets.
Send Interval (msec)
The time interval (in milliseconds) between MPLS echo requests that are sent as part of the LSP discovery process.
Label Shimming Mode
Indicates whether the MPLS explicit null label option is enabled for the echo request packets.
Number of Stats Hours
The number of hours for which LSP discovery group statistics are maintained.
Scan Period (minutes)
The amount of time after which the LSP discovery process can restart.
Secondary Frequency
Reaction condition that will enable the secondary frequency option.
Value(sec)
Secondary frequency value.
Reaction Configs
The configured proactive threshold monitoring settings for the IP SLAs operation.
Reaction
Reaction condition being monitored.
Retry Number
Indicates the number of times the equal-cost multipaths belonging to an LSP discovery group are retested when a reaction condition is detected.
Threshold Type
Specifies when an action should be performed as a result of a reaction event.
Threshold Count
The number of times a reaction condition can occur before an action should be performed.
Action Type
Type of action that should be performed as a result of a reaction event.
Related Commands
Command
Description
autoipslampls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters auto IP SLA MPLS configuration mode.
autoipslampls-lsp-monitorreaction-configuration
Configures proactive threshold monitoring parameters for an IP SLAs LSP Health Monitor operation.
autoipslampls-lsp-monitorschedule
Configures the scheduling parameters for an IP SLAs LSP Health Monitor operation.
show ip sla monitor mpls-lsp-monitor lpd operational-state
Note
Effective with Cisco IOS Release 12.2(33)SB, the
showipslamonitormpls-lsp-monitorlpdoperational-statecommand is replaced by the
showipslampls-lsp-monitorlpdoperational-statecommand. See the
showipslampls-lsp-monitorlpdoperational-statecommand for more information.
To display the operational status of the label switched path (LSP) discovery groups belonging to an IP Service Level Agreements (SLAs) LSP Health Monitor operation, use the
showipslamonitormpls-lsp-monitorlpdoperational-statecommand in user EXEC or privileged EXEC mode.
(Optional) Identification number of the LSP discovery group for which the details will be displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(31)SB2
This command was introduced.
12.2(33)SB
This command was replaced by the
showipslampls-lsp-monitorlpdoperational-statecommand.
Usage Guidelines
Use the
showipslamonitormpls-lsp-monitorlpdoperational-statecommand if the LSP discovery option is enabled for an LSP Health Monitor operation. This command is not applicable if the LSP discovery option is disabled.
Examples
The following is sample output from the
showipslamonitormpls-lsp-monitorlpdoperational-state command:
Router# show ip sla monitor mpls-lsp-monitor lpd operational-state 100001
Entry number: 100001
MPLSLM Entry Number: 1
Target FEC Type: LDP IPv4 prefix
Target Address: 192.168.1.11
Number of Statistic Hours Kept: 2
Last time LPD Stats were reset: *21:21:18.239 GMT Tue Jun 20 2006
Traps Type: 3
Latest Path Discovery Mode: rediscovery complete
Latest Path Discovery Start Time: *21:59:04.475 GMT Tue Jun 20 2006
Latest Path Discovery Return Code: OK
Latest Path Discovery Completion Time(ms): 3092
Number of Paths Discovered: 3
Path Information :
Path Outgoing Lsp Link Conn Adj Downstream
Index Interface Selector Type Id Addr Label Stack Status
1 Et0/0 127.0.0.8 90 0 10.10.18.30 21 OK
2 Et0/0 127.0.0.2 90 0 10.10.18.30 21 OK
3 Et0/0 127.0.0.1 90 0 10.10.18.30 21 OK
The table below describes the significant fields shown in the display.
Table 22 show ip sla monitor mpls-lsp-monitor lpd operational-state Field Descriptions
Field
Description
Entry number
Identification number of the LSP discovery group.
MPLSLM Entry number
Identification number of the LSP Health Monitor operation.
Target FEC Type
The Forward Equivalence Class (FEC) type of the BGP next hop neighbor.
Target Address
IP address of the Border Gateway Protocol (BGP) next hop neighbor.
Number of Statistic Hours Kept
The amount of time (in hours) in which LSP discovery group statistics will be maintained. Use the
hours-of-statistics-kept command to configure this value.
Traps Type
Trap type values indicate the type of threshold monitoring that has been enabled using the
autoipslampls-lsp-monitorreaction-configuration command. Trap type values are defined as follows:
1--timeout
2--connection loss
3--LSP discovery group status changes
4--LSP discovery failure
Latest Path Discovery Mode
Current mode of the LSP discovery process. Modes include initial discovery, initial complete, rediscovery running, and rediscovery complete.
Latest Path Discovery Start Time
Time in which the most recent iteration of LSP discovery started.
Latest Path Discovery Return Code
Return code for the most recent iteration of LSP discovery.
Latest Path Discovery Completion Time
Amount of time (in milliseconds) it took to complete the most recent iteration of the LSP discovery process.
Number of Paths Discovered
Number of equal-cost multipaths discovered during the most recent iteration of the LSP discovery process.
Path Index
Identification number for the equal-cost multipath.
Outgoing Interface
Outgoing interface of the echo request packet.
Lsp Selector
IP address used to select the LSP.
Adj Addr
IP address of the next hop physical interface.
Downstream Label Stack
Downstream MPLS label stack number.
Status
Return code for the most recent IP SLAs LSP ping operation of the specified equal-cost multipath.
Related Commands
Command
Description
autoipslampls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters auto IP SLA MPLS configuration mode.
show ip sla monitor mpls-lsp-monitor neighbors
Note
Effective with Cisco IOS Release 12.2(33)SB, the
showipslamonitormpls-lsp-monitorneighborscommand is replaced by the
showipslampls-lsp-monitorneighborscommand. See the
showipslampls-lsp-monitorneighborscommand for more information.
To display routing and connectivity information about Multiprotocol Label Switching (MPLS) Virtual Private Network (VPN) Border Gateway Protocol (BGP) next hop neighbors discovered by the IP Service Level Agreements (SLAs) label switched path (LSP) Health Monitor, use the
showipslamonitormpls-lsp-monitorneighbors command in user EXEC or privileged EXEC mode.
showipslamonitormpls-lsp-monitorneighbors
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(31)SB2
This command was introduced. This command replaces the
showrtrmpls-lsp-monitorneighbors command.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was replaced by the
showipslampls-lsp-monitorneighborscommand.
Examples
The following is sample output from the
showipslamonitormpls-lsp-monitorneighborscommand:
Router# show ip sla monitor mpls-lsp-monitor neighbors
IP SLA MPLS LSP Monitor Database : 1
BGP Next hop 10.10.10.5 (Prefix: 10.10.10.5/32) OK
ProbeID: 100001 (red, blue, green)
BGP Next hop 10.10.10.7 (Prefix: 10.10.10.7/32) OK
ProbeID: 100002 (red, blue, green)
BGP Next hop 10.10.10.8 (Prefix: 10.10.10.8/32) OK
ProbeID: 100003 (red, blue, green)
The table below describes the significant fields shown in the display.
Table 23 show ip sla monitor mpls-lsp-monitor neighbors Field Descriptions
Field
Description
BGP Next hop
Identifier for the BGP next hop neighbor.
Prefix
IPv4 Forward Equivalence Class (FEC) of the BGP next hop neighbor to be used by the MPLS LSP ping operation.
ProbeID
The identification number of the IP SLAs operation. The names of the VPN routing or forwarding instances (VRFs) that contain routing entries for the specified BGP next hop neighbor are listed in parentheses.
OK
LSP ping or LSP traceroute connectivity status between the source Provider Edge (PE) router and specified BGP next hop neighbor. Connectivity status can be the following:
OK--Successful reply.
ConnectionLoss--Reply is from a device that is not egress for the Forward Equivalence Class (FEC).
Timeout--Echo request timeout.
Unknown--State of LSP is not known.
Related Commands
Command
Description
autoipslampls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters auto IP SLA MPLS configuration mode.
show ip sla monitor mpls-lsp-monitor scan-queue
Note
Effective with Cisco IOS Release 12.2(33)SB, the
showipslamonitormpls-lsp-monitorscan-queuecommand is replaced by the
showipslampls-lsp-monitorscan-queuecommand. See the
showipslampls-lsp-monitorscan-queuecommand for more information.
To display information about adding or deleting Border Gateway Protocol (BGP) next hop neighbors from a particular Multiprotocol Label Switching (MPLS) Virtual Private Network (VPN) of an IP Service Level Agreements (SLAs) LSP Health Monitor operation, use the
showipslamonitormpls-lsp-monitorscan-queue command in user EXEC or privileged EXEC mode.
Number of the LSP Health Monitor operation for which the details will be displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(31)SB2
This command was introduced. This command replaces the
showrtrmpls-lsp-monitorscan-queue command.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was replaced by the
showipslampls-lsp-monitorscan-queuecommand.
Examples
The following is sample output from the
showipslamonitormpls-lsp-monitorscan-queue command:
Router# show ip sla monitor mpls-lsp-monitor scan-queue 1
Next scan Time after: 23 Secs
Next Delete scan Time after: 83 Secs
BGP Next hop Prefix vrf Add/Delete?
10.10.10.8 10.10.10.8/32 red Add
10.10.10.8 10.10.10.8/32 blue Add
10.10.10.8 10.10.10.8/32 green Add
The table below describes the significant fields shown in the display.
Table 24 show ip sla monitor mpls-lsp-monitor scan-queue Field Descriptions
Field
Description
Next scan Time after
Amount of time left before the LSP Health Monitor checks the scan queue for information about adding BGP next hop neighbors to a particular VPN. At the start of each scan time, IP SLAs operations are created for all newly discovered neighbors.
Next Delete scan Time after
Amount of time left before the LSP Health Monitor checks the scan queue for information about deleting BGP next hop neighbors from a particular VPN. At the start of each delete scan time, IP SLAs operations are deleted for neighbors that are no longer valid.
BGP Next hop
Identifier for the BGP next hop neighbor.
Prefix
IPv4 Forward Equivalence Class (FEC) of the BGP next hop neighbor to be used by the MPLS LSP ping operation.
vrf
Name of the VPN routing or forwarding instance (VRF) that contains a routing entry for the specified BGP next hop neighbor.
Add/Delete
Indicates that the specified BGP next hop neighbor will be added to or removed from the specified VPN.
Related Commands
Command
Description
autoipslampls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters auto IP SLA MPLS configuration mode.
delete-scan-factor
Specifies the number of times the LSP Health Monitor should check the scan queue before automatically deleting IP SLAs operations for BGP next hop neighbors that are no longer valid.
mplsdiscoveryvpninterval
Specifies the time interval at which routing entries that are no longer valid are removed from the BGP next hop neighbor discovery database of an MPLS VPN.
scan-interval
Specifies the time interval (in minutes) at which the LSP Health Monitor checks the scan queue for BGP next hop neighbor updates.
show ip sla monitor mpls-lsp-monitor summary
Note
Effective with Cisco IOS Release 12.2(33)SB, the
showipslamonitormpls-lsp-monitorsummarycommand is replaced by the
showipslampls-lsp-monitorsummarycommand. See the
showipslampls-lsp-monitorsummarycommand for more information.
To display Border Gateway Protocol (BGP) next hop neighbor and label switched path (LSP) discovery group information for IP Service Level Agreements (SLAs) LSP Health Monitor operations, use the
showipslamonitormpls-lsp-monitorsummarycommand in user EXEC or privileged EXEC mode.
showipslamonitormpls-lsp-monitorsummary
[ operation-number
[ group [group-id] ] ]
Syntax Description
operation-number
(Optional) Number of the LSP Health Monitor operation for which the details will be displayed.
groupgroup-id
(Optional) Specifies the identification number of the LSP discovery group for which the details will be displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(31)SB2
This command was introduced.
12.2(33)SB
This command was replaced by the
showipslampls-lsp-monitorsummarycommand.
Usage Guidelines
Use the
showipslamonitormpls-lsp-monitorsummarycommand if the LSP discovery option is enabled for an LSP Health Monitor operation. This command is not applicable if the LSP discovery option is disabled.
Examples
The following is sample output from the
showipslamonitormpls-lsp-monitorsummaryoperation-number command:
Router# show ip sla monitor mpls-lsp-monitor summary 1
Index - MPLS LSP Monitor probe index.
Destination - Target IP address of the BGP Next Hop.
Status - LPD Group Status.
LPD Group ID - Unique index to identify the LPD Group.
Last Operation Time - Last time an operation was attempted by a particular probe in the LPD group.
Index Destination Status LPD Group ID Last Operation Time
1 100.1.1.1 up 100001 19:33:37.915 EST Mon Feb 28 2005
2 100.1.1.2 down 100002 19:33:47.915 EST Mon Feb 28 2005
3 100.1.1.3 retry 100003 19:33:57.915 EST Mon Feb 28 2005
4 100.1.1.4 partial 100004 19:34:07.915 EST Mon Feb 28 2005
The following is sample output from the
showipslamonitormpls-lsp-monitorsummaryoperation-numbergroupgroup-id command:
Router# show ip sla monitor mpls-lsp-monitor summary 1 group 100001
Group ID - Unique number to identify a LPD group
Lsp-selector - Unique 127/8 address used to identify an LPD.
Latest operation status - Latest probe status.
Last Operation time - Time when the last operation was attempted.
Group ID Lsp-Selector Status Failures Successes RTT Last Operation Time
100001 127.0.0.13 up 0 78 32 *20:11:37.895 EST Mon Feb 28 2005
100001 127.0.0.15 up 0 78 32 *20:11:37.995 EST Mon Feb 28 2005
100001 127.0.0.16 up 0 78 32 *20:11:38.067 EST Mon Feb 28 2005
100001 127.0.0.26 up 0 78 32 *20:11:38.175 EST Mon Feb 28 2005
The table below describes the significant fields shown in the display.
Table 25 show ip sla monitor mpls-lsp-monitor summary Field Descriptions
Field
Description
Failures
Number of times the IP SLAs operation for the specified LSP failed to report an RTT value.
Successes
Number of times the IP SLAs operation for the specified LSP successfully reported an RTT value.
RTT
Average round-trip time (in milliseconds) for the specified LSP.
Related Commands
Command
Description
autoipslampls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters auto IP SLA MPLS configuration mode.
show ip sla monitor reaction-configuration
Note
Effective with Cisco IOS Release 12.4(4)T, 12.2(33)SB, and 12.2(33)SXI, the
showipslamonitorreaction-configurationcommand is replaced by the
showipslareaction-configurationcommand. See the
showipslareaction-configurationcommand for more information.
To display the configured proactive threshold monitoring settings for all Cisco IOS IP Service Level Agreements (SLAs) operations or a specified operation, use the
showipslamonitorreaction-configuration command in user EXEC or privileged EXEC mode.
(Optional) Number of the operation for which the reaction configuration characteristics is displayed.
Command Default
Displays configured proactive threshold monitoring settings for all IP SLAs operations.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.3(14)T
This command was introduced.
12.4(4)T
This command was replaced by the
showipslareaction-configurationcommand.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the
showrtrreaction-configuration command.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was replaced by the
showipslareaction-configurationcommand.
12.2(33)SXI
This command was replaced by the
showipslareaction-configurationcommand.
Usage Guidelines
Use the
ipslamonitorreaction-configuration command in global configuration mode to configure the proactive threshold monitoring parameters for an IP SLAs operations.
Examples
In the following example, multiple monitored elements (indicated by the Reaction values) are configured for a single IP SLAs operation:
The table below describes the significant fields shown in the display.
Table 26 show ip sla monitor reaction-configuration Field Descriptions
Field
Description
Reaction
The monitored element configured for the specified IP SLAs operation.
Corresponds to the
react{connectionLoss |
jitterAvg |
jitterDSAvg |
jitterSDAvg |
mos |
PacketLossDS |
PacketLossSD |
rtt |
timeout |
verifyError} syntax in the
ipslamonitorreaction-configuration command.
Threshold type
The configured threshold type.
Corresponds to the
threshold-type {never |
immediate |
consecutive |
xofy |
average} syntax in the
ipslamonitorreaction-configuration command.
Rising (milliseconds)
The
upper-threshold value.
Corresponds to the
threshold-valueupper-thresholdlower-threshold syntax in the
ipslamonitorreaction-configuration command.
Falling (milliseconds)
The
lower-threshold value.
Corresponds to the
threshold-valueupper-thresholdlower-threshold syntax in the
ipslamonitorreaction-configuration command.
Threshold Count
The
x-value in the
xofy threshold type, or the
number-of-measurements value for the
average threshold type.
Threshold Count2
The
y-value in the
xofy threshold type.
Action Type
The reaction to be performed when the violation conditions are met.
Corresponds to the
action-type {none |
trapOnly |
triggerOnly |
trapAndTrigger} syntax in the
ipslamonitorreaction-configuration command.
Related Commands
Command
Description
ipslamonitorreaction-configuration
Configures proactive threshold monitoring parameters for an IP SLAs operation.
show ip sla monitor reaction-trigger
Note
Effective with Cisco IOS Release 12.4(4)T, 12.2(33)SB, and 12.2(33)SXI, the showipslamonitorreaction-triggercommand is replaced by the showipslareaction-triggercommand. See the showipslareaction-triggercommand for more information.
To display the reaction trigger information for all Cisco IOS IP Service Level Agreements (SLAs) operations or the specified operation, use the showipslamonitorreaction-trigger command in user EXEC or privileged EXEC mode.
(Optional) Number of the IP SLAs operation to display.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.3(14)T
This command was introduced.
12.4(4)T
This command was replaced by the showipslareaction-triggercommand.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the showrtrreaction-trigger command.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was replaced by the showipslareaction-triggercommand.
12.2(33)SXI
This command was replaced by the showipslareaction-triggercommand.
Usage Guidelines
Use the showipslamonitorreaction-trigger command to display the configuration status and operational state of target operations that will be triggered as defined with the ipslamonitorreaction-configuration global configuration command.
Examples
The following is sample output from the showipslamonitorreaction-trigger command:
Router# show ip sla monitor reaction-trigger 1
Reaction Table
Entry Number: 1
Target Entry Number: 2
Status of Entry (SNMP RowStatus): active
Operational State: pending
Related Commands
Command
Description
showipslamonitorconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
show ip sla monitor responder
Note
Effective with Cisco IOS Release 12.4(4)T, 12.2(33)SB, and 12.2(33)SXI, the showipslamonitorrespondercommand is replaced by the showipslarespondercommand. See the showipslarespondercommand for more information.
To display information about the Cisco IOS IP Service Level Agreements (SLAs) Responder, use the showipslamonitorresponder command in user EXEC or privileged EXEC mode.
showipslamonitorresponder
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.3(14)T
This command was introduced.
12.4(4)T
This command was replaced by the showipslarespondercommand.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the showrtrresponder command.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was replaced by the showipslarespondercommand.
12.2(33)SXI
This command was replaced by the showipslarespondercommand.
Usage Guidelines
Use the showipslamonitorrespondercommand to display information about recent sources of IP SLAs control messages, such as who has sent recent control messages and who has sent invalid control messages.
Examples
The following is sample output from the showipslamonitorresponder command:
Router# show ip sla monitor responder
IP SLA Monitor Responder is: Enabled
Number of control message received: 19 Number of errors: 1
Recent sources:
10.0.0.1 [19:11:49.035 UTC Sat Dec 2 1995]
10.0.0.1 [19:10:49.023 UTC Sat Dec 2 1995]
10.0.0.1 [19:09:48.707 UTC Sat Dec 2 1995]
10.0.0.1 [19:08:48.687 UTC Sat Dec 2 1995]
10.0.0.1 [19:07:48.671 UTC Sat Dec 2 1995]
Recent error sources:
10.0.0.1 [19:10:49.023 UTC Sat Dec 2 1995] RTT_AUTH_FAIL
Related Commands
Command
Description
showipslamonitorconfiguration
Displays configuration values for IP SLAs operations.
show ip sla monitor statistics
Note
Effective with Cisco IOS Release 12.4(4)T, 12.2(33)SB, and 12.2(33)SXI, the
showipslamonitorstatisticscommand is replaced by the
showipslastatisticscommand. See the
showipslastatisticscommand for more information.
To display the current operational status and statistics of all Cisco IOS IP Service Level Agreements (SLAs) operations or a specified operation, use the
showipslamonitorstatistics command in user EXEC or privileged EXEC mode.
(Optional) Number of the operation for which operational status and statistics are displayed.
details
(Optional) Operational status and statistics are displayed in greater detail.
Command Default
Displays output for all running IP SLAs operations.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.3(14)T
This command was introduced.
12.4(4)T
This command was replaced by the
showipslastatisticscommand.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the
showrtroperational-statecommand.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was replaced by the
showipslastatisticscommand.
12.2(33)SXI
This command was replaced by the
showipslastatisticscommand.
Usage Guidelines
Use the
showipslamonitorstatistics command to display the current state of IP SLAs operations, including how much life the operation has left, whether the operation is active, and the completion time. The output will also include the monitoring data returned for the last (most recently completed) operation.
Examples
The following is sample output from the
showipslamonitorstatistics command:
Router# showipslamonitorstatistics Current Operational State
Entry Number: 3
Modification Time: *22:15:43.000 UTC Sun Feb 11 2001
Diagnostics Text:
Last Time this Entry was Reset: Never
Number of Octets in use by this Entry: 1332
Number of Operations Attempted: 2
Current Seconds Left in Life: 3511
Operational State of Entry: active
Latest Completion Time (milliseconds): 544
Latest Operation Start Time: *22:16:43.000 UTC Sun Feb 11 2001
Latest Oper Sense: ok
Latest Sense Description: 200 OK
Total RTT: 544
DNS RTT: 12
TCP Connection RTT: 28
HTTP Transaction RTT: 504
HTTP Message Size: 9707
The following is sample output from the
showipslamonitorstatistics command when the specified operation is a UDP jitter (codec) operation. The values shown indicate the values for the last IP SLAs operation.
Router# showipslamonitorstatistics Current Operational State
Entry number: 10
Modification time: 12:57:45.690 UTC Sun Oct 26 2003
Number of operations attempted: 3
Number of operations skipped: 0
Current seconds left in Life: 3570
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
The table below describes the significant fields shown in the display.
Table 27 show ip sla monitor statistics Field Descriptions
Field
Description
Voice Scores
Indicates that Voice over IP statistics appear on the following lines. Voice score data is computed when the operation type is configured as
typejitter (codec).
ICPIF
The Calculated Planning Impairment Factor (ICPIF) value for the operation. The ICPIF value is computed by IP SLAs using the formula
Icpif=Io+Iq+Idte+Idd+Ie-A, where
The values for
Io ,
Iq , and
Idte are set to zero.
The value
Idd is computed based on the measured one-way delay.
The value
Ie is computed based on the measured packet loss.
The value of A is specified by the user.
ICPIF values are expressed in a typical range of 5 (very low impairment) to 55 (very high impairment). ICPIF values numerically lower than 20 are generally considered “adequate.”
Note
This value is intended only for relative comparisons, and may not match ICPIF values generated using alternate methods.
MOS Score
The estimated Mean Opinion Score (Conversational Quality, Estimated) for the latest iteration of the operation. The MOS-CQE is computed by IP SLAs as a function of the ICPIF.
MOS values are expressed as a number from 1 (1.00) to 5 (5.00), with 5 being the highest level of quality, and 1 being the lowest level of quality. A MOS value of 0 (zero) indicates that MOS data could not be generated for the operation.
RTT Values
Indicates that round-trip-time statistics appear on the following lines.
NumOfRTT
The number of successful round-trips.
RTTSum
The sum of all successful round-trip values (in milliseconds).
RTTSum2
The sum of squares of those round-trip values (in milliseconds).
PacketLossSD
The number of packets lost from source to destination.
PacketLossDS
The number of packets lost from destination to source.
PacketOutOfSequence
The number of packets returned out of order.
PacketMIA
The number of packets lost where the direction (SD/DS) cannot be determined.
PacketLateArrival
The number of packets that arrived after the timeout.
InternalError
The number of times an operation could not be started due to other internal failures.
Busies
The number of times this operation could not be started because the previously scheduled run was not finished.
Jitter Values:
Indicates that jitter statistics appear on the following lines. Jitter is interpacket delay variance.
NumOfJitterSamples
The number of jitter samples collected. This is the number of samples that are used to calculate the following jitter statistics.
MinOfPositivesSD MaxOfPositivesSD
The minimum and maximum positive jitter values from source to destination, in milliseconds.
NumOfPositivesSD
The number of jitter values from source to destination that are positive (that is, network latency increases for two consecutive test packets).
SumOfPositivesSD
The sum of those positive values (in milliseconds).
Sum2PositivesSD
The sum of squares of those positive values.
MinOfNegativesSD MaxOfNegativesSD
The minimum and maximum negative jitter values from source to destination. The absolute value is given.
NumOfNegativesSD
The number of jitter values from source to destination that are negative (that is, network latency decreases for two consecutive test packets).
SumOfNegativesSD
The sum of those values.
Sum2NegativesSD
The sum of the squares of those values.
Interarrival jitterout
The source-to-destination (SD) jitter value calculation, as defined in RFC 1889.
Interarrival jitterin
The destination-to-source (DS) jitter value calculation, as defined in RFC 1889.
One Way Values
Indicates that one-way measurement statistics appear on the following lines.
One Way (OW) values are the amount of time required for the packet to travel from the source router to the target router (SD) or from the target router to the source router (DS).
NumOfOW
Number of successful one-way time measurements.
OWMinSD
Minimum time (in milliseconds) from the source to the destination.
OWMaxSD
Maximum time (in milliseconds) from the source to the destination.
OWSumSD
Sum of the OWMinSD and OWMaxSD values.
OWSum2SD
Sum of the squares of the OWMinSD and OWMaxSD values.
Related Commands
Command
Description
showipslamonitorconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
show ip sla monitor statistics aggregated
Note
Effective with Cisco IOS Release 12.4(4)T, 12.2(33)SB, and 12.2(33)SXI, the showipslamonitorstatisticsaggregatedcommand is replaced by the showipslastatisticsaggregatedcommand. See the showipslastatisticsaggregatedcommand for more information.
To display the aggregated statistical errors and distribution information for all Cisco IOS IP Service Level Agreements (SLAs) operations or a specified operation, use the showipslamonitorstatisticsaggregatedcommand in user EXEC or privileged EXEC mode.
(Optional) Number of the IP SLAs operation to display.
details
(Optional) Aggregated statistical information is displayed in greater detail. Distribution information is included when this keyword is specified.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.4(2)T
This command was introduced.
12.4(4)T
This command was replaced by the showipslastatisticsaggregatedcommand.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the showrtrcollection-statistics command.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was replaced by the showipslastatisticsaggregatedcommand.
12.2(33)SXI
This command was replaced by the showipslastatisticsaggregatedcommand.
Usage Guidelines
Use this command to display information such as the number of failed operations and the failure reason. The distributions statistics consist of the following:
The sum of completion times (used to calculate the mean)
The sum of the completion times squared (used to calculate standard deviation)
The maximum and minimum completion time
The number of completed attempts
This command shows information collected over the past two hours, unless you specify a different amount of time using the hours-of-statistics-kept command.
Note
This command does not support the IP SLAs ICMP path jitter operation.
Examples
The following sections show sample output from the showipslamonitorstatisticsaggregated and showipslamonitorstatisticsaggregateddetailscommands for different IP SLAs operations.
Examples
The following example shows output from the showipslamonitorstatisticsaggregated and showipslamonitorstatisticsaggregateddetailscommands when the specified operation is a Hypertext Transfer Protocol (HTTP) operation:
Router# show ip sla monitor statistics aggregated 1
Round trip time (RTT) Index 3
DNS RTT: 3004 ms
TCP Connection RTT: 16 ms
HTTP Transaction RTT: 84 ms
Number of successes: 0
Number of failures: 1
Router# show ip sla monitor statistics aggregated 1 details
Round trip time (RTT) Index 3
DNS RTT: 3004
TCP Connection RTT: 0
HTTP Transaction RTT: 0
HTTP time to first byte: 0
DNS TimeOut: 0
TCP TimeOut: 0
Transaction TimeOut: 0
DNS Error: 0
TCP Error: 0
Number of successes: 0
Number of failures: 1
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/0/0/0
Failed Operations due to Internal/Sequence/Verify Error: 1/0/0
Distribution Statistics:
Bucket Range: 0-9 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10-19 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >20 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Examples
The following is sample output from the showipslamonitorstatisticsaggregated and showipslamonitorstatisticsaggregateddetailscommands when the specified operation is a User Datagram Protocol (UDP) jitter operation:
Router# show ip sla monitor statistics aggregated 2
Round trip time (RTT) Index 7
RTT Values
Number Of RTT: 10
RTT Min/Avg/Max: 1/1/2 ms
Latency one-way time milliseconds
Number of Latency one-way Samples: 0
Source to Destination Latency one way Latency Min/Avg/Max: 0/0/0 ms
Destination to source Latency one way Min/Avg/Max: 0/0/0 ms
Jitter time milliseconds
Number of Jitter Samples: 9
Source to Destination Jitter Min/Avg/Max: 1/1/1 ms
Destination to Source Jitter Min/Avg/Max: 1/1/1 ms
Packet Loss Values
Loss Source to Destination: 0 Loss Destination to Source: 0
Out Of Sequence: 0 Tail Drop: 0 Packet Late Arrival: 0
Number of successes: 1
Number of failures: 1
Router# show ip sla monitor statistics aggregated 2 details
Round trip time (RTT) Index 7
RTT Values
Number Of RTT: 10
RTT Min/Avg/Max: 1/1/1 ms
Latency one-way time milliseconds
Number of Latency one-way Samples: 0
Source to Destination Latency one way Min/Avg/Max: 0/0/0 ms
Destination to Source Latency one way Min/Avg/Max: 0/0/0 ms
Source to Destination Latency one way Sum/Sum2: 0/0
Destination to Source Latency one way Sum/Sum2: 0/0
Jitter time milliseconds
Number of Jitter Samples: 9
Source to Destination Jitter Min/Avg/Max: 1/1/1 ms
Destination to Source Jitter Min/Avg/Max: 1/1/1 ms
Source to destination positive jitter Min/Avg/Max: 1/1/1 ms
Source to destination positive jitter Number/Sum/Sum2: 1/1/1
Source to destination negative jitter Min/Avg/Max: 1/1/1 ms
Source to destination negative jitter Number/Sum/Sum2: 1/1/1
Destination to Source positive jitter Min/Avg/Max: 1/1/1 ms
Destination to Source positive jitter Number/Sum/Sum2: 2/2/2
Destination to Source negative jitter Min/Avg/Max: 1/1/1 ms
Destination to Source negative jitter Number/Sum/Sum2: 2/2/2
Interarrival jitterout: 0 Interarrival jitterin: 0
Packet Loss Values
Loss Source to Destination: 0 Loss Destination to Source: 0
Out Of Sequence: 0 Tail Drop: 0 Packet Late Arrival: 0
Number of successes: 3
Number of failures: 1
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/23/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Distribution Statistics:
Bucket Range: 0-9 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10-19 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >20 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Examples
The following is sample output from the showipslamonitorstatisticsaggregated and showipslamonitorstatisticsaggregateddetailscommands when the specified operation is an Internet Control Message Protocol (ICMP) echo operation:
Router# show ip sla monitor statistics aggregated 3
Round trip time (RTT)Index 3
Start Time Index: 05:31:12.896 PST Wed Sep 3 2003
RTT Values
Number Of RTT: 0
RTT Min/Avg/Max: 0/0/0 ms
Number of successes: 0
Number of failures: 21
Router# show ip sla monitor statistics aggregated 3 details
Round trip time (RTT)Index 3
Start Time Index: 05:31:12.897 PST Wed Sep 3 2003
RTT Values
Number Of RTT: 0
RTT Min/Avg/Max: 0/0/0 ms
Number of successes: 0
Number of failures: 23
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/23/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Distribution Statistics:
Bucket Range: 0-9 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10-19 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >20 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Examples
The following is sample output from the showipslamonitorstatisticsaggregated and showipslamonitorstatisticsaggregateddetailscommands when the specified operation is a Transmission Control Protocol (TCP) connect, Domain Name System (DNS), File Transfer Protocol (FTP), Dynamic Host Configuration Protocol (DHCP), or UDP echo operation:
Router# show ip sla monitor statistics aggregated 3
Round trip time (RTT)Index 3
Start Time Index: 05:31:12.896 PST Wed Sep 3 2003
Number of successes: 0
Number of failures: 21
Router# show ip sla monitor statistics aggregated 3 details
Round trip time (RTT)Index 3
Start Time Index: 05:31:12.897 PST Wed Sep 3 2003
Number of successes: 0
Number of failures: 23
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/23/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Distribution Statistics:
Bucket Range: 0-9 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10-19 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >20 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Examples
The following is sample output from the showipslamonitorstatisticsaggregated and showipslamonitorstatisticsaggregateddetailscommands when the specified operation is an ICMP path echo operation:
Router# show ip sla monitor statistics aggregated 3
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.896 PST Wed Sep 3 2003
Path Index: 1
Hop in Path Index: 1
Number of successes: 0
Number of failures: 21
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.896 PST Wed Sep 3 2003
Path Index: 2
Hop in Path Index: 1
Number of successes: 0
Number of failures: 21
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.896 PST Wed Sep 3 2003
Path Index: 2
Hop in Path Index: 2
Number of successes: 0
Number of failures: 21
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.896 PST Wed Sep 3 2003
Path Index: 2
Hop in Path Index: 3
Number of successes: 0
Number of failures: 21
.
.
.
Router# show ip sla monitor statistics aggregated 3 details
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.897 PST Wed Sep 3 2003
Path Index: 1
Hop in Path Index: 1
Number of successes: 0
Number of failures: 21
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/21/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Target Address: 10.4.23.44
Distribution Statistics:
Bucket Range: 0-9 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10-19 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >20 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.897 PST Wed Sep 3 2003
Path Index: 2
Hop in Path Index: 1
Number of successes: 0
Number of failures: 21
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/21/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Target Address: 10.4.23.44
Distribution Statistics:
Bucket Range: 0-9 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10-19 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >20 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.897 PST Wed Sep 3 2003
Path Index: 2
Hop in Path Index: 2
Number of successes: 0
Number of failures: 21
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/21/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Target Address: 10.4.23.44
Distribution Statistics:
Bucket Range: 0-9 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10-19 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >20 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.897 PST Wed Sep 3 2003
Path Index: 2
Hop in Path Index: 3
Number of successes: 0
Number of failures: 21
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/21/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Target Address: 10.4.23.44
Distribution Statistics:
Bucket Range: 0-9 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10-19 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >20 ms:
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
.
.
.
Related Commands
Command
Description
hours-of-statistics-kept
Sets the number of hours for which statistics are maintained for the IP SLAs operation.
showipslamonitorconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
show ip sla monitor totals-statistics
Note
Effective with Cisco IOS Release 12.4(2)T, the showipslamonitortotals-statisticscommand is replaced by the showipslamonitorstatisticsaggregatedcommand. See the showipslastatisticsaggregatedcommand for more information.
To display the total statistical values (accumulation of error counts and completions) for all Cisco IOS IP Service Level Agreements (SLAs) operations or the specified operation, use the showipslamonitortotals-statistics command in user EXEC or privileged EXEC mode.
showipslamonitortotals-statistics [number]
[ tabular | full ]
Syntax Description
number
(Optional) Number of the
IP SLAs
operation to display.
tabular
(Optional) Display information in a column format, reducing the number of screens required to display the information.
full
(Optional) Display all information, using identifiers next to each displayed value. This is the default.
Command Default
Full format for all operations
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.3(14)T
This command was introduced.
12.4(2)T
This command was replaced by the showipslamonitorstatisticsaggregated command.
Usage Guidelines
The total statistics consist of the following items:
The operation number
The start time of the current hour of statistics
The age of the current hour of statistics
The number of attempted operations
You can also use the showipslamonitordistributions-statistics and showipslamonitorcollection-statistics commands to display additional statistical information.
Examples
The following is sample output from the showipslamonitortotals-statistics command in full format:
Router# show ip sla monitor totals-statistics
Statistic Totals
Entry Number: 1
Start Time Index: *17:15:41.000 UTC Thu May 16 1996
Age of Statistics Entry (hundredths of seconds): 48252
Number of Initiations: 10
Related Commands
Command
Description
showipslamonitorcollection-statistics
Displays statistical errors for all IP SLAs operations or the specified operation.
showipslamonitorconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
showipslamonitordistributions-statistics
Displays statistics distribution information (captured response times) for all IP SLAs operations or the specified operation.
show ip sla mpls-lsp-monitor collection-statistics
To display the statistics for Cisco IOS IP Service Level Agreements (SLAs) operations belonging to a label switched path (LSP) discovery group of an LSP Health Monitor operation, use the
showipslampls-lsp-monitorcollection-statisticscommand in user EXEC or privileged EXEC mode.
(Optional) Identification number of the LSP discovery group for which the details will be displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(33)SRB
This command was introduced.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitormpls-lsp-monitorcollection-statistics command.
Usage Guidelines
Use the
showipslampls-lsp-monitorcollection-statisticscommand if the LSP discovery option is enabled for an LSP Health Monitor operation. This command is not applicable if the LSP discovery option is disabled.
When the LSP discovery option is enabled, an individual IP SLAs operation is created by the LSP Health Monitor for each equal-cost multipath belonging to an LSP discovery group of a particular LSP Health Monitor operation. The network connectivity statistics collected by each individual IP SLAs operation are 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 group for a given one-hour increment.
Examples
The following is sample output from the
showipslampls-lsp-monitorcollection-statistics command:
Router# show ip sla mpls-lsp-monitor collection-statistics 100001
Entry number: 100001
Start Time Index: *19:32:37.995 EST Mon Feb 28 2005
Path Discovery Start Time: *20:23:43.919 EST Mon Feb 28 2005
Target destination IP address: 10.131.161.251
Path Discovery Status: OK
Path Discovery Completion Time: 1772
Path Discovery Minimum Paths: 12
Path Discovery Maximum Paths: 12
LSP Group Index: 100001
LSP Group Status: up
Total Pass: 1225
Total Timeout: 0 Total Fail: 0
Latest probe status: 'up,up,up,up,up,up,up,up,up,up,up,up'
Latest Path Identifier: '127.0.0.13-Se3/0-38,127.0.0.6-Se3/0-38,127.0.0.1-Se3/0-38,127.0.0.2-Se3/0-38,127.0.0.4-Se3/0-38,127.0.0.5-Se3/0-38,127.0.0.13-Se4/0-38,127.0.0.6-Se4/0-38,127.0.0.1-Se4/0-38,127.0.0.2-Se4/0-38,127.0.0.4-Se4/0-38,127.0.0.5-Se4/0-38'
Minimum RTT: 24 Maximum RTT: 100 Average RTT: 42
The table below describes the significant fields shown in the display.
Table 28 show ip sla mpls-lsp-monitor collection-statistics Field Descriptions
Field
Description
Entry number
Identification number of the LSP discovery group.
Start Time Index
Start time of the LSP Health Monitor operation.
Path Discovery Start Time
Time in which the most recent iteration of LSP discovery started.
Target destination IP address
IP address of the Border Gateway Protocol (BGP) next hop neighbor.
Path Discovery Status
Return code of the most recent iteration of LSP discovery.
Path Discovery Completion Time
Amount of time (in milliseconds) it took to complete the most recent iteration of the LSP discovery process.
Path Discovery Minimum Paths
Minimum number of equal-cost multipaths discovered by the LSP discovery process.
Path Discovery Maximum Paths
Maximum number of equal-cost multipaths discovered by the LSP discovery process.
LSP Group Index
Identification number of the LSP discovery group.
LSP Group Status
Operation status of the LSP discovery group.
Total Pass
Total number of LSP discovery process iterations.
Total Timeout
Total number of LSPs in which a timeout violation was reported.
Total Fail
Total number of LSPs in which an operation failure was reported.
Latest probe status
Current operation status for each IP SLAs operation belonging to the specified LSP discovery group.
Latest Path Identifier
Current identification information (IP address used to select the LSP, outgoing interface, and label stack) for each IP SLAs operation belonging to the specified LSP discovery group.
Minimum RTT
Minimum round-trip time (in milliseconds) measured by the IP SLAs operations associated with the specified LSP discovery group.
Maximum RTT
Maximum round-trip time (in milliseconds) measured by the IP SLAs operations associated with the specified LSP discovery group.
Average RTT
Average round-trip time (in milliseconds) for all the IP SLAs operations associated with the specified LSP discovery group.
Related Commands
Command
Description
autoipslampls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters auto IP SLA MPLS configuration mode.
show ip sla mpls-lsp-monitor configuration
To display configuration settings for IP Service Level Agreements (SLAs) label switched path (LSP) Health Monitor operations, use the
showipslampls-lsp-monitorconfiguration command in user EXEC or privileged EXEC mode.
(Optional) Number of the LSP Health Monitor operation for which the details will be displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.4(6)T
This command was introduced.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the
showrtrmpls-lsp-monitorconfiguration command.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitormpls-lsp-monitorconfiguration command.
Usage Guidelines
If the identification number of an LSP Health Monitor operation is not specified, configuration values for all the configured LSP Health Monitor operations will be displayed.
Examples
The following is sample output from the
showipslampls-lsp-monitorconfiguration command:
Router# show ip sla mpls-lsp-monitor configuration 1
Entry Number : 1
Modification time : *12:18:21.830 PDT Fri Aug 19 2005
Operation Type : echo
Vrf Name : ipsla-vrf-all
Tag :
EXP Value : 0
Timeout(ms) : 1000
Threshold(ms) : 5000
Frequency(sec) : Equals schedule period
LSP Selector : 127.0.0.1
ScanInterval(min) : 1
Delete Scan Factor : 1
Operations List : 100001-100003
Schedule Period(sec): 60
Request size : 100
Start Time : Start Time already passed
SNMP RowStatus : Active
TTL value : 255
Reply Mode : ipv4
Reply Dscp Bits :
Secondary Frequency : Enabled on Timeout
Value(sec) : 10
Reaction Configs :
Reaction : connectionLoss
Threshold Type : Consecutive
Threshold Count : 3
Action Type : Trap Only
Reaction : timeout
Threshold Type : Consecutive
Threshold Count : 3
Action Type : Trap Only
The table below describes the significant fields shown in the display.
Table 29 show ip sla mpls-lsp-monitor configuration Field Descriptions
Field
Description
Entry Number
Identification number for the LSP Health Monitor operation.
Operation Type
Type of IP SLAs operation configured by the LSP Health Monitor operation.
Vrf Name
If a specific name is displayed in this field, then the LSP Health Monitor is configured to discover only those BGP next hop neighbors in use by the VRF specified.
If ipsla-vrf-all is displayed in this field, then the LSP Health Monitor is configured to discover all BGP next hop neighbors in use by all VRFs associated with the source Provider Edge (PE) router.
Tag
User-specified identifier for an IP SLAs operation.
EXP Value
Experimental field value in the header for an echo request packet of the IP SLAs operation.
Timeout(ms)
Amount of time the IP SLAs operation waits for a response from its request packet.
Threshold(ms)
Upper threshold value for calculating network monitoring statistics created by an IP SLAs operation.
Frequency(sec)
Time after which the IP SLAs operation is restarted.
LSP Selector
Local host IP address used to select the LSP for the IP SLAs operation.
ScanInterval(min)
Time interval at which the LSP Health Monitor checks the scan queue for BGP next hop neighbor updates.
Delete Scan Factor
Specifies the number of times the LSP Health Monitor should check the scan queue before automatically deleting IP SLAs operations for BGP next hop neighbors that are no longer valid.
Operations List
Identification numbers of the IP SLAs operations created by the LSP Health Monitor operation.
Schedule Period(sec)
Time period (in seconds) in which the start times of the individual IP SLAs operations are distributed.
Request size
Protocol data size for the request packet of the IP SLAs operation.
Start Time
Status of the start time for the LSP Health Monitor operation.
SNMP RowStatus
Indicates whether SNMP RowStatus is active or inactive.
TTL value
The maximum hop count for an echo request packet of the IP SLAs operation.
Reply Mode
Reply mode for an echo request packet of the IP SLAs operation.
Reply Dscp Bits
Differentiated services codepoint (DSCP) value of an echo reply packet of the IP SLAs operation.
Secondary Frequency
Reaction condition that will enable the secondary frequency option.
Value(sec)
Secondary frequency value.
Reaction Configs
Reaction configuration of the IP SLAs operation.
Reaction
Reaction condition being monitored.
Threshold Type
Specifies when an action should be performed as a result of a reaction event.
Threshold Count
The number of times a reaction event can occur before an action should be performed.
Action Type
Type of action that should be performed as a result of a reaction event.
Related Commands
Command
Description
autoipslampls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters auto IP SLA MPLS configuration mode.
autoipslampls-lsp-monitorschedule
Configures the scheduling parameters for an IP SLAs LSP Health Monitor operation.
show ip sla mpls-lsp-monitor lpd operational-state
To display the operational status of the label switched path (LSP) discovery groups belonging to an IP Service Level Agreements (SLAs) LSP Health Monitor operation, use the
showipslampls-lsp-monitorlpdoperational-statecommand in user EXEC or privileged EXEC mode.
(Optional) Identification number of the LSP discovery group for which the details will be displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(33)SRB
This command was introduced.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitormpls-lsp-monitorlpdoperational-statecommand.
Usage Guidelines
Use the
showipslampls-lsp-monitorlpdoperational-statecommand if the LSP discovery option is enabled for an LSP Health Monitor operation. This command is not applicable if the LSP discovery option is disabled.
Examples
The following is sample output from the
showipslampls-lsp-monitorlpdoperational-state command:
Router# show ip sla mpls-lsp-monitor lpd operational-state 100001
Entry number: 100001
MPLSLM Entry Number: 1
Target FEC Type: LDP IPv4 prefix
Target Address: 192.168.1.11
Number of Statistic Hours Kept: 2
Last time LPD Stats were reset: *21:21:18.239 GMT Tue Jun 20 2006
Traps Type: 3
Latest Path Discovery Mode: rediscovery complete
Latest Path Discovery Start Time: *21:59:04.475 GMT Tue Jun 20 2006
Latest Path Discovery Return Code: OK
Latest Path Discovery Completion Time(ms): 3092
Number of Paths Discovered: 3
Path Information :
Path Outgoing Lsp Link Conn Adj Downstream
Index Interface Selector Type Id Addr Label Stack Status
1 Et0/0 127.0.0.8 90 0 10.10.18.30 21 OK
2 Et0/0 127.0.0.2 90 0 10.10.18.30 21 OK
3 Et0/0 127.0.0.1 90 0 10.10.18.30 21 OK
The table below describes the significant fields shown in the display.
Table 30 show ip sla mpls-lsp-monitor lpd operational-state Field Descriptions
Field
Description
Entry number
Identification number of the LSP discovery group.
MPLSLM Entry number
Identification number of the LSP Health Monitor operation.
Target FEC Type
The Forward Equivalence Class (FEC) type of the BGP next hop neighbor.
Target Address
IP address of the Border Gateway Protocol (BGP) next hop neighbor.
Number of Statistic Hours Kept
The amount of time (in hours) in which LSP discovery group statistics will be maintained. Use the
hours-of-statistics-kept command to configure this value.
Traps Type
Trap type values indicate the type of threshold monitoring that has been enabled using the
autoipslampls-lsp-monitorreaction-configuration command. Trap type values are defined as follows:
1--timeout
2--connection loss
3--LSP discovery group status changes
4--LSP discovery failure
Latest Path Discovery Mode
Current mode of the LSP discovery process. Modes include initial discovery, initial complete, rediscovery running, and rediscovery complete.
Latest Path Discovery Start Time
Time in which the most recent iteration of LSP discovery started.
Latest Path Discovery Return Code
Return code for the most recent iteration of LSP discovery.
Latest Path Discovery Completion Time
Amount of time (in milliseconds) it took to complete the most recent iteration of the LSP discovery process.
Number of Paths Discovered
Number of equal-cost multipaths discovered during the most recent iteration of the LSP discovery process.
Path Index
Identification number for the equal-cost multipath.
Outgoing Interface
Outgoing interface of the echo request packet.
Lsp Selector
IP address used to select the LSP.
Adj Addr
IP address of the next hop physical interface.
Downstream Label Stack
Downstream MPLS label stack number.
Status
Return code for the most recent IP SLAs LSP ping operation of the specified equal-cost multipath.
Related Commands
Command
Description
autoipslampls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters auto IP SLA MPLS configuration mode.
show ip sla mpls-lsp-monitor neighbors
To display routing and connectivity information about Multiprotocol Label Switching (MPLS) Virtual Private Network (VPN) Border Gateway Protocol (BGP) next hop neighbors discovered by the IP Service Level Agreements (SLAs) label switched path (LSP) Health Monitor, use the
showipslampls-lsp-monitorneighbors command in user EXEC or privileged EXEC mode.
showipslampls-lsp-monitorneighbors
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.4(6)T
This command was introduced.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the
showrtrmpls-lsp-monitorneighbors command.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitormpls-lsp-monitorneighbors command.
Examples
The following is sample output from the
showipslampls-lsp-monitorneighborscommand:
Router# show ip sla mpls-lsp-monitor neighbors
IP SLA MPLS LSP Monitor Database : 1
BGP Next hop 10.10.10.5 (Prefix: 10.10.10.5/32) OK
ProbeID: 100001 (red, blue, green)
BGP Next hop 10.10.10.7 (Prefix: 10.10.10.7/32) OK
ProbeID: 100002 (red, blue, green)
BGP Next hop 10.10.10.8 (Prefix: 10.10.10.8/32) OK
ProbeID: 100003 (red, blue, green)
The table below describes the significant fields shown in the display.
Table 31 show ip sla mpls-lsp-monitor neighbors Field Descriptions
Field
Description
BGP Next hop
Identifier for the BGP next hop neighbor.
Prefix
IPv4 Forward Equivalence Class (FEC) of the BGP next hop neighbor to be used by the MPLS LSP ping operation.
ProbeID
The identification number of the IP SLAs operation. The names of the VRFs that contain routing entries for the specified BGP next hop neighbor are listed in parentheses.
OK
LSP ping or LSP traceroute connectivity status between the source PE router and specified BGP next hop neighbor. Connectivity status can be the following:
OK--Successful reply.
ConnectionLoss--Reply is from a device that is not egress for the Forward Equivalence Class (FEC).
Timeout--Echo request timeout.
Unknown--State of LSP is not known.
Related Commands
Command
Description
autoipslampls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters auto IP SLA MPLS configuration mode.
show ip sla mpls-lsp-monitor scan-queue
To display information about adding or deleting Border Gateway Protocol (BGP) next hop neighbors from a particular Multiprotocol Label Switching (MPLS) Virtual Private Network (VPN) of an IP Service Level Agreements (SLAs) LSP Health Monitor operation, use the
showipslampls-lsp-monitorscan-queue command in user EXEC or privileged EXEC mode.
Number of the LSP Health Monitor operation for which the details will be displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.4(6)T
This command was introduced.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the
showrtrmpls-lsp-monitorscan-queue command.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitormpls-lsp-monitorscan-queue command.
Examples
The following is sample output from the
showipslampls-lsp-monitorscan-queue command:
Router# show ip sla mpls-lsp-monitor scan-queue 1
Next scan Time after: 23 Secs
Next Delete scan Time after: 83 Secs
BGP Next hop Prefix vrf Add/Delete?
10.10.10.8 10.10.10.8/32 red Add
10.10.10.8 10.10.10.8/32 blue Add
10.10.10.8 10.10.10.8/32 green Add
The table below describes the significant fields shown in the display.
Table 32 show ip sla mpls-lsp-monitor scan-queue Field Descriptions
Field
Description
Next scan Time after
Amount of time left before the LSP Health Monitor checks the scan queue for information about adding BGP next hop neighbors to a particular VPN. At the start of each scan time, IP SLAs operations are created for all newly discovered neighbors.
Next Delete scan Time after
Amount of time left before the LSP Health Monitor checks the scan queue for information about deleting BGP next hop neighbors from a particular VPN. At the start of each delete scan time, IP SLAs operations are deleted for neighbors that are no longer valid.
BGP Next hop
Identifier for the BGP next hop neighbor.
Prefix
IPv4 Forward Equivalence Class (FEC) of the BGP next hop neighbor to be used by the MPLS LSP ping operation.
vrf
Name of the VRF that contains a routing entry for the specified BGP next hop neighbor.
Add/Delete
Indicates that the specified BGP next hop neighbor will be added to or removed from the specified VPN.
Related Commands
Command
Description
autoipslampls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters auto IP SLA MPLS configuration mode.
delete-scan-factor
Specifies the number of times the LSP Health Monitor should check the scan queue before automatically deleting IP SLAs operations for BGP next hop neighbors that are no longer valid.
mplsdiscoveryvpninterval
Specifies the time interval at which routing entries that are no longer valid are removed from the BGP next hop neighbor discovery database of an MPLS VPN.
scan-interval
Specifies the time interval (in minutes) at which the LSP Health Monitor checks the scan queue for BGP next hop neighbor updates.
show ip sla mpls-lsp-monitor summary
To display Border Gateway Protocol (BGP) next hop neighbor and label switched path (LSP) discovery group information for IP Service Level Agreements (SLAs) LSP Health Monitor operations, use the
showipslampls-lsp-monitorsummarycommand in user EXEC or privileged EXEC mode.
showipslampls-lsp-monitorsummary
[ operation-number
[ group [group-id] ] ]
Syntax Description
operation-number
(Optional) Number of the LSP Health Monitor operation for which the details will be displayed.
groupgroup-id
(Optional) Specifies the identification number of the LSP discovery group for which the details will be displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(33)SRB
This command was introduced.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitormpls-lsp-monitorsummary command.
Usage Guidelines
Use the
showipslampls-lsp-monitorsummarycommand if the LSP discovery option is enabled for an LSP Health Monitor operation. This command is not applicable if the LSP discovery option is disabled.
Examples
The following is sample output from the
showipslampls-lsp-monitorsummaryoperation-number command:
Router# show ip sla mpls-lsp-monitor summary 1
Index - MPLS LSP Monitor probe index.
Destination - Target IP address of the BGP Next Hop.
Status - LPD Group Status.
LPD Group ID - Unique index to identify the LPD Group.
Last Operation Time - Last time an operation was attempted by a particular probe in the LPD group.
Index Destination Status LPD Group ID Last Operation Time
1 100.1.1.1 up 100001 19:33:37.915 EST Mon Feb 28 2005
2 100.1.1.2 down 100002 19:33:47.915 EST Mon Feb 28 2005
3 100.1.1.3 retry 100003 19:33:57.915 EST Mon Feb 28 2005
4 100.1.1.4 partial 100004 19:34:07.915 EST Mon Feb 28 2005
The following is sample output from the
showipslampls-lsp-monitorsummaryoperation-numbergroupgroup-id command:
Router# show ip sla mpls-lsp-monitor summary 1 group 100001
Group ID - Unique number to identify a LPD group
Lsp-selector - Unique 127/8 address used to identify an LPD.
Latest operation status - Latest probe status.
Last Operation time - Time when the last operation was attempted.
Group ID Lsp-Selector Status Failures Successes RTT Last Operation Time
100001 127.0.0.13 up 0 78 32 *20:11:37.895 EST Mon Feb 28 2005
100001 127.0.0.15 up 0 78 32 *20:11:37.995 EST Mon Feb 28 2005
100001 127.0.0.16 up 0 78 32 *20:11:38.067 EST Mon Feb 28 2005
100001 127.0.0.26 up 0 78 32 *20:11:38.175 EST Mon Feb 28 2005
The table below describes the significant fields shown in the display.
Table 33 show ip sla mpls-lsp-monitor summary Field Descriptions
Field
Description
Failures
Number of times the IP SLAs operation for the specified LSP failed to report an RTT value.
Successes
Number of times the IP SLAs operation for the specified LSP successfully reported an RTT value.
RTT
Average round-trip time (in milliseconds) for the specified LSP.
Related Commands
Command
Description
autoipslampls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters auto IP SLA MPLS configuration mode.
show ip sla profile video
To display a list of standard predefined and user-defined video traffic profiles available for IP Service Level Agreements (SLAs) video operations or to display configuration values including all defaults for a specified profile, use the
show ip sla profile video command in user EXEC or privileged EXEC mode.
show
ipslaprofilevideo [ profile-name]
Syntax Description
profile-name
(Optional) name of synethetic video traffic profile to be displayed. Valid options are as follows:
cp9900: The predefined Cisco Unified 9900 Series IP Phone System profile.
cts: The predefined Cisco Telepresence System 1000/3000 profile.
custom: A customized video endpoint type.
name: Unique identifier for the user-defined endpoint.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
Modification
15.2(2)T
This command was introduced.
Examples
Router# show ip sla profile video
CTS-1080P-Best
CTS-1080P-Better
CTS-1080P-Good
CTS-720P-Best
CTS-720P-Better
CTS-720P-Good
CTS-720P-Lite
CP-9900-VGA-30fps-1000kbps
CP-9900-VGA-15fps-1000kbps
CP-9900-CIF-30fps-1000kbps
CP-9900-CIF-15fps-384kbps
CP-9900-QCIF-30fps-249kbps
CP-9900-QCIF-15fps-99kbps
CP-9900-QCIF-10fps-79kbps
My-TP
My-RT
custom
Router# show ip sla profile video cp9900
IP SLA synthetic video traffic profile parameter details:
Name: cp9900
ID: 17
Administrative status: not in service
Operational status: none
Description: (not set)
Endpoint type: CP-9900
Codec type: H.264 Profile: baseline
Content: single-person
Resolution: CIF (352x288)
Frame rate: 15fps
Bit rate maximum: 333kbps
Bit rate maximum: 3500kbps
The table below describes the significant fields that can be shown in the display.
Field
Description
Name:
One of the following:
CP9900
CTS
Custom
A text string that is a unique identifier for the user-defined endpoint.
ID:
IP SLA identifier index.
Administrative status:
One of the following:
not ready—If any one or more of the three mandatory parameters are not configured, the profile remains in the not-ready state.
not in service—When each of the three mandatory parameters are configured, the profile is in the not-in-service state.
active—When the profile is in the “not in service” state, entering the
no shutdown command changes the status of the the profile to the active state.
Compared to the normal interface administrative mode, the not-ready or not-in-service states are analogous to the interface down state.
Operational status:
One of the following:
none—When a profile is not in the administrative active state, Cisco IOS software displays the operational status as none.
idle—When a profile is in the administrative active state but the profile is not being used by any IP SLA VO operation, the operational status is idle.
in use—When a profile is in the administrative active state and the profile is being used by an IP SLA VO operation, the operational status is in use.
Description:
Description (text string) of the video profile.
Endpoint type:
Ehe endpoint type is one the following: TS, CP-9900, or custom.
Codec type:
Codec profile type.
Content:
Video content type is conference-room, single-person, news-broadcast, sports, or street-view.
Resolution:
Video resolution is one of the following: QCIF, CIF, SIF, QVGA, VGA, 4CIF, 4SIF, 720p, or 1080p.
Frame rate:
Frame rate of 30, 24, 15, 10, 7.5, or 5 frames per second (fps).
Bitrate maximum:
Maximum bit rate in kilobits per second (kb/s).
Bitrate window size:
Bit-rate window size in milliseconds.
Frame intra size maximum:
Maximum intra-frame size in kilobytes (KB/s).
Frame intra refresh interval:
Intra-frame refresh interval in milliseconds
RTP packet size average:
Average RTP packet size in bytes.
RTP buffer output:
Buffer output as either bursty or shaped.
show ip sla reaction-configuration
To display the configured proactive threshold monitoring settings for all Cisco IOS IP Service Level Agreements (SLAs) operations or a specified operation, use the
showipslareaction-configuration command in user EXEC or privileged EXEC mode.
(Optional) Number of the operation for which the reaction configuration characteristics is displayed.
Command Default
Displays configured proactive threshold monitoring settings for all IP SLAs operations.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.4(4)T
This command was introduced. This command replaces the
showipslamonitorreaction-configuration command.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the
showrtrreaction-configurationcommand.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitorreaction-configurationcommand.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the
showipslamonitorreaction-configurationcommand.
Usage Guidelines
Use the
ipslareaction-configuration command in global configuration mode to configure the proactive threshold monitoring parameters for an IP SLAs operations.
Examples
In the following example, multiple monitored elements (indicated by the Reaction values) are configured for a single IP SLAs operation:
The table below describes the significant fields shown in the display.
Table 34 show ip sla reaction-configuration Field Descriptions
Field
Description
Reaction
The monitored element configured for the specified IP SLAs operation.
Corresponds to the
react{connectionLoss |
jitterAvg |
jitterDSAvg |
jitterSDAvg |
mos |
PacketLossDS |
PacketLossSD |
rtt |
timeout |
verifyError} syntax in the
ipslareaction-configuration command.
Threshold type
The configured threshold type.
Corresponds to the
threshold-type {never |
immediate |
consecutive |
xofy |
average} syntax in the
ipslareaction-configuration command.
Rising (milliseconds)
The
upper-threshold value.
Corresponds to the
threshold-valueupper-thresholdlower-threshold syntax in the
ipslareaction-configuration command.
Falling (milliseconds)
The
lower-threshold value.
Corresponds to the
threshold-valueupper-thresholdlower-threshold syntax in the
ipslareaction-configuration command.
Threshold Count
The
x-value in the
xofy threshold type, or the
number-of-measurements value for the
average threshold type.
Threshold Count2
The
y-value in the
xofy threshold type.
Action Type
The reaction to be performed when the violation conditions are met.
Corresponds to the
action-type {none |
trapOnly |
triggerOnly |
trapAndTrigger} syntax in the
ipslareaction-configuration command.
Related Commands
Command
Description
ipslareaction-configuration
Configures proactive threshold monitoring parameters for an IP SLAs operation.
show ip sla reaction-trigger
To display the reaction trigger information for all Cisco IOS IP Service Level Agreements (SLAs) operations or the specified operation, use the showipslareaction-trigger command in user EXEC or privileged EXEC mode.
showipslareaction-trigger [operation-number]
Syntax Description
operation-number
(Optional) Number of the IP SLAs operation to display.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.4(4)T
This command was introduced. This command replaces the showipslamonitorreaction-trigger command.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the showrtrreaction-triggercommand.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the showipslamonitorreaction-triggercommand.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the showipslamonitorreaction-triggercommand.
Usage Guidelines
Use the showipslareaction-trigger command to display the configuration status and operational state of target operations that will be triggered as defined with the ipslareaction-configuration global configuration command.
Examples
The following is sample output from the showipslareaction-trigger command:
Router# show ip sla reaction-trigger 1
Reaction Table
Entry Number: 1
Target Entry Number: 2
Status of Entry (SNMP RowStatus): active
Operational State: pending
Related Commands
Command
Description
showipslaconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
show ip sla responder
To display information about the Cisco IOS IP Service Level Agreements (SLAs) Responder, use the showipslaresponder command in user EXEC or privileged EXEC mode.
showipslaresponder
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.4(4)T
This command was introduced. This command replaces the showipslamonitorresponder command.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the showrtrrespondercommand.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the showipslamonitorrespondercommand.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the showipslamonitorrespondercommand.
Usage Guidelines
Use the showipslarespondercommand to display information about recent sources of IP SLAs control messages, such as who has sent recent control messages and who has sent invalid control messages.
Examples
The following sections show sample output from the showipslaresponder command for IP SLAs Responders in IPv4 and IPv6 networks.
Examples
The following is sample output from the showipslaresponder command in an IPv4 network:
Router# show ip sla responder
IP SLA Monitor Responder is: Enabled
Number of control message received: 19 Number of errors: 1
Recent sources:
10.0.0.1 [19:11:49.035 UTC Sat Dec 2 2005]
10.0.0.1 [19:10:49.023 UTC Sat Dec 2 2005]
10.0.0.1 [19:09:48.707 UTC Sat Dec 2 2005]
10.0.0.1 [19:08:48.687 UTC Sat Dec 2 2005]
10.0.0.1 [19:07:48.671 UTC Sat Dec 2 2005]
Recent error sources:
10.0.0.1 [19:10:49.023 UTC Sat Dec 2 2005] RTT_AUTH_FAIL
Examples
The following is sample output from the showipslaresponder command in an IPv6 network:
Router# show ip sla responder
IP SLA Responder is: Enabled
Number of control message received: 19 Number of errors: 1
Recent sources:
2001:DB8:100::1 [19:11:49.035 IST Thu Jul 13 2006]
2001:DB8:100::1 [19:10:49.023 IST Thu Jul 13 2006]
2001:DB8:100::1 [19:09:48.707 IST Thu Jul 13 2006]
2001:DB8:100::1 [19:08:48.687 IST Thu Jul 13 2006]
2001:DB8:100::1 [19:07:48.671 IST Thu Jul 13 2006]
Recent error sources:
2001:DB8:100::1 [19:10:49.023 IST Thu Jul 13 2006] RTT_AUTH_FAIL
Related Commands
Command
Description
showipslaconfiguration
Displays configuration values for IP SLAs operations.
show ip sla statistics
To display the current operational status and statistics of all Cisco IOS IP Service Level Agreements (SLAs) operations or a specified operation, use the
showipslastatistics command in user EXEC or privileged EXEC mode.
showipslastatistics [operation-number] [details]
Syntax Description
operation-number
(Optional) Number of the operation for which operational status and statistics are displayed.
Note
For Multicast UDP jitter operations: Valid operation numbers include the operation IDs (oper-id) for each responder in the endpoint list for the operation.
details
(Optional) Operational status and statistics are displayed in greater detail.
Command Default
Displays output for all running IP SLAs operations.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
Modification
12.4(4)T
This command was introduced. This command replaces the
showipslamonitorstatisticscommand.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the
showrtroperational-statecommand.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitorstatisticscommand.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the
showipslamonitorstatisticscommand.
12.2(58)SE
This command was modified. The command output has been modified to include information about IP SLAs video operations.
15.2(2)T
This command was integrated into Cisco IOS Release 15.2(2)T.
15.1(1)SG
This command was integrated into Cisco IOS Release 15.1(1)SG.
Cisco IOS XE Release 3.3SG
This command was integrated into Cisco IOS XE Release 3.3SG.
15.2(4)M
This command was modified. The command output has been modified to include information about multicast UDP jitter operations.
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.
15.3(2)T
This command was modified. The command output has been modified to include information about percentile operations.
15.3(2)S
This command was modified. the command output has been modified to include information about service performance operations.
Usage Guidelines
Use the
showipslastatistics command to display the current state of IP SLAs operations, including how much life the operation has left, whether the operation is active, and the completion time. The output will also include the monitoring data returned for the last (most recently completed) operation.
For multicast UDP jitter operations with an endpoint-list: Operation IDs (oper-id) are generated for each destination responder that is associated with the multicast UDP jitter operation. This generated operation ID is displayed when you use the
show ip sla configuration command for the base multicast operation, and as part of the summery statistics for the entire operation.
Doing a show on the specific operation ID will allow details for that one responder to be displayed.
Examples
The following is sample output from the
showipslastatistics command:
Router# showipslastatistics Current Operational State
Entry Number: 3
Modification Time: *22:15:43.000 UTC Sun Feb 11 2001
Diagnostics Text:
Last Time this Entry was Reset: Never
Number of Octets in use by this Entry: 1332
Number of Operations Attempted: 2
Current Seconds Left in Life: 3511
Operational State of Entry: active
Latest Completion Time (milliseconds): 544
Latest Operation Start Time: *22:16:43.000 UTC Sun Feb 11 2001
Latest Oper Sense: ok
Latest Sense Description: 200 OK
Total RTT: 544
DNS RTT: 12
TCP Connection RTT: 28
HTTP Transaction RTT: 504
HTTP Message Size: 9707
The following is sample output from the
showipslastatistics command when the specified operation is a UDP jitter (codec) operation. The values shown indicate the values for the last IP SLAs operation.
Router# showipslastatistics Current Operational State
Entry number: 10
Modification time: 12:57:45.690 UTC Sun Oct 26 2003
Number of operations attempted: 3
Number of operations skipped: 0
Current seconds left in Life: 3570
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
The following is sample output from the
showipslastatisticsdetail
command when the specified operation is an IP SLAs Metro-Ethernet 3.0 (ITU-T Y.1731) delay operation (3). The values shown indicate the values for the last operation.
Router# show ip sla statistics 3 details
IPSLA operation id: 3
Delay Statistics for Y1731 Operation 3
Type of operation: Y1731 Delay Measurement
Latest operation start time: *02:12:49.772 PST Thu Jul 1 2010
Latest operation return code: OK
Distribution Statistics:
Interval
Start time: *02:12:49.772 PST Thu Jul 1 2010
End time: *00:00:00.000 PST Mon Jan 1 1900
Number of measurements initiated: 31
Number of measurements completed: 31
Flag: OK
Delay:
Max/Avg/Min TwoWay: 2014/637/0
Time of occurrence TwoWay: Max - *02:13:11.210 PST Thu Jul 1 2010/Min - *02:17:51.339 PST Thu Jul 1 2010
Bucket TwoWay:
Bucket Range: 0 - < 5000 microseconds
Total observations: 22
Bucket Range: 5000 - < 10000 microseconds
Total observations: 0
Bucket Range: 10000 - < 15000 microseconds
Total observations: 0
Bucket Range: 15000 - < 20000 microseconds
Total observations: 0
Bucket Range: 20000 - < 25000 microseconds
Total observations: 0
Bucket Range: 25000 - < 30000 microseconds
Total observations: 0
Bucket Range: 30000 - < 35000 microseconds
Total observations: 0
Bucket Range: 35000 - < 40000 microseconds
Total observations: 0
Bucket Range: 40000 - < 45000 microseconds
Total observations: 0
Bucket Range: 45000 - < 4294967295 microseconds
Total observations: 0
Delay Variance:
Max/Avg TwoWay positive: 0/0
Time of occurrence TwoWay positive: Max - *00:00:00.000 PST Mon Jan 1 1900
Max/Avg TwoWay negative: 0/0
Time of occurrence TwoWay negative: Max - *00:00:00.000 PST Mon Jan 1 1900
Bucket TwoWay positive:
Bucket Range: 0 - < 5000 microseconds
Total observations: 0
Bucket Range: 5000 - < 10000 microseconds
Total observations: 0
Bucket Range: 10000 - < 15000 microseconds
Total observations: 0
Bucket Range: 15000 - < 20000 microseconds
Total observations: 0
Bucket Range: 20000 - < 25000 microseconds
Total observations: 0
Bucket Range: 25000 - < 30000 microseconds
Total observations: 0
Bucket Range: 30000 - < 35000 microseconds
Total observations: 0
Bucket Range: 35000 - < 40000 microseconds
Total observations: 0
Bucket Range: 40000 - < 45000 microseconds
Total observations: 0
Bucket Range: 45000 - < 4294967295 microseconds
Total observations: 0
Bucket TwoWay negative:
Bucket Range: 0 - < 5000 microseconds
Total observations: 0
Bucket Range: 5000 - < 10000 microseconds
Total observations: 0
Bucket Range: 10000 - < 15000 microseconds
Total observations: 0
Bucket Range: 15000 - < 20000 microseconds
Total observations: 0
Bucket Range: 20000 - < 25000 microseconds
Total observations: 0
Bucket Range: 25000 - < 30000 microseconds
Total observations: 0
Bucket Range: 30000 - < 35000 microseconds
Total observations: 0
Bucket Range: 35000 - < 40000 microseconds
Total observations: 0
Bucket Range: 40000 - < 45000 microseconds
Total observations: 0
Bucket Range: 45000 - < 4294967295 microseconds
Total observations: 0
Bucket TwoWay negative:
The following is sample output from the
showipslastatistics command when the specified operation is a multicast UDP jitter operation and includes statistics for each multicast responder in the endpoint list associated with the multicast UDP jitter operation:
Router# show ip sla statistics 100
Operation id: 22
mcast-ip-address/port: 239.1.1.1/3000
Latest operation start time: 18:32:36 PST Thu Aug 4 2011
Number of successes: 11
Number of failures: 0
Operation time to live: 2965 sec
status DSCP delay jitter loss
OK 000 1/2/5 1/2/3 0/0/0
Multicast responder statistics:
Seq# oper-id responder-ip status delay jitter loss
1 728338 1.2.3.4 OK 1/2/5 1/2/3 0
2 728339 1.2.3.5 NO_RESPONSE 1/2/5 1/2/3 0
3 728340 1.2.3.6 OK 1/2/5 1/2/3 0
4 728343 1.2.3.7 ERROR 1/2/5 1/2/3 0
The following is sample output from the
showipslastatistics command when the specified operation is configured for the percentile option:
Device# show ip sla statistics 123
IPSLAs Latest Operation Statistics
IPSLA operation id: 123
Type of operation: udp-jitter
Latest RTT: 1 milliseconds
Latest operation start time: 00:24:08 PST Sat Feb 25 2012
Latest operation return code: OK
RTT Values:
Number Of RTT: 10 RTT Min/Avg/Max: 2/2/3 milliseconds
Percentile RTT: 95%
Number Of RTT: 9 RTT Min/Avg/Max: 2/2/2 milliseconds
Latency one-way time:
Number of Latency one-way Samples: 9
Source to Destination Latency one way Min/Avg/Max: 1/1/2 milliseconds
Destination to Source Latency one way Min/Avg/Max: 1/1/2 milliseconds
Percentile SD OW: 95%
Percentile DS OW: 95%
Number of Latency one-way Samples: 8
Source to Destination Latency one way Min/Avg/Max: 1/1/1 milliseconds
Destination to Source Latency one way Min/Avg/Max: 1/1/1 milliseconds
Jitter Time:
Number of SD Jitter Samples: 9
Source to Destination Jitter Min/Avg/Max: 4/6/12 milliseconds
Number of DS Jitter Samples: 9
Destination to Source Jitter Min/Avg/Max: 0/2/5 milliseconds
Percentile SD OW: 95%
Percentile DS OW: 95%
Number of SD Jitter Samples: 8
Source to Destination Jitter Min/Avg/Max: 4/6/11 milliseconds
Number of DS Jitter Samples: 8
Destination to Source Jitter Min/Avg/Max: 0/2/4 milliseconds
The table below describes the significant fields shown in the display.
Table 35 show ip sla statistics Field Descriptions
Field
Description
Voice Scores
Indicates that Voice over IP statistics appear on the following lines. Voice score data is computed when the operation type is configured as
udp-jitter (codec).
ICPIF
The Calculated Planning Impairment Factor (ICPIF) value for the operation. The ICPIF value is computed by IP SLAs using the formula
Icpif=Io+Iq+Idte+Idd+Ie-A, where
The values for
Io ,
Iq , and
Idte are set to zero.
The value
Idd is computed based on the measured one-way delay.
The value
Ie is computed based on the measured packet loss.
The value of A is specified by the user.
ICPIF values are expressed in a typical range of 5 (very low impairment) to 55 (very high impairment). ICPIF values numerically lower than 20 are generally considered “adequate.”
Note
This value is intended only for relative comparisons, and may not match ICPIF values generated using alternate methods.
MOS Score
The estimated Mean Opinion Score (Conversational Quality, Estimated) for the latest iteration of the operation. The MOS-CQE is computed by IP SLAs as a function of the ICPIF.
MOS values are expressed as a number from 1 (1.00) to 5 (5.00), with 5 being the highest level of quality, and 1 being the lowest level of quality. A MOS value of 0 (zero) indicates that MOS data could not be generated for the operation.
RTT Values
Indicates that round-trip-time statistics appear on the following lines.
NumOfRTT
The number of successful round-trips.
RTTSum
The sum of all successful round-trip values (in milliseconds).
RTTSum2
The sum of squares of those round-trip values (in milliseconds).
PacketLossSD
The number of packets lost from source to destination.
PacketLossDS
The number of packets lost from destination to source.
PacketOutOfSequence
The number of packets returned out of order.
PacketMIA
The number of packets lost where the direction (SD/DS) cannot be determined.
PacketLateArrival
The number of packets that arrived after the timeout.
InternalError
The number of times an operation could not be started due to other internal failures.
Busies
The number of times this operation could not be started because the previously scheduled run was not finished.
Jitter Values
Indicates that jitter statistics appear on the following lines. Jitter is interpacket delay variance.
NumOfJitterSamples
The number of jitter samples collected. This is the number of samples that are used to calculate the following jitter statistics.
MinOfPositivesSD MaxOfPositivesSD
The minimum and maximum positive jitter values from source to destination, in milliseconds.
NumOfPositivesSD
The number of jitter values from source to destination that are positive (that is, network latency increases for two consecutive test packets).
SumOfPositivesSD
The sum of those positive values (in milliseconds).
Sum2PositivesSD
The sum of squares of those positive values.
MinOfNegativesSD MaxOfNegativesSD
The minimum and maximum negative jitter values from source to destination. The absolute value is given.
NumOfNegativesSD
The number of jitter values from source to destination that are negative (that is, network latency decreases for two consecutive test packets).
SumOfNegativesSD
The sum of those values.
Sum2NegativesSD
The sum of the squares of those values.
Interarrival jitterout
The source-to-destination (SD) jitter value calculation, as defined in RFC 1889.
Interarrival jitterin
The destination-to-source (DS) jitter value calculation, as defined in RFC 1889.
One Way Values
Indicates that one-way measurement statistics appear on the following lines.
One Way (OW) values are the amount of time required for the packet to travel from the source router to the target router (SD) or from the target router to the source router (DS).
NumOfOW
Number of successful one-way time measurements.
OWMinSD
Minimum time (in milliseconds) from the source to the destination.
OWMaxSD
Maximum time (in milliseconds) from the source to the destination.
OWSumSD
Sum of the OWMinSD and OWMaxSD values.
OWSum2SD
Sum of the squares of the OWMinSD and OWMaxSD values.
The following is an example of the output from this command for an Ethernet service performance operation:
IPSLAs Latest Operation Statistics
IPSLA operation id: 10
Type of operation: Ethernet Service Performance
Test mode: Two-way Measurement
Steps Tested (kbps): 1000
Test duration: 30 seconds
Latest measurement: 03:48:57.912 IST Fri Feb 15 2013
Latest return code: OK
Overall Throughput: 1000 kbps
Step 1 (1000 kbps):
Stats:
IR(kbps) FL FLR Avail
1000 0 0.00% 100.00%
Tx Packets: 7563 Tx Bytes: 3872256
Rx Packets: 7563 Rx Bytes: 3872256
Step Duration: 30 seconds
The table below describes the significant fields shown in the display for service performance operations.
Field
Description
Type of operation
Type of service performance operation.
Test Mode
Mode of testing such as two-way measurement or traffic generation mode.
Latest return code
Current status of the IP SLAs session.
Stats
Specifies the network performance such as throughput, frame loss, frame loss ratio, and availability of a session.
Tx
Packets or bytes transmitted.
Rx
Packets or bytes received.
Related Commands
Command
Description
showipslaconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
show ip sla statistics aggregated
To display the aggregated statistical errors and distribution information for all Cisco IOS IP Service Level Agreements (SLAs) operations or a specified operation, use the
showipslastatisticsaggregatedcommand in user EXEC or privileged EXEC mode.
(Optional) Number of the IP SLAs operation to display.
details
(Optional) Aggregated statistical information is displayed in greater detail. Distribution information is included when this keyword is specified.
Command Modes
User EXEC (>) Privileged EXEC (#)
Command History
Release
Modification
12.4(4)T
This command was introduced. This command replaces the
showipslamonitorstatisticsaggregatedcommand.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB. This command replaces the
showrtrcollection-statistics,
showrtrdistributions-statistics, and
showrtrtotals-statistics commands.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the
showipslamonitorstatisticsaggregatedcommand.
12.2(33)SXI
This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the
showipslamonitorstatisticsaggregatedcommand.
12.2(58)SE
This command was modified. The command output has been modified to include information about IP SLAs video operations.
15.2(4)M
This command was modified. The command output has been modified to include information about multicast UDP jitter operations.
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
Use this command to display information such as the number of failed operations and the failure reason. The distributions statistics consist of the following:
The sum of completion times (used to calculate the mean)
The sum of the completions times squared (used to calculate standard deviation)
The maximum and minimum completion time
The number of completed attempts
This command shows information collected over the past two hours, unless you specify a different amount of time using the
historyhours-of-statistics-kept command.
Note
This command does not support the IP SLAs ICMP path jitter operation.
Examples
The following sections show sample output from the
showipslastatisticsaggregated and
showipslastatisticsaggregateddetailscommands for different IP SLAs operations:
Examples
The following example shows output from the
showipslastatisticsaggregated and
showipslastatisticsaggregateddetailscommands when the specified operation is a Hypertext Transfer Protocol (HTTP) operation:
Router# show ip sla statistics aggregated 1
Round trip time (RTT) Index 3
DNS RTT: 3004 ms
TCP Connection RTT: 16 ms
HTTP Transaction RTT: 84 ms
Number of successes: 0
Number of failures: 1
Router# show ip sla statistics aggregated 1 details
Round trip time (RTT) Index 3
DNS RTT: 3004
TCP Connection RTT: 0
HTTP Transaction RTT: 0
HTTP time to first byte: 0
DNS TimeOut: 0
TCP TimeOut: 0
Transaction TimeOut: 0
DNS Error: 0
TCP Error: 0
Number of successes: 0
Number of failures: 1
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/0/0/0
Failed Operations due to Internal/Sequence/Verify Error: 1/0/0
Distribution Statistics:
Bucket Range: 0 to < 9ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10 to < 19ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >=20 ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Examples
The following is sample output from the
showipslastatisticsaggregated and
showipslastatisticsaggregateddetailscommands when the specified operation is a User Datagram Protocol (UDP) jitter operation:
Router# show ip sla statistics aggregated 2
Round trip time (RTT) Index 7
RTT Values
Number Of RTT: 10
RTT Min/Avg/Max: 1/1/2 ms
Latency one-way time milliseconds
Number of Latency one-way Samples: 0
Source to Destination Latency one way Latency Min/Avg/Max: 0/0/0 ms
Destination to source Latency one way Min/Avg/Max: 0/0/0 ms
Jitter time milliseconds
Number of Jitter Samples: 9
Source to Destination Jitter Min/Avg/Max: 1/1/1 ms
Destination to Source Jitter Min/Avg/Max: 1/1/1 ms
Packet Loss Values
Loss Source to Destination: 0 Loss Destination to Source: 0
Out Of Sequence: 0 Tail Drop: 0 Packet Late Arrival: 0
Number of successes: 1
Number of failures: 1
Router# show ip sla statistics aggregated 2 details
Round trip time (RTT) Index 7
RTT Values
Number Of RTT: 10
RTT Min/Avg/Max: 1/1/1 ms
Latency one-way time milliseconds
Number of Latency one-way Samples: 0
Source to Destination Latency one way Min/Avg/Max: 0/0/0 ms
Destination to Source Latency one way Min/Avg/Max: 0/0/0 ms
Source to Destination Latency one way Sum/Sum2: 0/0
Destination to Source Latency one way Sum/Sum2: 0/0
Jitter time milliseconds
Number of Jitter Samples: 9
Source to Destination Jitter Min/Avg/Max: 1/1/1 ms
Destination to Source Jitter Min/Avg/Max: 1/1/1 ms
Source to destination positive jitter Min/Avg/Max: 1/1/1 ms
Source to destination positive jitter Number/Sum/Sum2: 1/1/1
Source to destination negative jitter Min/Avg/Max: 1/1/1 ms
Source to destination negative jitter Number/Sum/Sum2: 1/1/1
Destination to Source positive jitter Min/Avg/Max: 1/1/1 ms
Destination to Source positive jitter Number/Sum/Sum2: 2/2/2
Destination to Source negative jitter Min/Avg/Max: 1/1/1 ms
Destination to Source negative jitter Number/Sum/Sum2: 2/2/2
Interarrival jitterout: 0 Interarrival jitterin: 0
Packet Loss Values
Loss Source to Destination: 0 Loss Destination to Source: 0
Out Of Sequence: 0 Tail Drop: 0 Packet Late Arrival: 0
Number of successes: 3
Number of failures: 1
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/23/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Distribution Statistics:
Bucket Range: 0 to < 9ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10 to < 19ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >=20 ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Examples
The following is sample output from the
showipslastatisticsaggregated and
showipslastatisticsaggregateddetailscommands when the specified operation is an Internet Control Message Protocol (ICMP) echo operation:
Router# show ip sla statistics aggregated 3
Round trip time (RTT)Index 3
Start Time Index: 05:31:12.896 PST Wed Sep 3 2003
RTT Values
Number Of RTT: 0
RTT Min/Avg/Max: 0/0/0 ms
Number of successes: 0
Number of failures: 21
Router# show ip sla statistics aggregated 3 details
Round trip time (RTT)Index 3
Start Time Index: 05:31:12.897 PST Wed Sep 3 2003
RTT Values
Number Of RTT: 0
RTT Min/Avg/Max: 0/0/0 ms
Number of successes: 0
Number of failures: 23
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/23/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Distribution Statistics:
Bucket Range: 0 to < 9ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10 to < 19ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >=20 ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Examples
The following is sample output from the
showipslastatisticsaggregated and
showipslastatisticsaggregateddetailscommands when the specified operation is a Transmission Control Protocol (TCP) connect, Domain Name System (DNS), File Transfer Protocol (FTP), Dynamic Host Configuration Protocol (DHCP), or UDP echo operation:
Router# show ip sla statistics aggregated 3
Round trip time (RTT)Index 3
Start Time Index: 05:31:12.896 PST Wed Sep 3 2003
Number of successes: 0
Number of failures: 21
Router# show ip sla statistics aggregated 3 details
Round trip time (RTT)Index 3
Start Time Index: 05:31:12.897 PST Wed Sep 3 2003
Number of successes: 0
Number of failures: 23
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/23/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Distribution Statistics:
Bucket Range: 0 to < 9ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10 to < 19ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >=20 ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Examples
The following is sample output from the
showipslastatisticsaggregated and
showipslastatisticsaggregateddetailscommands when the specified operation is an ICMP path echo operation:
Router# show ip sla statistics aggregated 3
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.896 PST Wed Sep 3 2003
Path Index: 1
Hop in Path Index: 1
Number of successes: 0
Number of failures: 21
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.896 PST Wed Sep 3 2003
Path Index: 2
Hop in Path Index: 1
Number of successes: 0
Number of failures: 21
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.896 PST Wed Sep 3 2003
Path Index: 2
Hop in Path Index: 2
Number of successes: 0
Number of failures: 21
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.896 PST Wed Sep 3 2003
Path Index: 2
Hop in Path Index: 3
Number of successes: 0
Number of failures: 21
.
.
.
Router# show ip sla statistics aggregated 3 details
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.897 PST Wed Sep 3 2003
Path Index: 1
Hop in Path Index: 1
Number of successes: 0
Number of failures: 21
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/21/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Target Address: 10.4.23.44
Distribution Statistics:
Bucket Range: 0 to < 9ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10 to < 19ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >=20 ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.897 PST Wed Sep 3 2003
Path Index: 2
Hop in Path Index: 1
Number of successes: 0
Number of failures: 21
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/21/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Target Address: 10.4.23.44
Distribution Statistics:
Bucket Range: 0 to < 9ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10 to < 19ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >=20 ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.897 PST Wed Sep 3 2003
Path Index: 2
Hop in Path Index: 2
Number of successes: 0
Number of failures: 21
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/21/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Target Address: 10.4.23.44
Distribution Statistics:
Bucket Range: 0 to < 9ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10 to < 19ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >=20 ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Round trip time (RTT) Index 3
Start Time Index: 05:31:12.897 PST Wed Sep 3 2003
Path Index: 2
Hop in Path Index: 3
Number of successes: 0
Number of failures: 21
Failed Operations due to over threshold: 0
Failed Operations due to Disconnect/TimeOut/Busy/No Connection: 0/21/0/0
Failed Operations due to Internal/Sequence/Verify Error: 0/0/0
Target Address: 10.4.23.44
Distribution Statistics:
Bucket Range: 0 to < 9ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: 10 to < 19ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
Bucket Range: >=20 ms
Avg. Latency: 0 ms
Percent of Total Completions for this range: 0%
Number of Completions/Sum of Latency: 0/0/0
Sum of RTT squared low 32 Bits/ Sum of RTT squared high 32 Bits: 0/0
.
.
.
Examples
For multicast UDP jitter operations, the following statements apply:
The fail counter in the per operation Success and Fail (suc/fail) column indicates that the operation failed completely. It does not include operations for which some responders succeeded and others failed.
The Loss column in the per operation results displays the minimum, average, and maximum (Min/Avg/Max) values of packet loss for all multicast receivers.
The Fail counter in per responder statistics means the receiver took part in the operation but the operation to this receiver failed for some reason.
This command was integrated into Cisco IOS XE Release 3.7S.
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.
15.3(2)S
This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
Usage Guidelines
This command displays summary statistics for multicast operations and for unicast on which multiple operations are configured on the same destination IP address or hostname.
Examples
Device# show ip sla summary
ID Type Destination Stats(ms) ReturnCode LastRun
--- ---- ----------- ------- ---------- -------
100 icmp-jitter 192.0.2.2 100 OK 22:49:53 PST Tue May 3 2011
101 udp-jitter 192.0.2.3 100 OK 22:49:53 PST Tue May 3 2011
102 tcp-connect 192.0.2.4 - NoConnection 22:49:53 PST Tue May 3 2011
Device# show ip sla summary destination 192.0.2.2
ID Type Destination State Stats(ms) ReturnCode LastRun
--- ---- ----------- ----- ------- ---------- -------
100 icmp-jitter 192.0.2.2 Active 100 OK 22:49:53 PST Tue May 3 2011
101 udp-jitter 192.0.2.2 Active 100 OK 22:49:53 PST Tue May 3 2011
102 tcp-connect 192.0.2.2 Active - NoConnection 22:49:53 PST Tue May 3 2011
103 video 1232:232 Active 100 OK 22:49:53 PST Tue May 3 2011
::222
104 video 1232:232 Active 100 OK 22:49:53 PST Tue May 3 2011
::222
The table below describes the significant fields shown in the display.
Table 36
show ip sla summary Field Descriptions
Field
Description
ID
IP SLAs operation identifier.
Destination
IP address or hostname of the destination device for the listed operation.
Stats
Round trip time in milliseconds.
show ip sla twamp connection
To display information for current IP Service Level Agreements (SLAs) Two-Way Active Measurement Protocol (TWAMP) connections, use the
show ip sla twamp connection command in privileged EXEC mode.
(Optional) Dislays information for a specific TWAMP connection.
ip-address
IPv4 address of TWAMP connection.
hostname
Hostname of TWAMP connection.
requests
Displays current connection requests.
Command Default
Displays information for all current TWAMP connections.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
15.2(2)S
This command was introduced.
Cisco IOS XE Release 3.6S
This command was integrated into Cisco IOS XE Release 3.6S.
15.2(3)T
This command was integrated into Cisco IOS Release 15.2(3)T.
Examples
Device# show ip sla twamp connection detail
Connection Id: 91
Client IP Address: 172.27.111.225
Client Port: 43026
Mode: Unauthenticated
Connection State: Connected
Control State: None
Number of Test Requests - 0:1
Device# show ip sla twamp connection requests
Connection-Id Client Address Client Port
91 172.27.111.225 43026
Total number of current connections: 1
The table below describes the significant fields shown in the display.
Table 37
show ip sla twamp connection Field Descriptions
Field
Description
Connection- Id
TWAMP connection identifier.
Client IP Address
IPv4 address of the TWAMP control device for the listed connection.
Client Port
Port number for the listed connection.
show ip sla twamp session
To display information and results for IP Service Level Agreements (SLAs) Two-Way Active Measurement Protocol (TWAMP) test sessions, use the
show ip sla twamp session command in privileged EXEC mode.
(Optional) Display results from the TWAMP test session for a specific TWAMP connection.
ip-address
IPv4 or IPv6 address of a TWAMP connection.
hostname
Alphanumeric string that identifies a TWAMP connection.
source-port
Display results from the TWAMP test session for a specific port.
port-number
Port number of the source port. The range is from 1 to 65535.
Command Default
Information and results for all TWAMP test sessions is displayed.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
15.2(2)S
This command was introduced.
Cisco IOS XE Release 3.6S
This command was integrated into Cisco IOS XE Release 3.6S.
15.2(3)T
This command was integrated into Cisco IOS Release 15.2(3)T.
Examples
Device# show ip sla twamp session
IP SLAs Responder TWAMP is: Enabled
Recvr Addr: 172.27.117.116
Recvr Port: 3619
Sender Addr: 172.27.111.225
Sender Port: 32910
Session Id: 172.27.117.116:533112:9C41EC42
Connection Id: 95
In the following example, the IP SLAs TWAMP responder is not disabled.
Device(config)# no ip sla responder twamp
Device(config)# exit
Device# show ip sla twamp session
IP SLAs Responder TWAMP is: Disabled
The table below describes the significant fields shown in the display.
Table 38
show ip sla twamp session Field Descriptions
Field
Description
Recvr Addr
IP address of the session-reflector on the IP SLAs TWAMP responder.
Recvr Port
Port number of the TWAMP server on the IP SLAs TWAMP responder.
Sender Addr
IP address of the session-sender on the TWAMP control device.
Sender Port
Port number of the session-sender entity on the control device.
Related Commands
Command
Description
ip sla responder twamp
Sets up a TWAMP responder.
show ip sla twamp standards
To display a list of Two-Way Active Measurement Protocol (TWAMP) standards that are implemented on a Cisco device, use the
show ip sla twamp standards command in privileged EXEC mode.
show
ipslatwampstandards
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
15.2(2)S
This command was introduced.
Cisco IOS XE Release 3.6S
This command was integrated into Cisco IOS XE Release 3.6S.
15.2(3)T
This command was integrated into Cisco IOS Release 15.2(3)T.
Usage Guidelines
The list of supported standards depends on the Cisco software release running on your device.
Examples
The following sample output shows which TWAMP standards are implemented in a Cisco software release that supports IP SLAs TWAMP Responder v1.0:
Device# show ip sla twamp standards
Feature Organization Standard
TWAMP Server IETF draft-ietf-ippm-twamp-06
TWAMP Reflector IETF draft-ietf-ippm-twamp-06
show mpls discovery vpn
To display routing information relating to the Multiprotocol Label Switching (MPLS) Virtual Private Network (VPN) Border Gateway Protocol (BGP) next hop neighbor discovery process, use the
showmplsdiscoveryvpncommand in user EXEC or privileged EXEC mode.
showmplsdiscoveryvpn
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(27)SBC
This command was introduced.
12.4(6)T
This command was integrated into Cisco IOS Release 12.4(6)T.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.0(32)SY
This command was integrated into Cisco IOS Release 12.0(32)SY.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
Examples
The following is sample output from the
showmplsdiscoveryvpn command:
Router# show mpls discovery vpn
Refresh interval set to 60 seconds.
Next refresh in 46 seconds
Next hop 10.10.10.5 (Prefix: 10.10.10.5/32)
in use by: red, blue, green
Next hop 10.10.10.7 (Prefix: 10.10.10.7/32)
in use by: red, blue, green
Next hop 10.10.10.8 (Prefix: 10.10.10.8/32)
in use by: red, blue, green
The table below describes the fields shown in the display.
Table 39 show mpls discovery vpn Field Descriptions
Field
Description
Refresh interval
The time interval at which routing entries that are no longer valid are removed from the BGP next hop neighbor discovery database. The default time interval is 300 seconds.
Next refresh
The amount of time left before the next refresh interval starts.
Next hop
Identifier for the BGP next hop neighbor.
Prefix
IPv4 Forward Equivalence Class (FEC) of the BGP next hop neighbor to be used by the MPLS LSP ping operation.
in use by
Names of the VPN routing and forwarding (VRF) instances that contain routing entries for the specified BGP next hop neighbor.
Related Commands
Command
Description
mplsdiscoveryvpninterval
Specifies the time interval at which routing entries that are no longer valid are removed from the BGP next hop neighbor discovery database of an MPLS VPN.
mplsdiscoveryvpnnext-hop
Enables the MPLS VPN BGP next hop neighbor discovery process.
show rtr application
Note
Effective with Cisco IOS Release 12.3(14)T and 12.2(31)SB2, the showrtrapplicationcommand is replaced by the showipslamonitorapplicationcommand. Effective with Cisco IOS Release 12.2(33)SRB, the showrtrapplicationcommand is replaced by the showipslaapplicationcommand. See the showipslamonitorapplicationand showipslaapplicationcommands for more information.
To display global information about Cisco IOS IP Service Level Agreements (IP SLAs), use the showrtrapplication command in user EXEC or privileged EXEC mode.
showrtrapplication
[ tabular | full ]
Syntax Description
tabular
(Optional) Displays information in a column format reducing the number of screens required to display the information.
full
(Optional) Displays all information using identifiers next to each displayed value. This is the default.
Command Default
Full format
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
11.2
This command was introduced.
12.3(14)T
This command was replaced by the showipslamonitorapplicationcommand.
12.2(31)SB2
This command was replaced by the showipslamonitorapplicationcommand.
12.2(33)SRB
This command was replaced by the showipslaapplicationcommand.
Usage Guidelines
Use the showrtrapplicationcommand to display information such as supported operation types and supported protocols.
Examples
The following is sample output from the showrtrapplication command in full format:
Router# show rtr application
SA Agent
Version: 2.2.0 Round Trip Time MIB
Time of last change in whole RTR: *17:21:30.819 UTC Tue Mar 19 2002
Estimated system max number of entries: 4699
Number of Entries configured:5
Number of active Entries:5
Number of pending Entries:0
Number of inactive Entries:0
Supported Operation Types
Type of Operation to Perform: echo
Type of Operation to Perform: pathEcho
Type of Operation to Perform: udpEcho
Type of Operation to Perform: tcpConnect
Type of Operation to Perform: http
Type of Operation to Perform: dns
Type of Operation to Perform: jitter
Type of Operation to Perform: dlsw
Type of Operation to Perform: dhcp
Type of Operation to Perform: ftp
Supported Protocols
Protocol Type: ipIcmpEcho
Protocol Type: ipUdpEchoAppl
Protocol Type: snaRUEcho
Protocol Type: snaLU0EchoAppl
Protocol Type: snaLU2EchoAppl
Protocol Type: ipTcpConn
Protocol Type: httpAppl
Protocol Type: dnsAppl
Protocol Type: jitterAppl
Protocol Type: dlsw
Protocol Type: dhcp
Protocol Type: ftpAppl
Number of configurable probe is 490
Related Commands
Command
Description
showrtrconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
show rtr authentication
Note
Effective with Cisco IOS Release 12.3(14)T and 12.2(31)SB2, the showrtrauthenticationcommand is replaced by the showipslamonitorauthenticationcommand. Effective with Cisco IOS Release 12.2(33)SRB, the showrtrauthenticationcommand is replaced by the showipslaauthenticationcommand. See the showipslamonitorauthenticationand showipslaauthenticationcommands for more information.
To
display Cisco IOS IP Service Level Agreements (IP SLAs) authentication information, use the showrtrauthentication command in user EXEC or privileged EXEC mode.
showrtrauthentication
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.0(3)T
This command was introduced.
12.3(14)T
This command was replaced by the showipslamonitorauthenticationcommand.
12.2(31)SB2
This command was replaced by the showipslamonitorauthenticationcommand.
12.2(33)SRB
This command was replaced by the showipslaauthenticationcommand.
Usage Guidelines
Use the showrtrauthenticationcommand to display information such as supported operation types and supported protocols.
Examples
The following is sample output from the showrtrauthenticationcommand:
Router# show rtr authentication
RTR control message uses MD5 authentication, key chain name is: rtr
Related Commands
Command
Description
showrtrconfiguration
Displays configuration values for IP SLAs operations.
show rtr collection-statistics
Note
Effective with Cisco IOS Release 12.3(14)T , the showrtrcollection-statisticscommand is replaced by the showipslamonitorcollection-statisticscommand. Effective with 12.2(31)SB2, the showrtrcollection-statisticscommand is replaced by the showipslamonitorstatisticsaggregatedcommand. Effective with Cisco IOS Release 12.2(33)SRB, the showrtrcollection-statisticscommand is replaced by the showipslastatisticsaggregatedcommand. See the showipslamonitorcollection-statistics, showipslamonitorstatisticsaggregated, and showipslastatisticsaggregatedcommands for more information.
To display statistical errors for all Cisco IOS IP Service Level Agreements (IP SLAs) operations or a specified operation, use the showrtrcollection-statisticscommand in user EXEC or privileged EXEC mode.
showrtrcollection-statistics [operation-number]
Syntax Description
operation-number
(Optional) Number of the IP SLAs operation to display.
Command Default
Shows statistics for the past two hours.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
11.2
This command was introduced.
12.0(5)T
The output for this command was expanded to show information for Jitter operations.
12.1
The tabular and full keywords were removed.
12.1(1)T
The output for this command was expanded to show information for the FTP operation type and for One Way Delay Jitter operations.
12.2(8)T, 12.2(8)S
Output for “NumOfJitterSamples” was added (CSCdv30022).
12.2(11)T
The SAA Engine II was implemented. The maximum number of operations was increased from 500 to 2000.
12.3(4)T
Output (MOS and ICPIF scores) for the Jitter (codec) operation type was added.
12.3(7)T
Decimal granularity for MOS scores was added.
12.3(14)T
This command was replaced by the showipslamonitorcollection-statisticscommand.
12.2(31)SB2
This command was replaced by the showipslamonitorstatisticsaggregatedcommand.
12.2(33)SRB
This command was replaced by the showipslastatisticsaggregatedcommand.
Usage Guidelines
Use the showrtrcollection-statistics command to display information such as the number of failed operations and the failure reason. You can also use the showrtrdistribution-statistics and showrtrtotals-statistics commands to display additional statistical information.
This command shows information collected over the past two hours, unless you specify a different amount of time using the hours-of-statistics-kept command.
For One Way Delay Jitter operations, the clocks on each device must be synchronized using NTP (or GPS systems). If the clocks are not synchronized, one way measurements are discarded. (If the sum of the source to destination (SD) and the destination to source (DS) values is not within 10 percent of the round trip time, the one way measurement values are assumed to be faulty, and are discarded.)
Note
This command does not support the IP SLAs ICMP path jitter operation.
Examples
The following shows sample output from the showrtrcollection-statistics command in full format.
Router# show rtr collection-statistics 1
Collected Statistics
Entry Number: 1
Start Time Index: *17:15:41.000 UTC Thu May 16 1996
Path Index: 1
Hop in Path Index: 1
Number of Failed Operations due to a Disconnect: 0
Number of Failed Operations due to a Timeout: 0
Number of Failed Operations due to a Busy: 0
Number of Failed Operations due to a No Connection: 0
Number of Failed Operations due to an Internal Error: 0
Number of Failed Operations due to a Sequence Error: 0
Number of Failed Operations due to a Verify Error: 0
Target Address: 172.16.1.176
Examples
The following example shows output from the show rtr collection-statistics command when the specified operation is an HTTP operation:
The following is sample output from the showrtrcollection-statistics command, where operation 2 is a Jitter operation that includes One Way statistics:
The values shown indicate the aggregated values for the current hour. RTT stands for Round-Trip-Time. SD stands for Source-to-Destination. DS stands for Destination-to-Source. OW stands for One Way. Table 1
describes the significant fields shown in this output.
Examples
The following is sample output from the showrtrcollection-statistics command, where operation 10 is a Jitter (codec) operation:
Router# show rtr collection-statistics 10
Entry number: 10
Start Time Index: 13:18:49.904 PST Mon Jun 24 2002
Number of successful operations: 2
Number of operations over threshold: 0
Number of failed operations due to a Disconnect: 0
Number of failed operations due to a Timeout: 0
Number of failed operations due to a Busy: 0
Number of failed operations due to a No Connection: 0
Number of failed operations due to an Internal Error: 0
Number of failed operations due to a Sequence Error: 0
Number of failed operations due to a Verify Error: 0
Voice Scores:
MinOfICPIF: 0 MaxOfICPIF: 0 MinOfMOS: 0 MaxOfMOS: 0
RTT Values:
NumOfRTT: 122 RTTAvg: 2 RTTMin: 2 RTTMax: 3
RTTSum: 247 RTTSum2: 503
Packet Loss Values:
PacketLossSD: 0 PacketLossDS: 0
PacketOutOfSequence: 0 PacketMIA: 0 PacketLateArrival: 0
InternalError: 0 Busies: 0 PacketSkipped: 78 <<<<<===========
Jitter Values:
MinOfPositivesSD: 1 MaxOfPositivesSD: 1
NumOfPositivesSD: 9 SumOfPositivesSD: 9 Sum2PositivesSD: 9
MinOfNegativesSD: 1 MaxOfNegativesSD: 1
NumOfNegativesSD: 8 SumOfNegativesSD: 8 Sum2NegativesSD: 8
MinOfPositivesDS: 1 MaxOfPositivesDS: 1
NumOfPositivesDS: 6 SumOfPositivesDS: 6 Sum2PositivesDS: 6
MinOfNegativesDS: 1 MaxOfNegativesDS: 1
NumOfNegativesDS: 7 SumOfNegativesDS: 7 Sum2NegativesDS: 7
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
Table 40 show rtr collection-statistics Field Descriptions
Field
Description
Voice Scores:
Indicates that Voice over IP statistics appear on the following lines. Voice score data is computed when the operation type is configured as typejitter(codec).
ICPIF
The Calculated Planning Impairment Factor (ICPIF) value for the operation. The ICPIF value is computed by IP SLAs using the formula Icpif=Io+Iq+Idte+Idd+Ie-A, where
the values for Io
, Iq
, and Idte
are set to zero,
the value Idd
is computed based on the measured one way delay,
the value Ie
is computed based on the measured packet loss,
and the value of A is specified by the user.
ICPIF values are expressed in a typical range of 5 (very low impairment) to 55 (very high impairment). ICPIF values numerically less than 20 are generally considered “adequate.”
Note
This value is intended only for relative comparisons, and may not match ICPIF values generated using alternate methods.
MinOfICPIF:
The lowest (minimum) ICPIF value computed for the collected statistics.
MaxOfICPIF:
The highest (maximum) ICPIF value computed for the collected statistics.
Mos
The estimated Mean Opinion Score (Conversational Quality, Estimated) for the latest iteration of the operation. The MOS-CQE is computed by IP SLAs as a function of the ICPIF.
MOS values are expressed as a number from 1 (1.00) to 5 (5.00), with 5 being the highest level of quality, and 1 being the lowest level of quality. A MOS value of 0 (zero) indicates that MOS data could not be generated for the operation.
MinOfMos:
The lowest (minimum) MOS value computed for the collected statistics.
MaxOfMos:
The highest (maximum) ICPIF value computed for the collected statistics.
RTT Values:
Indicates that Round-Trip-Time statistics appear on the following lines.
NumOfRTT
The number of successful round trips.
RTTSum
The sum of all successful round trip values (in milliseconds).
RTTSum2
The sum of squares of those round trip values (in milliseconds).
PacketLossSD
The number of packets lost from source to destination.
PacketLossDS
The number of packets lost from destination to source.
PacketOutOfSequence
The number of packets returned out of order.
PacketMIA
The number of packets lost where the direction (SD/DS) cannot be determined.
PacketLateArrival
The number of packets that arrived after the timeout.
PacketSkipped
The number of packets that are not sent during the IP SLAs jitter operation.
InternalError
The number of times an operation could not be started due to other internal failures.
Busies
The number of times this operation could not be started because the previously scheduled run was not finished.
Jitter Values:
Indicates that Jitter statistics appear on the following lines.
Jitter is inter-packet delay variance.
NumOfJitterSamples:
The number of jitter samples collected. This is the number of samples that are used to calculate the following jitter statistics.
MinOfPositivesSD
MaxOfPositivesSD
The minimum and maximum positive jitter values from source to destination, in milliseconds.
NumOfPositivesSD
The number of jitter values from source to destination that are positive (i.e., network latency increases for two consecutive test packets).
SumOfPositivesSD
The sum of those positive values (in milliseconds).
Sum2PositivesSD
The sum of squares of those positive values.
MinOfNegativesSD
MaxOfNegativesSD
The minimum and maximum negative jitter values from source to destination. The absolute value is given.
NumOfNegativesSD
The number of jitter values from source to destination that are negative (i.e., network latency decreases for two consecutive test packets).
SumOfNegativesSD
The sum of those values.
Sum2NegativesSD
The sum of the squares of those values.
Interarrival jitterout:
The source to destination (SD) jitter value calculation, as defined in RFC 1889.
Interarrival jitterin:
The destination to source (DS) jitter value calculation, as defined in RFC 1889.
One Way Values
Indicates that one way measurement statistics appear on the following lines.
One Way (OW) Values are the amount of time it took the packet to travel from the source router to the target router (SD) or from the target router to the source router (DS).
NumOfOW
Number of successful one way time measurements.
OWMinSD
Minimum time from the source to the destination.
OWMaxSD
Maximum time from the source to the destination.
OWSumSD
Sum of the OWMinSD and OWMaxSD values.
OWSum2SD
Sum of the squares of the OWMinSD and OWMaxSD values.
The DS values show the same information as above for Destination-to-Source Jitter values.
Related Commands
Command
Description
showntpstatus
Displays the status of the Network Time Protocol configuration on your system.
showrtrconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
showrtrdistributions-statistics
Displays statistic distribution information (captured response times) for all IP SLAs operations or the specified operation.
showrtrtotals-statistics
Displays the total statistical values (accumulation of error counts and completions) for all IP SLAs operations or the specified operation.
show rtr configuration
Note
Effective with Cisco IOS Release 12.3(14)T and 12.2(31)SB2, the showrtrconfigurationcommand is replaced by the showipslamonitorconfigurationcommand. Effective with Cisco IOS Release 12.2(33)SRB, the showrtrconfigurationcommand is replaced by the showipslaconfigurationcommand. See the showipslamonitorconfigurationand showipslaconfigurationcommands for more information.
To display configuration values including all defaults for all Cisco IOS IP Service Level Agreements (IP SLAs) operations or the specified operation, use the showrtrconfiguration command in user EXEC or privileged EXEC mode.
showrtrconfiguration [operation]
Syntax Description
operation
(Optional) Number of the IP SLAs operation for, which the details will be displayed.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
11.2
This command was introduced.
12.1
The tabular and full keywords were removed.
12.3(2)T
Output was added to show the VRF assignment name (if configured).
12.3(4)T
Output specific to the jitter (codec) operation type was added.
12.3(7)T
Output pertaining to reaction configuration (threshold values, reaction types) was removed from the output. Reaction configuration is now displayed using the showrtrreaction-configuration command.
12.3(8)T
Output was added to show the group schedule and the recurring schedule details for the IP SLAs operations.
12.2(25)S
This command was integrated into Cisco IOS Release 12.2(25)S. This integration includes the addition of output to show the group schedule and recurring schedule details for the IP SLAs operations.
12.3(14)T
This command was replaced by the showipslamonitorconfigurationcommand.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC. This integration includes the addition of output to show the group schedule and recurring schedule details for the IP SLAs operations.
12.2(31)SB2
This command was replaced by the showipslamonitorconfigurationcommand.
12.2(33)SRB
This command was replaced by the showipslaconfigurationcommand.
Examples
The following is sample output from the showrtrconfiguration command for an IP SLAs Echo operation:
Router# show rtr configuration
Complete Configuration Table (includes defaults)
Entry Number: 1
Owner: “Sample Owner”
Tag: “Sample Tag Group”
Type of Operation to Perform: echo
Reaction and History Threshold (milliseconds): 5000
Operation Frequency (seconds): 60
Operation Timeout (milliseconds): 5000
Verify Data: FALSE
Status of Entry (SNMP RowStatus): active
Protocol Type: ipIcmpEcho
Target Address: 172.16.1.176
Request Size (ARR data portion): 1
Response Size (ARR data portion): 1
Life (seconds): 3600
Next Start Time: Start Time already passed
Entry Ageout (seconds): 3600
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
Number of Statistic Distribution Intervals (milliseconds): 20
Number of History Lives kept: 0
Number of History Buckets kept: 50
Number of History Samples kept: 1
History Filter Type: none
The following is sample output from the showrtrconfiguration command that verifies the configuration of an IP SLAs HTTP operation:
Router# show rtr configuration
Complete Configuration Table (includes defaults)
Entry Number:3
Owner:Joe
Tag:AppleTree
Type of Operation to Perform:http
Reaction and History Threshold (milliseconds):5000
Operation Frequency (seconds):60
Operation Timeout (milliseconds):5000
Verify Data:FALSE
Status of Entry (SNMP RowStatus):active
Protocol Type:httpAppl
Target Address:
Source Address:0.0.0.0
Target Port:0
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:0x0
HTTP Operation:get
HTTP Server Version:1.0
URL:http://www.cisco.com
Cache Control:enabled
Life (seconds):3600
Next Scheduled Start Time:Start Time already passed
Entry Ageout:never
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
The following is sample output from the showrtrconfiguration command that shows output for a PathJitter operation associated with the VPN vrf1:
Router# show rtr configuration 1
Entry number: 1
Owner:
Tag:
Type of operation to perform: pathJitter
Destination address: 171.69.1.129
Source address: 0.0.0.0
Number of packets: 10
Interval (milliseconds): 20
Target Only: Disabled
Request size (ARR data portion): 1
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Verify data: No
Loose Source Routing: Disabled
Vrf Name: vrf1
LSR Path:
Operation frequency (seconds): 60
Next Scheduled Start Time: Start Time already passed
Life (seconds): 2000
Entry Ageout (seconds): never
Status of entry (SNMP RowStatus): Active
The following is sample output from the showrtrconfiguration command that includes output for the typejitter(codec) operation for VoIP metric monitoring:
Router# show rtr configuration
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
Threshold (milliseconds): 5000
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 1
Statistic distribution interval (milliseconds): 20
Enhanced History:
The following is sample output from the showrtrconfiguration command for a recurring IP SLAs operation, with the recurring state as TRUE:
Router# show rtr configuration
Entry number: 5
Owner:
Tag:
Type of operation to perform: udpEcho
Target address: 10.2.31.121
Source address: 0.0.0.0
Target port: 989
Source port: 0
Request size (ARR data portion): 16
Operation timeout (milliseconds): 5000
Type Of Service parameters: 0x0
Verify data: No
Data pattern:
Vrf Name:
Control Packets: enabled
Operation frequency (seconds): 60
Next Scheduled Start Time: Start Time already passed
Group Scheduled: FALSE
Group Schedule Entry number :
Life (seconds): 3600
Entry Ageout (seconds): never
Recurring (Starting everyday): TRUE
Status of entry (SNMP RowStatus): Active
Connection loss reaction enabled: No
Related Commands
Command
Description
showrtrapplication
Displays global information about the IP SLAs feature.
showrtrcollection-statistics
Displays statistical errors for all IP SLAs operations or the specified operation.
showrtrdistributions-statistics
Displays statistic distribution information (captured response times) for all IP SLAs operations or the specified operation.
showrtrgroupschedule
Displays the group schedule details of the specified IP SLAs operation.
showrtrhistory
Displays history collected for all IP SLAs operations or the specified operation.
showrtroperational-state
Displays the operational state of all IP SLAs operations or the specified operation.
showrtrreaction-trigger
Displays the reaction trigger information for all IP SLAs operations or the specified operation.
showrtrtotals-statistics
Displays the total statistical values (accumulation of error counts and completions) for all IP SLAs operations or the specified operation.
show rtr distributions-statistics
Note
Effective with Cisco IOS Release 12.3(14)T , the showrtrdistributions-statisticscommand is replaced by the showipslamonitordistributions-statisticscommand. Effective with Cisco IOS Release 12.2(31)SB2, the showrtrdistributions-statisticscommand is replaced by the showipslamonitorstatisticsaggregatedcommand. Effective with Cisco IOS Release 12.2(33)SRB, the showrtrdistributions-statisticscommand is replaced by the showipslastatisticsaggregatedcommand. See the showipslamonitordistributions-statistics, showipslamonitorstatisticsaggregated, and showipslastatisticsaggregatedcommands for more information.
To display statistic distribution information (captured response times) for all Cisco IOS IP Service Level Agreements (IP SLAs) operations or the specified operation, use the showrtrdistributions-statistics command in user EXEC or privileged EXEC mode.
showrtrdistributions-statistics [operation]
[ tabular | full ]
Syntax Description
operation
(Optional) Number of the IP SLAs operation to display.
tabular
(Optional) Displays information in a column format reducing the number of screens required to display the information. This is the default.
full
(Optional) Displays all information using identifiers next to each displayed value.
Command Default
Tabular format for all operations is displayed.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
11.2
This command was introduced.
12.3(14)T
This command was replaced by the showipslamonitordistributions-statisticscommand.
12.2(31)SB2
This command was replaced by the showipslamonitorstatisticsaggregatedcommand.
12.2(33)SRB
This command was replaced by the showipslastatisticsaggregatedcommand.
Usage Guidelines
The distributions statistics
consist of the following:
The sum of completion times (used to calculate the mean)
The sum of the completions times squared (used to calculate standard deviation)
The maximum and minimum completion time
The number of completed attempts
Note
This command does not support the IP SLAs ICMP path jitter operation.
You can also use the showrtrcollection-statistics and showrtrtotals-statistics commands to display additional statistical information.
Examples
The following is sample output from the showrtrdistributions-statistics command in tabular format when the output is split over multiple lines
Router# show rtr distributions-statistics
Captured Statistics
Multiple Lines per Entry
Line 1
Entry = Entry Number
StartT = Start Time of Entry (hundredths of seconds)
Pth = Path Index
Hop = Hop in Path Index
Dst = Time Distribution Index
Comps = Operations Completed
OvrTh = Operations Completed Over Thresholds
SumCmp = Sum of Completion Times (milliseconds)
Line 2
SumCmp2L = Sum of Completion Times Squared Low 32 Bits (milliseconds)
SumCmp2H = Sum of Completion Times Squared High 32 Bits (milliseconds)
TMax = Completion Time Maximum (milliseconds)
TMin = Completion Time Minimum (milliseconds)
Entry StartT Pth Hop Dst Comps OvrTh SumCmp
SumCmp2L SumCmp2H TMax TMin
1 17417068 1 1 1 2 0 128
8192 0 64 64
The following example shows the output as it appears on a single line:
Displays statistical errors for all IP SLAs operations or the specified operation.
showrtrconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
showrtrtotals-statistics
Displays the total statistical values (accumulation of error counts and completions) for all IP SLAs operations or the specified operation.
show rtr enhanced-history collection-statistics
Note
Effective with Cisco IOS Release 12.3(14)T and 12.2(31)SB2, the
showrtrenhanced-historycollection-statisticscommand is replaced by the
showipslamonitorenhanced-historycollection-statisticscommand. Effective with Cisco IOS Release 12.2(33)SRB, the
showrtrenhanced-historycollection-statisticscommand is replaced by the
showipslaenhanced-historycollection-statisticscommand. See the
showipslamonitorenhanced-historycollection-statisticsand
showipslaenhanced-historycollection-statisticscommands for more information.
To display enhanced history statistics for all collected history buckets for the specified Cisco IOS IP Service Level Agreements (IP SLAs) operation, use the
showrtrenhanced-historycollection-statistics command in user EXEC or privileged EXEC mode.
(Optional) Displays enhanced history distribution statistics for only the specified operation.
intervalseconds
(Optional) Displays enhanced history distribution statistics for only the specified aggregation interval.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(15)T
This command was introduced.
12.3(14)T
This command was replaced by the
showipslamonitorenhanced-historycollection-statisticscommand.
12.2(25)S
This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2
This command was replaced by the
showipslamonitorenhanced-historycollection-statisticscommand.
12.2(33)SRB
This command was replaced by the
showipslaenhanced-historycollection-statisticscommand.
Usage Guidelines
This command displays data for each bucket of enhanced history data shown individually (one after the other).
The number of buckets and the collection interval is set using theenhanced-historyintervalsecondsbucketsnumber-of-buckets RTR configuration command.
Examples
The following example shows sample output for the
showrtrenhanced-historycollection-statistics command. The output of this command will vary depending on the type of IP SLAs operation.
Router# show rtr enhanced-history collection-statistics 1
Entry number: 1
Aggregation Interval: 900
Bucket Index: 1
Aggregation start time 00:15:00.003 UTC Thur May 1 2003
Target Address:
Number of failed operations due to a Disconnect: 0
Number of failed operations due to a Timeout: 0
Number of failed operations due to a Busy: 0
Number of failed operations due to a No Connection: 0
Number of failed operations due to an Internal Error: 0
Number of failed operations due to a Sequence Error: 0
Number of failed operations due to a Verify Error: 0
.
.
.
The table below describes the significant fields shown in the display.
Table 41 show rtr enhanced-history collection-statistics Field Descriptions
Field
Description
Aggregation Interval:
The number of seconds the operation runs for each enhanced history bucket. For example, a value of 900 indicates that statistics were gathered for 15 minutes before the next bucket was created.
Bucket Index:
The number identifying the collection bucket. The number of buckets is set using the
enhanced-history RTR configuration command.
show rtr enhanced-history distribution-statistics
Note
Effective with Cisco IOS Release 12.3(14)T and 12.2(31)SB2, the
showrtrenhanced-historydistribution-statisticscommand is replaced by the
showipslamonitorenhanced-historydistribution-statisticscommand. Effective with Cisco IOS Release 12.2(33)SRB, the
showrtrenhanced-historydistribution-statisticscommand is replaced by the
showipslaenhanced-historydistribution-statisticscommand. See the
showipslamonitorenhanced-historydistribution-statisticsand
showipslaenhanced-historydistribution-statisticscommands for more information.
To display enhanced history distribution statistics for Cisco IOS IP Service Level Agreements (IP SLAs) operations in tabular format, use the
showrtrenhanced-historydistribution-statistics command in user EXEC or privileged EXEC mode.
(Optional) Displays enhanced history distribution statistics for only the specified operation.
intervalseconds
(Optional) Displays enhanced history distribution statistics for only the specified aggregation interval for only the specified operation.
The range is from 1 to 3600 (1 hour). The default is 900.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.3(1)
This command was introduced.
12.3(14)T
This command was replaced by the
showipslamonitorenhanced-historydistribution-statisticscommand.
12.2(25)S
This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2
This command was replaced by the
showipslamonitorenhanced-historydistribution-statisticscommand.
12.2(33)SRB
This command was replaced by the
showipslaenhanced-historydistribution-statisticscommand.
Usage Guidelines
The distribution statistics consist of the following:
The sum of completion times (used to calculate the mean)
The sum of the completion times squared (used to calculate standard deviation)
The maximum and minimum completion times
The number of completed attempts
You can also use the following commands to display additional statistics or history information, or to view the status of the operation:
showrtrenhanced-historycollection-statistics
showrtrenhanced-historytotals-statistics
Tip
If the character ‘n’ appears in your output, or not all fields are displayed, you should increase the screen width for your CLI display (for example, using the
width line configuration command or the
terminalwidth EXEC mode command).
Examples
The following is sample output from the
showrtrenhanced-historydistribution-statistics command. The fields are defined at the beginning of the output for the command. RTT means round-trip-time.
Router# show rtr enhanced-history distribution-statistics 3
Point by point Enhanced History
Entry = Entry Number
Int = Aggregation Interval (seconds)
BucI = Bucket Index
StartT = Aggregation Start Time
Pth = Path index
Hop = Hop in path index
Comps = Operations completed
OvrTh = Operations completed over thresholds
SumCmp = Sum of RTT (milliseconds)
SumCmp2L = Sum of RTT squared low 32 bits (milliseconds)
SumCmp2H = Sum of RTT squared high 32 bits (milliseconds)
TMax = RTT maximum (milliseconds)
TMin = RTT minimum (milliseconds)
Entry Int BucI StartT Pth Hop Comps OvrTh SumCmp SumCmp2L SumCmp2H TMax TMin
3 900 1 257850000 1 1 3 0 43 617 0 15 14
3 900 2 258750002 1 1 3 0 45 677 0 16 14
3 900 3 259650000 1 1 3 0 44 646 0 15 14
3 900 4 260550002 1 1 3 0 42 594 0 15 12
3 900 5 261450003 1 1 3 0 42 590 0 15 13
3 900 6 262350001 1 1 3 0 46 706 0 16 15
3 900 7 263250003 1 1 3 0 46 708 0 16 14
.
.
.
The time elapsed between BucketIndex 1 (started at 257,850,000) and BucketIndex 2 (started at 258,750,002) in this example is 900,002 milliseconds, or 900 seconds.
The table below describes the significant fields shown in the display.
Table 42 show rtr enhanced-history distribution-statistics Field Descriptions
Field
Description
Entry
The operation ID number you specified for the IP SLAs operation.
Int
Aggregation interval--The configured statistical distribution buckets interval, in seconds. For example, a value of 900 for Int means that statistics are gathered for 900 seconds per bucket.
BucI
Bucket index number--A number uniquely identifying the statistical distribution (aggregation) bucket.
The number of history buckets to be kept is configured using the
buckets-of-history-kept command.
A bucket will gather statistics for the specified interval of time (aggregation interval), after which a new statistics bucket is created.
If a number-of-buckets-kept value is configured, the interval for the last bucket is infinity (until the end of the operation).
Buckets are not applicable to HTTP and UDP jitter monitoring operations.
This field is equivalant to the rttMonStatsCaptureDistIndex object in the Cisco RTTMON MIB.
StartT
Aggregation start time--Start time for the aggregation interval (per Bucket Index).
Shows the start time as the number of milliseconds since the router started; in other words, the time stamp is the number of milliseconds since the last system bootup.
Pth
Path index number--An identifier for a set of different paths to the target destination that have been discovered. For example, if the first operation iteration finds the path h1, h2, h3, h4, then this path is labeled as 1. If, on a later iteration, a new path is discovered, (such as h1, h2, h5, h6, h4) then this new path will be identified as 2, and so on.
Data collection per path is available only for ICMP path echo operations (“pathEcho probes”). For all other operations, a value of 1 will always appear.
Data collection per path is configured using the
paths-of-statistics-keptnumber command when configuring the operation.
Hop
Hop Index Number--Statistics data per hop. A hop is data transmission between two points in a path (for example, from device h2 to device h3).
Data collection per hop is available only for ICMP path echo operations (“pathEcho probes”). For all other operations, a value of “1” will always appear.
Data collection per hop is configured using the
hops-of-statistics-keptnumber command when configuring the operation.
This field is equivalent to the rrttMonStatsCaptureHopIndex object in the Cisco RTTMON MIB.
Comps
Completions--The number of round-trip time operations that have completed without an error and without timing out, per bucket index.
This object has the special behavior as defined by the ROLLOVER NOTE in the DESCRIPTION of the Cisco Rttmon MIB object.
SumCmp
Sum of completed operation times (1)--The total of all round-trip time values for all succesful operations in the row, in milliseconds.
SumCmp2L
Sum of the squares of completed operation times (2), Low-Order--The sum of the square roots of round-trip times for operations that were successfully measured, in milliseconds; displays the low-order 32 bits of the value only.
32 low-order bits and 32 high-order bits are ordered in unsigned 64-bit integers (Int64) as follows:
-------------------------------------------------
| High-order 32 bits | Low-order 32 bits |
-------------------------------------------------
The “SumCmp2” values are split into “high-order” and “low-order” numbers because of limitations of Simple Network Management Protocol (SNMP). The maximum value allowed for an SNMP object is 4,294,967,295 (the Gauge32 limit).
If the sum of the square roots for your operation exceeds this value, then the “high-order” value will be utilized. (For example, the number 4,294,967,296 would have all low-order bits as 0, and the right-most high-order bit would be 1).
The low-order value (SumCmp2L) appears first in the output because in most cases, the value will be less than 4,294,967,295, which means that the value of SumCmp2H will appear as zero.
SumCmp2H
Sum of the squares of completed operation times (2), High-Order--The high-order 32 bits of the accumulated squares of completion times (in milliseconds) of operations that completed successfully.
TMax
Round-trip time, maximum--The highest recorded round-trip time, in milliseconds, per aggregation interval.
TMin
Round-trip time, minimum--The lowest recorded round-trip time, in milliseconds, per aggregation interval.
Related Commands
Command
Description
rtr
Begins configuration for an IP SLAs operation and enters RTR configuration mode.
showrtrenhanced-historycollection-statistics
Displays data for all collected history buckets for the specified IP SLAs operation, with data for each bucket shown individually.
show rtr group schedule
Note
Effective with Cisco IOS Release 12.3(14)T and 12.2(31)SB2, the
showrtrgroupschedulecommand is replaced by the
showipslamonitorgroupschedulecommand. Effective with Cisco IOS Release 12.2(33)SRB, the
showrtrgroupschedulecommand is replaced by the
showipslagroupschedulecommand. See the
showipslamonitorgroupscheduleand
showipslagroupschedulecommands for more information.
To display the group schedule details of Cisco IOS IP Service Level Agreements (IP SLAs) operations, use the
showrtrgroupschedulecommand in user EXEC or privileged EXEC mode.
showrtrgroupschedule [group-operation-number]
Syntax Description
group-operation-number
(Optional) Number of the IP SLAs group operation to display.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.3(8)T
This command was introduced.
12.3(14)T
This command was replaced by the
showipslamonitorgroupschedulecommand.
12.2(25)S
This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2
This command was replaced by the
showipslamonitorgroupschedulecommand.
12.2(33)SRB
This command was replaced by the
showipslagroupschedulecommand.
Examples
The following is sample output from the
showrtrgroupschedule command that shows information about group (multiple) scheduling. The last line in the example indicates that the IP SLAs operations are multiple scheduled (TRUE):
Router# show rtr group schedule
Multi-Scheduling Configuration:
Group Entry Number: 1
Probes to be scheduled: 2,3,4,9-30,89
Schedule period :60
Group operation frequency: 30
Multi-scheduled: TRUE
The following is sample output from the
showrtrgroupschedule command that shows information about group (multiple) scheduling, with the
frequency value the same as the
schedule-periodvalue, the
life value as 3600 seconds, and the
ageout value as never:
Router# show rtr group schedule
Group Entry Number: 1
Probes to be scheduled: 3,4,6-10
Total number of probes: 7
Schedule period: 20
Group operation frequency: Equals schedule period
Status of entry (SNMP RowStatus): Active
Next Scheduled Start Time: Start Time already passed
Life (seconds): 3600
Entry Ageout (seconds): never
The table below describes the significant fields shown in the displays.
Table 43 show rtr group schedule Field Descriptions
Field
Description
Group Entry Number
The operation group number specified for IP SLAs multiple operations scheduling.
Probes to be scheduled
The operations numbers specified in the operation group 1.
Scheduled period
The time in seconds you mentioned while scheduling the operation.
Group operation frequency
The frequency at which each operation is started.
Multi-scheduled
The value TRUE shows that group scheduling is active.
Related Commands
Command
Description
showrtrconfiguration
Displays the scheduling details.
showrunningconfiguration
Displays the configuration details which includes the IP SLAs multiple operations scheduling information.
show rtr history
Note
Effective with Cisco IOS Release 12.3(14)T and 12.2(31)SB2, the
showrtrhistorycommand is replaced by the
showipslamonitorhistorycommand. Effective with Cisco IOS Release 12.2(33)SRB, the
showrtrhistorycommand is replaced by the
showipslahistorycommand. See the
showipslamonitorhistoryand
showipslahistorycommands for more information.
To display history collected for all Cisco IOS IP Service Level Agreements (IP SLAs) operations or for a specified operation, use the
showrtrhistorycommand in user EXEC or privileged EXEC mode.
showrtrhistory [operation-number]
[ tabular | full ]
Syntax Description
operation-number
(Optional) Displays history for only the specified operation.
tabular
(Optional) Displays information in a column format reducing the number of screens required to display the information. This is the default.
full
(Optional) Displays all information using identifiers next to each displayed value.
Command Default
Tabular format history for all operations is displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
11.2
This command was introduced.
12.3(14)T
This command was replaced by the
showipslamonitorhistorycommand.
12.2(31)SB2
This command was replaced by the
showipslamonitorhistorycommand.
12.2(33)SRB
This command was replaced by the
showipslahistorycommand.
Usage Guidelines
The table below lists the Response Return values used in the output of the
showrtrhistory command. If the default (tabular) format is used, the Response Return description is displayed as a code in the Sense column. If the full format is used, the Response Return is displayed as indicated in the Description column.
Table 44 Response Return (Sense Column) Codes
Code
Description
1
Okay.
2
Disconnected.
3
Over threshold.
4
Timeout.
5
Busy.
6
Not connected.
7
Dropped.
8
Sequence error.
9
Verify error.
10
Application specific.
Examples
The following is sample output from the
showrtrhistorycommand in tabular format:
Router# show rtr history
Point by point History
Multiple Lines per Entry
Line 1
Entry = Entry Number
LifeI = Life Index
BucketI = Bucket Index
SampleI = Sample Index
SampleT = Sample Start Time
CompT = Completion Time (milliseconds)
Sense = Response Return Code
Line 2 has the Target Address
Entry LifeI BucketI SampleI SampleT CompT Sense
2 1 1 1 17436548 16 1
AB 45 A0 16
2 1 2 1 17436551 4 1
AC 12 7 29
2 1 2 2 17436551 1 1
AC 12 5 22
2 1 2 3 17436552 4 1
AB 45 A7 22
2 1 2 4 17436552 4 1
AB 45 A0 16
Related Commands
Command
Description
showrtrconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
show rtr mpls-lsp-monitor configuration
Note
Effective with Cisco IOS Release 12.2(31)SB2, the
showrtrmpls-lsp-monitorconfigurationcommand is replaced by the
showipslamonitormpls-lsp-monitorconfigurationcommand. Effective with Cisco IOS Release 12.2(33)SRB, the
showrtrmpls-lsp-monitorconfigurationcommand is replaced by the
showipslampls-lsp-monitorconfigurationcommand. See the
showipslamonitormpls-lsp-monitorconfigurationand
showipslampls-lsp-monitorconfigurationcommands for more information.
To display configuration settings for IP Service Level Agreements (SLAs) label switched path (LSP) Health Monitor operations, use the
showrtrmpls-lsp-monitorconfiguration command in user EXEC or privileged EXEC mode.
(Optional) Number of the LSP Health Monitor operation for which the details will be displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(27)SBC
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2
This command was replaced by the
showipslamonitormpls-lsp-monitorconfigurationcommand.
12.2(33)SRB
This command was replaced by the
showipslampls-lsp-monitorconfigurationcommand.
Usage Guidelines
If the identification number of an LSP Health Monitor operation is not specified, configuration values for all the configured LSP Health Monitor operations will be displayed.
Examples
The following is sample output from the
showrtrmpls-lsp-monitorconfiguration command:
Router# show rtr mpls-lsp-monitor configuration 1
Entry Number : 1
Modification time : *12:18:21.830 PDT Fri Aug 19 2005
Operation Type : echo
Vrf Name : saa-vrf-all
Tag :
EXP Value : 0
Timeout(ms) : 1000
Threshold(ms) : 5000
Frequency(sec) : Equals schedule period
LSP Selector : 127.0.0.1
ScanInterval(min) : 1
Delete Scan Factor : 1
Operations List : 100001-100003
Schedule Period(sec): 60
Request size : 100
Start Time : Start Time already passed
SNMP RowStatus : Active
TTL value : 255
Reply Mode : ipv4
Reply Dscp Bits :
Secondary Frequency : Enabled on Timeout
Value(sec) : 10
Reaction Configs :
Reaction : connectionLoss
Threshold Type : Consecutive
Threshold Count : 3
Action Type : Trap Only
Reaction : timeout
Threshold Type : Consecutive
Threshold Count : 3
Action Type : Trap Only
The table below describes the significant fields shown in the display.
Table 45 show rtr mpls-lsp-monitor configuration Field Descriptions
Field
Description
Entry Number
Identification number for the LSP Health Monitor operation.
Operation Type
Type of IP SLAs operation configured by the LSP Health Monitor operation.
Vrf Name
If a specific name is displayed in this field, then the LSP Health Monitor is configured to discover only those BGP next hop neighbors in use by the VRF specified.
If saa-vrf-all is displayed in this field, then the LSP Health Monitor is configured to discover all BGP next hop neighbors in use by all VRFs associated with the source Provider Edge (PE) router.
Tag
User-specified identifier for the LSP Health Monitor operation.
EXP Value
Experimental field value in the header for an echo request packet of the IP SLAs operation.
Timeout(ms)
Amount of time the IP SLAs operation waits for a response from its request packet.
Threshold(ms)
Threshold value of the IP SLAs operation for which a reaction event is generated if violated.
Frequency(sec)
Time after which the IP SLAs operation is restarted.
LSP Selector
Local host IP address used to select the LSP for the IP SLAs operation.
ScanInterval(min)
Time interval at which the LSP Health Monitor checks the scan queue for BGP next hop neighbor updates.
Delete Scan Factor
Specifies the number of times the LSP Health Monitor should check the scan queue before automatically deleting IP SLAs operations for BGP next hop neighbors that are no longer valid.
Operations List
Identification numbers IP SLAs operations created by the LSP Health Monitor operation.
Schedule Period(sec)
Amount of time for which the LSP Health Monitor operation is scheduled.
Request size
Protocol data size for the request packet of the IP SLAs operation.
Start Time
Status of the start time for the LSP Health Monitor operation.
SNMP RowStatus
Indicates whether SNMP RowStatus is active or inactive.
TTL value
The maximum hop count for an echo request packet of the IP SLAs operation.
Reply Mode
Reply mode for an echo request packet of the IP SLAs operation.
Reply Dscp Bits
Differentiated services codepoint (DSCP) value of an echo reply packet of the IP SLAs operation.
Secondary Frequency
Reaction condition that will enable the secondary frequency option.
Value(sec)
Secondary frequency value.
Reaction Configs
Reaction configuration of the IP SLAs operation.
Reaction
Reaction condition being monitored.
Threshold Type
Specifies when an action should be performed as a result of a reaction event.
Threshold Count
The number of times a reaction event can occur before an action should be performed.
Action Type
Type of action that should be performed as a result of a reaction event.
Related Commands
Command
Description
rtrmpls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters SAA MPLS configuration mode.
rtrmpls-lsp-monitorschedule
Configures the scheduling parameters for an IP SLAs LSP Health Monitor operation.
show rtr mpls-lsp-monitor neighbors
Note
Effective with Cisco IOS Release 12.2(31)SB2, the
showrtrmpls-lsp-monitorneighborscommand is replaced by the
showipslamonitormpls-lsp-monitorneighborscommand. Effective with Cisco IOS Release 12.2(33)SRB, the
showrtrmpls-lsp-monitorneighborscommand is replaced by the
showipslampls-lsp-monitorneighborscommand. See the
showipslamonitormpls-lsp-monitorneighborsand
showipslampls-lsp-monitorneighborscommands for more information.
To display routing and connectivity information about Multiprotocol Label Switching (MPLS) Virtual Private Network (VPN) Border Gateway Protocol (BGP) next hop neighbors discovered by the IP Service Level Agreements (SLAs) label switched path (LSP) Health Monitor, use the
showrtrmpls-lsp-monitorneighbors command in user EXEC or privileged EXEC mode.
showrtrmpls-lsp-monitorneighbors
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(27)SBC
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2
This command was replaced by the
showipslamonitormpls-lsp-monitorneighborscommand.
12.2(33)SRB
This command was replaced by the
showipslampls-lsp-monitorneighborscommand.
Examples
The following is sample output from the
showrtrmpls-lsp-monitorneighborscommand:
Router# show rtr mpls-lsp-monitor neighbors
SAA MPLS LSP Monitor Database : 1
BGP Next hop 10.10.10.5 (Prefix: 10.10.10.5/32) OK
ProbeID: 100001 (red, blue, green)
BGP Next hop 10.10.10.7 (Prefix: 10.10.10.7/32) OK
ProbeID: 100002 (red, blue, green)
BGP Next hop 10.10.10.8 (Prefix: 10.10.10.8/32) OK
ProbeID: 100003 (red, blue, green)
The table below describes the significant fields shown in the display.
Table 46 show rtr mpls-lsp-monitor neighbors Field Descriptions
Field
Description
BGP Next hop
Identifier for the BGP next hop neighbor.
Prefix
IPv4 Forward Equivalence Class (FEC) of the BGP next hop neighbor to be used by the MPLS LSP ping operation.
ProbeID
The identification number of the IP SLAs operation. The names of the VRFs that contain routing entries for the specified BGP next hop neighbor are listed in parentheses.
OK
LSP ping or LSP traceroute connectivity status between the source PE router and specified BGP next hop neighbor. Connectivity status can be the following:
OK--Successful reply.
ConnectionLoss--Reply is from a device that is not egress for the Forward Equivalence Class (FEC).
Timeout--Echo request timeout.
Unknown--State of LSP is not known.
Related Commands
Command
Description
rtrmpls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters SAA MPLS configuration mode.
show rtr mpls-lsp-monitor scan-queue
Note
Effective with Cisco IOS Release 12.2(31)SB2, the
showrtrmpls-lsp-monitorscan-queuecommand is replaced by the
showipslamonitormpls-lsp-monitorscan-queuecommand. Effective with Cisco IOS Release 12.2(33)SRB, the
showrtrmpls-lsp-monitorscan-queuecommand is replaced by the
showipslampls-lsp-monitorscan-queuecommand. See the
showipslamonitormpls-lsp-monitorscan-queueand
showipslampls-lsp-monitorscan-queuecommands for more information.
To display information about adding or deleting Border Gateway Protocol (BGP) next hop neighbors from a particular Multiprotocol Label Switching (MPLS) Virtual Private Network (VPN) of an IP Service Level Agreements (SLAs) LSP Health Monitor operation, use the
showrtrmpls-lsp-monitorscan-queue command in user EXEC or privileged EXEC mode.
showrtrmpls-lsp-monitorscan-queueoperation-number
Syntax Description
operation-number
Number of the LSP Health Monitor operation for which the details will be displayed.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.2(27)SBC
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2
This command was replaced by the
showipslamonitormpls-lsp-monitorscan-queuecommand.
12.2(33)SRB
This command was replaced by the
showipslampls-lsp-monitorscan-queuecommand.
Examples
The following is sample output from the
showrtrmpls-lsp-monitorscan-queue command:
Router# show rtr mpls-lsp-monitor scan-queue 1
Next scan Time after: 23 Secs
Next Delete scan Time after: 83 Secs
BGP Next hop Prefix vrf Add/Delete?
10.10.10.8 10.10.10.8/32 red Add
10.10.10.8 10.10.10.8/32 blue Add
10.10.10.8 10.10.10.8/32 green Add
The table below describes the significant fields shown in the display.
Table 47 show rtr mpls-lsp-monitor scan-queue Field Descriptions
Field
Description
Next scan Time after
Amount of time left before the LSP Health Monitor checks the scan queue for information about adding BGP next hop neighbors to a particular VPN. At the start of each scan time, IP SLAs operations are created for all newly discovered neighbors.
Next Delete scan Time after
Amount of time left before the LSP Health Monitor checks the scan queue for information about deleting BGP next hop neighbors from a particular VPN. At the start of each delete scan time, IP SLAs operations are deleted for neighbors that are no longer valid.
BGP Next hop
Identifier for the BGP next hop neighbor.
Prefix
IPv4 Forward Equivalence Class (FEC) of the BGP next hop neighbor to be used by the MPLS LSP ping operation.
vrf
Name of the VRF that contains a routing entry for the specified BGP next hop neighbor.
Add/Delete
Indicates that the specified BGP next hop neighbor will be added to or removed from the specified VPN.
Related Commands
Command
Description
delete-scan-factor
Specifies the number of times the LSP Health Monitor should check the scan queue before automatically deleting IP SLAs operations for BGP next hop neighbors that are no longer valid.
mplsdiscoveryvpninterval
Specifies the time interval at which routing entries that are no longer valid are removed from the BGP next hop neighbor discovery database of an MPLS VPN.
rtrmpls-lsp-monitor
Begins configuration for an IP SLAs LSP Health Monitor operation and enters SAA MPLS configuration mode.
scan-interval
Specifies the time interval (in minutes) at which the LSP Health Monitor checks the scan queue for BGP next hop neighbor updates.
show rtr operational-state
Note
Effective with Cisco IOS Release 12.3(14)T and 12.2(31)SB2, the
showrtroperational-statecommand is replaced by the
showipslamonitorstatisticscommand. Effective with Cisco IOS Release 12.2(33)SRB, the
showrtroperational-statecommand is replaced by the
showipslastatisticscommand. See the
showipslamonitorstatisticsand
showipslastatisticscommands for more information.
To display the operational state of all Cisco IOS IP Service Level Agreements (IP SLAs) operations or a specified operation, use the
showrtroperational-state command in user EXEC or privileged EXEC mode.
showrtroperational-state [operation-number]
Syntax Description
operation-number
(Optional) ID number of the IP SLAs operation to display.
Command Default
Displays output for all running IP SLAs operations.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
11.2
This command was introduced.
12.0(5)T
Output for the Jitter operation type was added.
12.1
The
tabular and
full keywords were removed.
12.2(8)T
Output for “NumOfJitterSamples” was added (CSCdv30022).
12.2(8)S
Output for “NumOfJitterSamples” was added (CSCdv30022).
12.3(4)T
Output (MOS and ICPIF scores) for the Jitter (codec) operation type was added.
12.3(7)T
Decimal granularity for MOS scores was added.
12.3(14)T
This command was replaced by the
showipslamonitorstatisticscommand.
12.2(31)SB2
This command was replaced by the
showipslamonitorstatisticscommand.
12.2(33)SRB
This command was replaced by the
showipslastatisticscommand.
Usage Guidelines
Use the
showrtroperational-state command to display the current state of IP SLAs operations, including how much life the operation has left, whether the operation is active, and the completion time. The output will also include the monitoring data returned for the last (most recently completed) operation.
Examples
The following example shows basic sample output from the
showrtroperational-state command:
Router# showrtroperational-state Current Operational State
Entry Number: 3
Modification Time: *22:15:43.000 UTC Sun Feb 11 2001
Diagnostics Text:
Last Time this Entry was Reset: Never
Number of Octets in use by this Entry: 1332
Number of Operations Attempted: 2
Current Seconds Left in Life: 3511
Operational State of Entry: active
Latest Completion Time (milliseconds): 544
Latest Operation Start Time: *22:16:43.000 UTC Sun Feb 11 2001
Latest Oper Sense: ok
Latest Sense Description: 200 OK
Total RTT: 544
DNS RTT: 12
TCP Connection RTT: 28
HTTP Transaction RTT: 504
HTTP Message Size: 9707
The following example shows sample output from the
showrtroperational-state command when the specified operation is a Jitter (codec) operation:
Router# show rtr operational-state 1
Entry number: 1
Modification time: 13:18:38.012 PST Mon Jun 24 2002
Number of Octets Used by this Entry: 10392
Number of operations attempted: 2
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): 2
Latest operation start time: *13:18:42.896 PST Mon Jun 24 2002
Latest operation return code: OK
Voice Scores:
ICPIF Value: 0 MOS score: 0
RTT Values:
NumOfRTT: 61 RTTAvg: 2 RTTMin: 2 RTTMax: 3
RTTSum: 123 RTTSum2: 249
Packet Loss Values:
PacketLossSD: 0 PacketLossDS: 0
PacketOutOfSequence: 0 PacketMIA: 0 PacketLateArrival: 0
InternalError: 0 Busies: 0 PacketSkipped: 39 <<<<<<==========
Jitter Values:
MinOfPositivesSD: 1 MaxOfPositivesSD: 1
NumOfPositivesSD: 1 SumOfPositivesSD: 1 Sum2PositivesSD: 1
MinOfNegativesSD: 1 MaxOfNegativesSD: 1
NumOfNegativesSD: 1 SumOfNegativesSD: 1 Sum2NegativesSD: 1
MinOfPositivesDS: 0 MaxOfPositivesDS: 0
NumOfPositivesDS: 0 SumOfPositivesDS: 0 Sum2PositivesDS: 0
MinOfNegativesDS: 0 MaxOfNegativesDS: 0
NumOfNegativesDS: 0 SumOfNegativesDS: 0 Sum2NegativesDS: 0
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
The values shown indicate the values for the last IP SLAs operation. RTT stands for Round-Trip-Time. SD stands for Source-to-Destination. DS stands for Destination-to-Source. OW stands for One Way. The * symbol in front of the time stamps indicates the time is synchronized using NTP or SNTP. The table below describes the significant fields shown in this output.
Table 48 show rtr operational-state Field Descriptions
Field
Description
Voice Scores:
Indicates that Voice over IP statistics appear on the following lines. Voice score data is computed when the operation type is configured as
typejitter(codec).
ICPIF:
The Calculated Planning Impairment Factor (ICPIF) value for the latest iteration of the operation. The ICPIF value is computed by IP SLAs using the formula
Icpif=Io+Iq+Idte+Idd+Ie-A, where
the values for
Io ,
Iq , and
Idte are set to zero,
the value
Idd is computed based on the measured one way delay,
the value
Ie is computed based on the measured packet loss,
and the value of A is specified by the user.
ICPIF values are expressed in a typical range of 5 (very low impairment) to 55 (very high impairment). ICPIF values numerically less than 20 are generally considered “adequate.”
Note
This value is intended only for relative comparisons, and may not match ICPIF values generated using alternate methods.
MOS:
The estimated Mean Opinion Score (Conversational Quality, Estimated) for the latest iteration of the operation. The MOS-CQE is computed by IP SLAs as a function of the ICPIF.
MOS values are expressed as a number from 1 (1.00) to 5 (5.00), with 5 being the highest level of quality, and 1 being the lowest level of quality. A MOS value of 0 (zero) indicates that MOS data could not be generated for the operation.
RTT Values:
Indicates that Round-Trip-Time statistics appear on the following lines.
NumOfRTT
The number of successful round trips.
RTTSum
The sum of those round trip values (in milliseconds).
RTTSum2
The sum of squares of those round trip values (in milliseconds).
Packet Loss Values:
Indicates that Packet Loss statistics appear on the following lines.
PacketLossSD
The number of packets lost from source to destination.
PacketLossDS
The number of packets lost from destination to source.
PacketOutOfSequence
The number of packets returned out of order.
PacketMIA
The number of packets lost where the direction (SD or DS) cannot be determined (MIA: “missing in action”).
PacketLateArrival
The number of packets that arrived after the timeout.
PacketSkipped
The number of packets that are not sent during the IP SLAs jitter operation.
InternalError
The number of times an operation could not be started due to other internal failures.
Busies
The number of times this operation could not be started because the previously scheduled run was not finished.
Jitter Values:
Indicates that jitter operation statistics appear on the following lines.
Jitter is inter-packet delay variance.
NumOfJitterSamples:
The number of jitter samples collected. This is the number of samples that are used to calculate the following jitter statistics.
MinOfPositivesSD MaxOfPositivesSD
The minimum and maximum positive jitter values from source to destination, in milliseconds.
NumOfPositivesSD
The number of jitter values from source to destination that are positive (i.e., network latency increases for two consecutive test packets).
SumOfPositivesSD
The sum of those positive values (in milliseconds).
Sum2PositivesSD
The sum of squares of those positive values.
MinOfNegativesSD MaxOfNegativesSD
The minimum and maximum negative jitter values from source to destination. The absolute value is given.
NumOfNegativesSD
The number of jitter values from source to destination that are negative (that is, network latency decreases for two consecutive test packets).
SumOfNegativesSD
The sum of those values.
Sum2NegativesSD
The sum of the squares of those values.
Interarrival jitterout:
The source to destination (SD) jitter value calculation, as defined in RFC 1889.
Interarrival jitterin:
The destination to source (DS) jitter value calculation, as defined in RFC 1889.
One Way Values
Indicates that One Way measurement statistics appear on the following lines.
One Way (OW) Values are the amount of time it took the packet to travel from the source router to the target router (SD) or from the target router to the source router (DS).
NumOfOW
Number of successful one way time measurements.
OWMinSD
Minimum time from the source to the destination.
OWMaxSD
Maximum time from the source to the destination.
OWSumSD
Sum of the OWMinSD and OWMaxSD values.
OWSum2SD
Sum of the squares of the OWMinSD and OWMaxSD values.
Related Commands
Command
Description
showrtrconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
show rtr reaction-configuration
Note
Effective with Cisco IOS Release 12.3(14)T and 12.2(31)SB2, the
showrtrreaction-configurationcommand is replaced by the
showipslamonitorreaction-configurationcommand. Effective with Cisco IOS Release 12.2(33)SRB, the
showrtrreaction-configurationcommand is replaced by the
showipslareaction-configurationcommand. See the
showipslamonitorreaction-configurationand
showipslareaction-configurationcommands for more information.
To display the configured proactive threshold monitoring settings for all Cisco IOS IP Service Level Agreements (SLAs) operations or a specified operation, use the
showrtrreaction-configuration command in user EXEC or privileged EXEC mode.
showrtrreaction-configuration [operation-number]
Syntax Description
operation-number
(Optional) Displays the reaction configuration for only the specified IP SLAs operation.
Command Default
Displays configured proactive threshold monitoring settings for all IP SLAs operations.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.3(7)T
This command was introduced.
12.3(14)T
This command was replaced by the
showipslamonitorreaction-configurationcommand.
12.2(25)S
This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2
This command was replaced by the
showipslamonitorreaction-configurationcommand.
12.2(33)SRB
This command was replaced by the
showipslareaction-configurationcommand.
Usage Guidelines
Use the
rtrreaction-configuration command in global configuration mode to configure the proactive threshold monitoring parameters for an IP SLAs operations.
Examples
In the following example, multiple monitored elements (indicated by the Reaction values) are configured for a single IP SLAs operation:
The table below describes the significant fields shown in this output.
Table 49 show rtr reaction-configuration Field Descriptions
Field
Description
Reaction:
The monitored element configured for the specified IP SLAs operation.
Corresponds to the
react{connectionLoss |
jitterAvg |
jitterDSAvg |
jitterSDAvg |
mos |
PacketLossDS |
PacketLossSD |
rtt |
timeout |
verifyError} syntax in the
rtrreaction-configuration command.
Threshold type:
The configured threshold type.
Corresponds to the
threshold-type {never |
immediate |
consecutive |
xofy |
average} syntax in the
rtrreaction-configuration command.
Rising (milliseconds):
The
upper-threshold value, as configured by the
threshold-valueupper-thresholdlower-threshold syntax in the
rtrreaction-configuration command.
Threshold Falling (milliseconds):
The
lower-threshold value, as configured by the
threshold-valueupper-thresholdlower-threshold syntax in the
rtrreaction-configuration command.
Threshold Count:
The
x-value in the
xofy threshold type, or the
number-of-measurements value for
average threshold type.
Threshold Count2:
The
y-value in the
xofy threshold-type.
Action Type:
The reaction to be performed when the violation conditions are met, as configured by the
action-type {none |
trapOnly |
triggerOnly |
trapAndTrigger} syntax in the
rtrreaction-configuration command.
Related Commands
Command
Description
rtrreaction-configuration
Configures proactive threshold monitoring parameters for an IP SLAs operation.
show rtr reaction-trigger
Note
Effective with Cisco IOS Release 12.3(14)T and 12.2(31)SB2, the showrtrreaction-triggercommand is replaced by the showipslamonitorreaction-triggercommand. Effective with Cisco IOS Release 12.2(33)SRB, the showrtrreaction-triggercommand is replaced by the showipslareaction-triggercommand. See the showipslamonitorreaction-triggerand showipslareaction-triggercommands for more information.
To display the reaction trigger information for all Cisco IOS IP Service Level Agreements (IP SLAs) operations or the specified operation, use the showrtrreaction-trigger command in user EXEC or privileged EXEC mode.
showrtrreaction-trigger [operation-number]
Syntax Description
operation-number
(Optional) Number of the IP SLAs operation to display.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
11.2
This command was introduced.
12.3(14)T
This command was replaced by the showipslamonitorreaction-triggercommand.
12.2(31)SB2
This command was replaced by the showipslamonitorreaction-triggercommand.
12.2(33)SRB
This command was replaced by the showipslareaction-triggercommand.
Usage Guidelines
Use the showrtrreaction-trigger command to display the configuration status and operational state of target operations that will be triggered as defined with the rtrreaction-configuration global command.
Examples
The following is sample output from the showrtrreaction-trigger command:
Router# show rtr reaction-trigger 1
Reaction Table
Entry Number: 1
Target Entry Number: 2
Status of Entry (SNMP RowStatus): active
Operational State: pending
Related Commands
Command
Description
showrtrconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
show rtr responder
Note
Effective with Cisco IOS Release 12.3(14)T and 12.2(31)SB2, the showrtrrespondercommand is replaced by the showipslamonitorrespondercommand. Effective with Cisco IOS Release 12.2(33)SRB, the showrtrrespondercommand is replaced by the showipslarespondercommand. See the showipslamonitorresponderand showipslarespondercommands for more information.
To display Cisco IOS IP Service Level Agreements (IP SLAs) Responder information, use the showrtrresponder command in user EXEC or privileged EXEC mode.
showrtrresponder
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.0(3)T
This command was introduced.
12.3(14)T
This command was replaced by the showipslamonitorrespondercommand.
12.2(31)SB2
This command was replaced by the showipslamonitorrespondercommand.
12.2(33)SRB
This command was replaced by the showipslarespondercommand.
Usage Guidelines
Use the showrtrrespondercommand to display information about recent sources of IP SLAs control messages, such as who has sent recent control messages and who has sent invalid control messages.
Examples
The following is sample output from the showrtrresponder command:
Router# show rtr responder
RTR Responder is: Enabled
Number of control message received: 19 Number of errors: 1
Recent sources:
4.0.0.1 [19:11:49.035 UTC Sat Dec 2 1995]
4.0.0.1 [19:10:49.023 UTC Sat Dec 2 1995]
4.0.0.1 [19:09:48.707 UTC Sat Dec 2 1995]
4.0.0.1 [19:08:48.687 UTC Sat Dec 2 1995]
4.0.0.1 [19:07:48.671 UTC Sat Dec 2 1995]
Recent error sources:
4.0.0.1 [19:10:49.023 UTC Sat Dec 2 1995] RTT_AUTH_FAIL
Related Commands
Command
Description
showrtrconfiguration
Displays configuration values for IP SLAs operations.
show rtr totals-statistics
Note
Effective with Cisco IOS Release 12.3(14)T , the showrtrtotals-statisticscommand is replaced by the showipslamonitortotals-statisticscommand. Effective with Cisco IOS Release 12.2(31)SB2, the showrtrtotals-statisticscommand is replaced by the showipslamonitorstatisticsaggregatedcommand. Effective with Cisco IOS Release 12.2(33)SRB, the showrtrtotals-statisticscommand is replaced by the showipslastatisticsaggregatedcommand. See the showipslamonitortotals-statistics, showipslamonitorstatisticsaggregated, and showipslastatisticsaggregatedcommands for more information.
To display the total statistical values (accumulation of error counts and completions) for all Cisco IOS IP Service Level Agreements (IP SLAs) operations or the specified operation, use the showrtrtotals-statistics command in user EXEC or privileged EXEC mode.
showrtrtotals-statistics [number]
[ tabular | full ]
Syntax Description
number
(Optional) Number of the IP SLAs operation to display.
tabular
(Optional) Display information in a column format reducing the number of screens required to display the information.
full
(Optional) Display all information using identifiers next to each displayed value. This is the default.
Command Default
Full format for all operations
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
11.2
This command was introduced.
12.3(14)T
This command was replaced by the showipslamonitortotal-statisticscommand.
12.2(31)SB2
This command was replaced by the showipslamonitorstatisticsaggregatedcommand.
12.2(33)SRB
This command was replaced by the showipslastatisticsaggregatedcommand.
Usage Guidelines
The total statistics consist of the following items:
The operation number
The start time of the current hour of statistics
The age of the current hour of statistics
The number of attempted operations
You can also use the showrtrdistributions-statistics and showrtrcollection-statistics commands to display additional statistical information.
Examples
The following is sample output from the showrtrtotals-statistics command in full format:
Router# show rtr totals-statistics
Statistic Totals
Entry Number: 1
Start Time Index: *17:15:41.000 UTC Thu May 16 1996
Age of Statistics Entry (hundredths of seconds): 48252
Number of Initiations: 10
Related Commands
Command
Description
showrtrcollection-statistics
Displays statistical errors for all IP SLAs operations or the specified operation.
showrtrconfiguration
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
showrtrdistributions-statistics
Displays statistic distribution information (captured response times) for all IP SLAs operations or the specified operation.