Cisco IOS IP SLAs Command Reference
show ip sla application through show rtr totals-statistics

Table Of Contents

show ip sla application

show ip sla authentication

show ip sla configuration

show ip sla enhanced-history collection-statistics

show ip sla enhanced-history distribution-statistics

show ip sla ethernet-monitor configuration

show ip sla event-publisher

show ip sla group schedule

show ip sla history

show ip sla monitor application

show ip sla monitor authentication

show ip sla monitor collection-statistics

show ip sla monitor configuration

show ip sla monitor distributions-statistics

show ip sla monitor enhanced-history collection-statistics

show ip sla monitor enhanced-history distribution-statistics

show ip sla monitor group schedule

show ip sla monitor history

show ip sla monitor mpls-lsp-monitor collection-statistics

show ip sla monitor mpls-lsp-monitor configuration

show ip sla monitor mpls-lsp-monitor lpd operational-state

show ip sla monitor mpls-lsp-monitor neighbors

show ip sla monitor mpls-lsp-monitor scan-queue

show ip sla monitor mpls-lsp-monitor summary

show ip sla monitor reaction-configuration

show ip sla monitor reaction-trigger

show ip sla monitor responder

show ip sla monitor statistics

show ip sla monitor statistics aggregated

show ip sla monitor totals-statistics

show ip sla mpls-lsp-monitor collection-statistics

show ip sla mpls-lsp-monitor configuration

show ip sla mpls-lsp-monitor lpd operational-state

show ip sla mpls-lsp-monitor neighbors

show ip sla mpls-lsp-monitor scan-queue

show ip sla mpls-lsp-monitor summary

show ip sla reaction-configuration

show ip sla reaction-trigger

show ip sla responder

show ip sla statistics

show ip sla statistics aggregated

show mpls discovery vpn

show rtr application

show rtr authentication

show rtr collection-statistics

show rtr configuration

show rtr distributions-statistics

show rtr enhanced-history collection-statistics

show rtr enhanced-history distribution-statistics

show rtr group schedule

show rtr history

show rtr mpls-lsp-monitor configuration

show rtr mpls-lsp-monitor neighbors

show rtr mpls-lsp-monitor scan-queue

show rtr operational-state

show rtr reaction-configuration

show rtr reaction-trigger

show rtr responder

show rtr totals-statistics


show ip sla application

To display global information about Cisco IOS IP Service Level Agreements (SLAs), use the show ip sla application command in user EXEC or privileged EXEC mode.

show ip sla application

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.4(4)T

This command was introduced. This command replaces the show ip sla monitor application 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 show rtr application command.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the show ip sla monitor application command.

12.2(33)SXI

This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the show ip sla monitor application command.

12.4(22)T

This command was modified. The output has been modified to include information on supported features.


Usage Guidelines

Use the show ip sla application command to display information such as supported operation types and supported protocols.

Examples

The following is sample output from the show ip sla application command:

Router# show ip sla application 

IP Service Level Agreement Technologies

IPSLAs Infrastructure version: Engine-II

Supported Operation Types:
        802.1agEcho, 802.1agJitter, dhcp, dns, echo, frameRelay, ftp
        http, icmpJitter, jitter, lspGroup, lspPing, lspTrace
        pathEcho, pathJitter, rtp, tcpConnect, udpEcho, voip
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


Router#

Table 21 describes the significant fields shown in the display.

Table 21 show ip sla application Field Descriptions 

Field
Description

IPSLAs Infrastructure version

The version of the IPSLAs 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

show ip sla configuration

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 show ip sla authentication command in user EXEC or privileged EXEC mode.

show ip sla authentication

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 show ip sla monitor authentication 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 show rtr authentication command.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the show ip sla monitor authentication command.

12.2(33)SXI

This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the show ip sla monitor authentication command.


Usage Guidelines

Use the show ip sla authentication command to display information such as supported operation types and supported protocols.

Examples

The following is sample output from the show ip sla authentication command:

Router# show ip sla authentication 

IP SLA Monitor control message uses MD5 authentication, key chain name is: ipsla

Related Commands

Command
Description

show ip sla configuration

Displays configuration values for IP SLAs operations.


show ip sla configuration

To display configuration values including all defaults for all Cisco IOS IP Service Level Agreements (SLAs) operations or a specified operation, use the show ip sla configuration command in user EXEC or privileged EXEC mode.

show ip sla configuration [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.4(4)T

This command was introduced. This command replaces the show ip sla monitor 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 show rtr configuration command.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the show ip sla monitor configuration command.

12.2(33)SXI

This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the show ip sla monitor configuration command.


Examples

The following sections show sample output from the show ip sla configuration command for different IP SLAs operations in IPv4 and IPv6 networks.

Output for ICMP Echo Operations

IP SLAs Internet Control Message Protocol (ICMP) echo operations support both IPv4 and IPv6 addresses.

The following example shows output from the show ip sla configuration command when the specified operation is an ICMP echo operation in an IPv4 network:

Router# show ip sla 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:

The following example shows output from the show ip sla configuration command when the specified operation is an ICMP echo operation in an IPv6 network:

Router# 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:0DB8: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

Output for HTTP Operations

The following example shows output from the show ip sla configuration command when the specified operation is a Hypertext Transfer Protocol (HTTP) operation:

Router# show ip sla 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

Output for ICMP Path Jitter Operations

The following example shows output from the show ip sla configuration command when the specified operation is an ICMP path jitter operation:

Router# show ip sla 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

Output for ICMP Path Echo Operations

The following example shows output from the show ip sla configuration command when the specified operation is an ICMP path echo operation:

Router# show ip sla 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

Output for DNS Operations

The following example shows output from the show ip sla configuration command when the specified operation is a Domain Name System (DNS) operation:

Router# show ip sla 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

Output for UDP Echo Operations

IP SLAs User Datagram Protocol (UDP) echo operations support both IPv4 and IPv6 addresses.

The following example shows output from the show ip sla configuration command when the specified operation is a UDP echo operation in an IPv4 network:

Router# show ip sla 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:

The following example shows output from the show ip sla configuration command when the specified operation is a UDP echo operation in an IPv6 network:

Router# 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

Output for TCP Connect Operations

IP SLAs Transmission Control Protocol (TCP) connect operations support both IPv4 and IPv6 addresses.

The following example shows output from the show ip sla configuration command when the specified operation is a TCP connect operation in an IPv4 network:

Router# show ip sla 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:

The following example shows output from the show ip sla configuration command when the specified operation is a TCP connect operation in an IPv6 network:

Router# 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:

Output for DHCP Operations

The following example shows output from the show ip sla configuration command when the specified operation is a Dynamic Host Configuration Protocol (DHCP) operation:

Router# show ip sla 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

Output for FTP Operations

The following example shows output from the show ip sla configuration command when the specified operation is a File Transfer Protocol (FTP) operation:

Router# 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@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

Output for UDP Jitter Operations

IP SLAs User Datagram Protocol (UDP) jitter connect operations support both IPv4 and IPv6 addresses.

The following example shows output from the show ip sla configuration command when the specified operation is a UDP jitter operation in an IPv4 network:

Router# show ip sla 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:

The following example shows output from the show ip sla configuration command when the specified operation is a UDP jitter operation in an IPv6 network:

Router# 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
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

Related Commands

Command
Description

ip sla

Begins configuration for an IP SLAs operation and enters IP SLA configuration mode.


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 show ip sla enhanced-history collection-statistics command in user EXEC or privileged EXEC mode.

show ip sla enhanced-history collection-statistics [operation-number] [interval seconds]

Syntax Description

operation-number

(Optional) Number of the operation for which enhanced history statistics is displayed.

interval seconds

(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 show ip sla monitor enhanced-history collection-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 show rtr enhanced-history collection-statistics command.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the show ip sla monitor enhanced-history collection-statistics command.

12.2(33)SXI

This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the show ip sla monitor enhanced-history collection-statistics command.


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 the history enhanced command.

You can also use the following commands to display additional statistics or history information, or to view the status of the operation:

show ip sla enhanced-history distribution-statistics

show ip sla statistics

show ip sla statistics aggregated


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 terminal width EXEC mode command).


Examples

The following example shows sample output for the show ip sla enhanced-history collection-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
 .
 .
 .

Table 22 describes the significant fields shown in the display.

Table 22 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 history enhanced IP SLA configuration command.


Related Commands

Command
Description

ip sla

Allows configuration of IP SLA operations by entering IP SLA configuration mode for the specified operation number.

show ip sla enhanced-history distribution-statistics

Displays enhanced history distribution statistics for IP SLAs operations in tabular format.

show ip sla statistics

Displays the current operational status and statistics of all IP SLAs operations or a specified operation.

show ip sla statistics aggregated

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 show ip sla enhanced-history distribution-statistics command in user EXEC or privileged EXEC mode.

show ip sla enhanced-history distribution-statistics [operation-number [interval seconds]]

Syntax Description

operation-number

(Optional) Number of the operation for which enhanced history statistics is displayed.

interval seconds

(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 show ip sla monitor enhanced-history distribution-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 show rtr enhanced-history distribution-statistics command.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the show ip sla monitor enhanced-history distribution-statistics command.

12.2(33)SXI

This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the show ip sla monitor enhanced-history distribution-statistics command.


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:

show ip sla enhanced-history collection-statistics

show ip sla statistics

show ip sla statistics aggregated


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 terminal width EXEC mode command).


Examples

The following is sample output from the show ip sla enhanced-history distribution-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.


Table 23 describes the significant fields shown in the display.

Table 23 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 history buckets-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-kept number 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-kept number 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

ip sla

Allows configuration of IP SLA operations by entering IP SLA configuration mode for the specified operation number.

show ip sla enhanced-history collection-statistics

Displays enhanced history statistics for all collected history buckets for the specified IP SLAs operation.

show ip sla statistics

Displays the current operational status and statistics of all IP SLAs operations or a specified operation.

show ip sla statistics aggregated

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 show ip sla ethernet-monitor configuration command in user EXEC or privileged EXEC mode.

show ip sla ethernet-monitor configuration [operation-number]

Syntax Description

operation-number

(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 show ip sla ethernet-monitor configuration 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


Table 24 describes the significant fields shown in the display.

Table 24 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-threshold argument of the threshold-value upper-threshold lower-threshold syntax in the ip sla ethernet-monitor reaction-configuration command.

 Threshold Falling

The lower threshold value of the reaction condition being monitored.

Corresponds to the lower-threshold argument of the threshold-value upper-threshold lower-threshold syntax in the ip sla ethernet-monitor reaction-configuration command.

 Threshold CountX

Corresponds to the x-value argument of the threshold-type xofy x-value y-value syntax in the ip sla ethernet-monitor reaction-configuration command.

 Threshold CountY

Corresponds to the y-value argument of the threshold-type xofy x-value y-value syntax in the ip sla ethernet-monitor reaction-configuration command.

 Action Type

Type of action that should be performed as a result of a reaction event.


Related Commands

Command
Description

ip sla ethernet-monitor

Begins configuration for an IP SLAs auto Ethernet operation and enters Ethernet monitor configuration mode.

ip sla ethernet-monitor reaction-configuration

Configures the proactive threshold monitoring parameters for an IP SLAs auto Ethernet operation.

ip sla ethernet-monitor schedule

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 show ip sla event-publisher command in user EXEC or privileged EXEC mode.

show ip sla event-publisher

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.4(22)T

This command was introduced.


Examples

The following is sample output from the show ip sla event-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#

Table 25 describes the fields shown in the display.

Table 25 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 app

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 show ip sla group schedule command in user EXEC or privileged EXEC mode.

show ip sla group schedule [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 show ip sla monitor group schedule 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 show rtr group schedule command.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the show ip sla monitor group schedule command.

12.2(33)SXI

This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the show ip sla monitor group schedule command.


Examples

The following is sample output from the show ip sla group schedule 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 show ip sla group schedule 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

Table 26 describes the significant fields shown in the displays.

Table 26 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

show ip sla configuration

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 show ip sla history command in user EXEC or privileged EXEC mode.

show ip sla history [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.


Defaults

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 show ip sla monitor history 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 show rtr history command.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the show ip sla monitor history command.

12.2(33)SXI

This command was integrated into Cisco IOS Release 12.2(33)SXI. This command replaces the show ip sla monitor history command.


Usage Guidelines

Table 27 lists the Response Return values used in the output of the show ip sla history 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 27 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 show ip sla history command in tabular format:

Router# 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
 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

show ip sla configuration

Displays configuration values including all defaults for all IP SLAs operations or the 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 show ip sla monitor application command is replaced by the show ip sla application command. See the show ip sla application command for more information.


To display global information about Cisco IOS IP Service Level Agreements (SLAs), use the show ip sla monitor application command in user EXEC or privileged EXEC mode.

show ip sla monitor application [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.


Defaults

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 show ip sla application command.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the show rtr application 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 show ip sla application command.

12.2(33)SXI

This command was replaced by the show ip sla application command.


Usage Guidelines

Use the show ip sla monitor application command to display information such as supported operation types and supported protocols.

Examples

The following is sample output from the show ip sla monitor application 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

show ip sla monitor configuration

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 show ip sla monitor authentication command is replaced by the show ip sla authentication command. See the show ip sla authentication command for more information.


To display Cisco IOS IP Service Level Agreements (SLAs) authentication information, use the show ip sla monitor authentication command in user EXEC or privileged EXEC mode.

show ip sla monitor authentication

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 show ip sla authentication command.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the show rtr authentication 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 show ip sla authentication command.

12.2(33)SXI

This command was replaced by the show ip sla authentication command.


Usage Guidelines

Use the show ip sla monitor authentication command to display information such as supported operation types and supported protocols.

Examples

The following is sample output from the show ip sla monitor authentication command:

Router# show ip sla monitor authentication 

IP SLA Monitor control message uses MD5 authentication, key chain name is: ipsla

Related Commands

Command
Description

show ip sla monitor configuration

Displays configuration values for IP SLAs operations.


show ip sla monitor collection-statistics


Note Effective with Cisco IOS Release 12.4(2)T, the show ip sla monitor collection-statistics command is replaced by the show ip sla monitor statistics aggregated command. See the show ip sla monitor statistics aggregated command for more information.


To display statistical errors for all Cisco IOS IP Service Level Agreements (SLAs) operations or a specified operation, use the show ip sla monitor collection-statistics command in user EXEC or privileged EXEC mode.

show ip sla monitor collection-statistics [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.3(14)T

This command was introduced.

12.4(2)T

This command was replaced by the show ip sla monitor statistics aggregated command.


Usage Guidelines

Use the show ip sla monitor collection-statistics command to display information such as the number of failed operations and the failure reason. You can also use the show ip sla monitor distribution-statistics and show ip sla monitor totals-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 show ip sla monitor collection-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

Output for HTTP Operations

The following is output from the show ip sla monitor collection-statistics command when the specified operation is an HTTP operation:

Router# show ip sla monitor collection-statistics 2

        Collected Statistics
Entry Number:2
HTTP URL:http://172.20.150.200
Start Time:*00:01:16.000 UTC Mon Nov 1 2003
             Comps:1              RTTMin:343       
             OvrTh:0              RTTMax:343       
        DNSTimeOut:0              RTTSum:343       
        TCPTimeOut:0             RTTSum2:117649  
        TraTimeOut:0              DNSRTT:0         
          DNSError:0           TCPConRTT:13        
         HTTPError:0            TransRTT:330       
          IntError:0            MesgSize:1771      
            Busies:0 

Output for UDP Jitter Operations

The following is sample output from the show ip sla monitor collection-statistics command, where operation 2 is a jitter operation that includes one-way statistics. Table 28 describes the significant fields shown in the display.

Router# show ip sla monitor collection-statistics

Collected Statistics

Entry Number: 2
Target Address: 5.0.0.1, Port Number:99
Start Time: 11:12:03.000 UTC Thu Jul 1 1999
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:
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
One Way Values:
NumOfOW: 440
OWMinSD: 2  OWMaxSD: 6    OWSumSD: 1273  OWSum2SD: 4021
OWMinDS: 2  OWMaxDS: 341  OWSumDS: 1643  OWSum2DS: 120295

Output for UDP Jitter (codec) Operations

The following is sample output from the show ip sla monitor collection-statistics command, where operation 10 is a UDP jitter (codec) operation. Table 28 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 28 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 type 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.

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

show ip sla monitor configuration

Displays configuration values including all defaults for all IP SLAs operations or the specified operation.

show ip sla monitor distributions-statistics

Displays statistics distribution information (captured response times) for all IP SLAs operations or the specified operation.

show ip sla monitor totals-statistics

Displays the total statistical values (accumulation of error counts and completions) for all IP SLAs operations or the specified operation.

show ntp status

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 show ip sla monitor configuration command is replaced by the show ip sla configuration command. See the show ip sla configuration command 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 show ip sla monitor configuration command in user EXEC or privileged EXEC mode.

show ip sla monitor configuration [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 show ip sla configuration command.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the show rtr 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 show ip sla configuration command.

12.2(33)SXI

This command was replaced by the show ip sla configuration command.


Examples

The following sections show sample output from the show ip sla monitor configuration command for different IP SLAs operations.

Output for ICMP Echo Operations

The following example shows output from the show ip sla monitor configuration 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:

Output for HTTP Operations

The following example shows output from the show ip sla monitor configuration 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

Output for ICMP Path Jitter Operations

The following example shows output from the show ip sla monitor configuration 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

Output for ICMP Path Echo Operations

The following example shows output from the show ip sla monitor configuration 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

Output for DNS Operations

The following example shows output from the show ip sla monitor configuration 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

Output for UDP Echo Operations

The following example shows output from the show ip sla monitor configuration 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:

Output for TCP Connect Operations

The following example shows output from the show ip sla monitor configuration 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:

Output for DHCP Operations

The following example shows output from the show ip sla monitor configuration 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

Output for FTP Operations

The following example shows output from the show ip sla monitor configuration 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

Output for UDP Jitter Operations

The following example shows output from the show ip sla monitor configuration 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

ip sla monitor

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 show ip sla monitor distributions-statistics command is replaced by the show ip sla monitor statistics aggregated details command. See the show ip sla monitor statistics aggregated 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 show ip sla monitor distributions-statistics command in user EXEC or privileged EXEC mode.

show ip sla monitor distributions-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.


Defaults

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 show ip sla monitor statistics aggregated details command.


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 show ip sla monitor collection-statistics and show ip sla monitor totals-statistics commands to display additional statistical information.

Examples

The following is sample output from the show ip sla monitor distributions-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

show ip sla monitor collection-statistics

Displays statistical errors for all IP SLAs operations or the specified operation.

show ip sla monitor configuration

Displays configuration values including all defaults for all IP SLAs operations or the specified operation.

show ip sla monitor totals-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 show ip sla monitor enhanced-history collection-statistics command is replaced by the show ip sla enhanced-history collection-statistics command. See the show ip sla enhanced-history collection-statistics command 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 show ip sla monitor enhanced-history collection-statistics command in user EXEC or privileged EXEC mode.

show ip sla monitor enhanced-history collection-statistics [operation-number] [interval seconds]

Syntax Description

operation-number

(Optional) Number of the operation for which enhanced history statistics is displayed.

interval seconds

(Optional) Displays enhanced history distribution statistics for only the specified aggregation interval.


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 show ip sla enhanced-history collection-statistics command.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the show rtr enhanced-history collection-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 show ip sla enhanced-history collection-statistics command.

12.2(33)SXI

This command was replaced by the show ip sla enhanced-history collection-statistics command.


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 the enhanced-history command.

You can also use the following commands to display additional statistics or history information, or to view the status of the operation:

show ip sla monitor enhanced-history distribution-statistics

show ip sla monitor statistics

show ip sla monitor statistics aggregated


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 terminal width EXEC mode command).


Examples

The following example shows sample output for the show ip sla monitor enhanced-history collection-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
 .
 .
 .

Table 29 describes the significant fields shown in the display.

Table 29 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

ip sla monitor

Allows configuration of IP SLA operations by entering IP SLA monitor configuration mode for the specified operation number.

show ip sla monitor enhanced-history distribution-statistics

Displays enhanced history distribution statistics for IP SLAs operations in tabular format.

show ip sla monitor statistics

Displays the current operational status and statistics of all IP SLAs operations or a specified operation.

show ip sla monitor statistics aggregated

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 show ip sla monitor enhanced-history distribution-statistics command is replaced by the show ip sla enhanced-history distribution-statistics command. See the show ip sla enhanced-history distribution-statistics command for more information.


To display enhanced history distribution statistics for Cisco IOS IP Service Level Agreements (SLAs) operations in tabular format, use the show ip sla monitor enhanced-history distribution-statistics command in user EXEC or privileged EXEC mode.

show ip sla monitor enhanced-history distribution-statistics [operation-number [interval seconds]]

Syntax Description

operation-number

(Optional) Number of the operation for which enhanced history statistics is displayed.

interval seconds

(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.3(14)T

This command was introduced.

12.4(4)T

This command was replaced by the show ip sla enhanced-history distribution-statistics command.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the show rtr enhanced-history distribution-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 show ip sla enhanced-history distribution-statistics command.

12.2(33)SXI

This command was replaced by the show ip sla enhanced-history distribution-statistics command.


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:

show ip sla monitor enhanced-history collection-statistics

show ip sla monitor statistics

show ip sla monitor statistics aggregated


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 terminal width EXEC mode command).


Examples

The following is sample output from the show ip sla monitor enhanced-history distribution-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.


Table 30 describes the significant fields shown in the display.

Table 30 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-kept number 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-kept number 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

ip sla monitor

Allows configuration of IP SLA operations by entering IP SLA monitor configuration mode for the specified operation number.

show ip sla monitor enhanced-history collection-statistics

Displays enhanced history statistics for all collected history buckets for the specified IP SLAs operation.

show ip sla monitor statistics

Displays the current operational status and statistics of all IP SLAs operations or a specified operation.

show ip sla monitor statistics aggregated

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 show ip sla monitor group schedule command is replaced by the show ip sla group schedule command. See the show ip sla group schedule command for more information.


To display the group schedule details for Cisco IOS IP Service Level Agreements (SLAs) operations, use the show ip sla monitor group schedule command in user EXEC or privileged EXEC mode.

show ip sla monitor group schedule [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(14)T

This command was introduced.

12.4(4)T

This command was replaced by the show ip sla group schedule command.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the show rtr group schedule 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 show ip sla group schedule command.

12.2(33)SXI

This command was replaced by the show ip sla group schedule command.


Examples

The following is sample output from the show ip sla monitor group schedule 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 show ip sla monitor group schedule 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

Table 31 describes the significant fields shown in the displays.

Table 31 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

show ip sla monitor configuration

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 show ip sla monitor history command is replaced by the show ip sla history command. See the show ip sla history command for more information.


To display history collected for all Cisco IOS IP Service Level Agreements (SLAs) operations or for a specified operation, use the show ip sla monitor history command in user EXEC or privileged EXEC mode.

show ip sla monitor history [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.


Defaults

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 show ip sla history command.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the show rtr history 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 show ip sla history command.

12.2(33)SXI

This command was replaced by the show ip sla history command.


Usage Guidelines

Table 32 lists the Response Return values used in the output of the show ip sla monitor history 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 32 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 show ip sla monitor history command 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

show ip sla monitor configuration

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 show ip sla monitor mpls-lsp-monitor collection-statistics command is replaced by the show ip sla mpls-lsp-monitor collection-statistics command. See the show ip sla mpls-lsp-monitor collection-statistics command 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 show ip sla monitor mpls-lsp-monitor collection-statistics command in user EXEC or privileged EXEC mode.

show ip sla monitor mpls-lsp-monitor collection-statistics [group-id]

Syntax Description

group-id

(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 show ip sla mpls-lsp-monitor collection-statistics command.


Usage Guidelines

Use the show ip sla monitor mpls-lsp-monitor collection-statistics command 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 show ip sla monitor mpls-lsp-monitor collection-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-Se
3/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


Table 33 describes the significant fields shown in the display.

Table 33 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

auto ip sla mpls-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 show ip sla monitor mpls-lsp-monitor configuration command is replaced by the show ip sla mpls-lsp-monitor configuration command. See the show ip sla mpls-lsp-monitor configuration command for more information.


To display configuration settings for IP Service Level Agreements (SLAs) label switched path (LSP) Health Monitor operations, use the show ip sla monitor mpls-lsp-monitor configuration command in user EXEC or privileged EXEC mode.

show ip sla monitor mpls-lsp-monitor configuration [operation-number]

Syntax Description

operation-number

(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 show rtr mpls-lsp-monitor 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 show ip sla mpls-lsp-monitor configuration 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 show ip sla monitor mpls-lsp-monitor configuration 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 show ip sla monitor mpls-lsp-monitor configuration 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


Table 34 describes the significant fields shown in the displays.

Table 34 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

auto ip sla mpls-lsp-monitor

Begins configuration for an IP SLAs LSP Health Monitor operation and enters auto IP SLA MPLS configuration mode.

auto ip sla mpls-lsp-monitor reaction-configuration

Configures proactive threshold monitoring parameters for an IP SLAs LSP Health Monitor operation.

auto ip sla mpls-lsp-monitor schedule

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 show ip sla monitor mpls-lsp-monitor lpd operational-state command is replaced by the show ip sla mpls-lsp-monitor lpd operational-state command. See the show ip sla mpls-lsp-monitor lpd operational-state command 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 show ip sla monitor mpls-lsp-monitor lpd operational-state command in user EXEC or privileged EXEC mode.

show ip sla monitor mpls-lsp-monitor lpd operational-state [group-id]

Syntax Description

group-id

(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 show ip sla mpls-lsp-monitor lpd operational-state command.


Usage Guidelines

Use the show ip sla monitor mpls-lsp-monitor lpd operational-state command 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 show ip sla monitor mpls-lsp-monitor lpd operational-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


Table 35 describes the significant fields shown in the display.

Table 35 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 auto ip sla mpls-lsp-monitor reaction-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

auto ip sla mpls-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 show ip sla monitor mpls-lsp-monitor neighbors command is replaced by the show ip sla mpls-lsp-monitor neighbors command. See the show ip sla mpls-lsp-monitor neighbors command 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 show ip sla monitor mpls-lsp-monitor neighbors command in user EXEC or privileged EXEC mode.

show ip sla monitor mpls-lsp-monitor neighbors

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 show rtr mpls-lsp-monitor neighbors 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 show ip sla mpls-lsp-monitor neighbors command.


Examples

The following is sample output from the show ip sla monitor mpls-lsp-monitor neighbors command:

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)


Table 36 describes the significant fields shown in the display.

Table 36 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

auto ip sla mpls-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 show ip sla monitor mpls-lsp-monitor scan-queue command is replaced by the show ip sla mpls-lsp-monitor scan-queue command. See the show ip sla mpls-lsp-monitor scan-queue command 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 show ip sla monitor mpls-lsp-monitor scan-queue command in user EXEC or privileged EXEC mode.

show ip sla monitor mpls-lsp-monitor scan-queue operation-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(31)SB2

This command was introduced. This command replaces the show rtr mpls-lsp-monitor scan-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 show ip sla mpls-lsp-monitor scan-queue command.


Examples

The following is sample output from the show ip sla monitor mpls-lsp-monitor scan-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


Table 37 describes the significant fields shown in the display.

Table 37 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

auto ip sla mpls-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.

mpls discovery vpn interval

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 show ip sla monitor mpls-lsp-monitor summary command is replaced by the show ip sla mpls-lsp-monitor summary command. See the show ip sla mpls-lsp-monitor summary command 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 show ip sla monitor mpls-lsp-monitor summary command in user EXEC or privileged EXEC mode.

show ip sla monitor mpls-lsp-monitor summary [operation-number [group [group-id]]]

Syntax Description

operation-number

(Optional) Number of the LSP Health Monitor operation for which the details will be displayed.

group group-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 show ip sla mpls-lsp-monitor summary command.


Usage Guidelines

Use the show ip sla monitor mpls-lsp-monitor summary command 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 show ip sla monitor mpls-lsp-monitor summary operation-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 show ip sla monitor mpls-lsp-monitor summary operation-number group group-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


Table 38 describes the significant fields shown in the display.

Table 38 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

auto ip sla mpls-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 show ip sla monitor reaction-configuration command is replaced by the show ip sla reaction-configuration command. See the show ip sla reaction-configuration command 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 show ip sla monitor reaction-configuration command in user EXEC or privileged EXEC mode.

show ip sla monitor reaction-configuration [operation-number]

Syntax Description

operation-number

(Optional) Number of the operation for which the reaction configuration characteristics is displayed.


Defaults

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 show ip sla reaction-configuration command.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the show rtr reaction-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 show ip sla reaction-configuration command.

12.2(33)SXI

This command was replaced by the show ip sla reaction-configuration command.


Usage Guidelines

Use the ip sla monitor reaction-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:

Router# show ip sla monitor reaction-configuration 

Entry Number: 1
Reaction: RTT
Threshold type: Never
Rising (milliseconds): 5000
Falling (milliseconds): 3000
Threshold Count: 5
Threshold Count2: 5
Action Type: None

Reaction: jitterDSAvg
Threshold type: average
Rising (milliseconds): 5
Falling (milliseconds): 3
Threshold Count: 5
Threshold Count2: 5
Action Type: triggerOnly

Reaction: jitterDSAvg
Threshold type:  immediate
Rising (milliseconds): 5
Falling (milliseconds): 3
Threshold Count: 5
Threshold Count2: 5
Action Type: trapOnly

Reaction: PacketLossSD 
Threshold type:  immediate
Rising (milliseconds): 5
Threshold Falling (milliseconds): 3
Threshold Count: 5
Threshold Count2: 5
Action Type: trapOnly

Table 39 describes the significant fields shown in the display.

Table 39 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 ip sla monitor reaction-configuration command.

Threshold type

The configured threshold type.

Corresponds to the threshold-type {never | immediate | consecutive | xofy | average} syntax in the ip sla monitor reaction-configuration command.

Rising (milliseconds)

The upper-threshold value.

Corresponds to the threshold-value upper-threshold lower-threshold syntax in the ip sla monitor reaction-configuration command.

Falling (milliseconds)

The lower-threshold value.

Corresponds to the threshold-value upper-threshold lower-threshold syntax in the ip sla monitor reaction-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 ip sla monitor reaction-configuration command.


Related Commands

Command
Description

ip sla monitor reaction-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 show ip sla monitor reaction-trigger command is replaced by the show ip sla reaction-trigger command. See the show ip sla reaction-trigger command 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 show ip sla monitor reaction-trigger command in user EXEC or privileged EXEC mode.

show ip sla monitor reaction-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.3(14)T

This command was introduced.

12.4(4)T

This command was replaced by the show ip sla reaction-trigger command.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the show rtr reaction-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 show ip sla reaction-trigger command.

12.2(33)SXI

This command was replaced by the show ip sla reaction-trigger command.


Usage Guidelines

Use the show ip sla monitor reaction-trigger command to display the configuration status and operational state of target operations that will be triggered as defined with the ip sla monitor reaction-configuration global configuration command.

Examples

The following is sample output from the show ip sla monitor reaction-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

show ip sla monitor configuration

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 show ip sla monitor responder command is replaced by the show ip sla responder command. See the show ip sla responder command for more information.


To display information about the Cisco IOS IP Service Level Agreements (SLAs) Responder, use the show ip sla monitor responder command in user EXEC or privileged EXEC mode.

show ip sla monitor responder

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 show ip sla responder command.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the show rtr responder 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 show ip sla responder command.

12.2(33)SXI

This command was replaced by the show ip sla responder command.


Usage Guidelines

Use the show ip sla monitor responder command 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 show ip sla monitor responder 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

show ip sla monitor configuration

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 show ip sla monitor statistics command is replaced by the show ip sla statistics command. See the show ip sla statistics command 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 show ip sla monitor statistics command in user EXEC or privileged EXEC mode.

show ip sla monitor statistics [operation-number] [details]

Syntax Description

operation-number

(Optional) Number of the operation for which operational status and statistics are displayed.

details

(Optional) Operational status and statistics are displayed in greater detail.


Defaults

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 show ip sla statistics command.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the show rtr operational-state 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 show ip sla statistics command.

12.2(33)SXI

This command was replaced by the show ip sla statistics command.


Usage Guidelines

Use the show ip sla monitor statistics 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 show ip sla monitor statistics command:

Router# show ip sla monitor statistics

        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 show ip sla monitor statistics command when the specified operation is a UDP jitter (codec) operation. The values shown indicate the values for the last IP SLAs operation.

Router# show ip sla monitor statistics

        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


Table 40 describes the significant fields shown in the display.

Table 40 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 type 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.


Related Commands

Command
Description

show ip sla monitor configuration

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 show ip sla monitor statistics aggregated command is replaced by the show ip sla statistics aggregated command. See the show ip sla statistics aggregated command 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 show ip sla monitor statistics aggregated command in user EXEC or privileged EXEC mode.

show ip sla monitor statistics aggregated [operation-number] [details]

Syntax Description

operation-number

(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 show ip sla statistics aggregated command.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2. This command replaces the show rtr collection-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 show ip sla statistics aggregated command.

12.2(33)SXI

This command was replaced by the show ip sla statistics aggregated command.


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 show ip sla monitor statistics aggregated and show ip sla monitor statistics aggregated details commands for different IP SLAs operations.

Output for HTTP Operations

The following example shows output from the show ip sla monitor statistics aggregated and show ip sla monitor statistics aggregated details commands 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

Output for UDP Jitter Operations

The following is sample output from the show ip sla monitor statistics aggregated and show ip sla monitor statistics aggregated details commands 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

Output for ICMP Echo Operations

The following is sample output from the show ip sla monitor statistics aggregated and show ip sla monitor statistics aggregated details commands 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

Output for TCP Connect, DNS, FTP, DHCP, and UDP Echo Operations

The following is sample output from the show ip sla monitor statistics aggregated and show ip sla monitor statistics aggregated details commands 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

Output for ICMP Path Echo Operations

The following is sample output from the show ip sla monitor statistics aggregated and show ip sla monitor statistics aggregated details commands 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.

show ip sla monitor configuration

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 show ip sla monitor totals-statistics command is replaced by the show ip sla monitor statistics aggregated command. See the show ip sla statistics aggregated command 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 show ip sla monitor totals-statistics command in user EXEC or privileged EXEC mode.

show ip sla monitor totals-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.


Defaults

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 show ip sla monitor statistics aggregated 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 show ip sla monitor distributions-statistics and show ip sla monitor collection-statistics commands to display additional statistical information.

Examples

The following is sample output from the show ip sla monitor totals-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

show ip sla monitor collection-statistics

Displays statistical errors for all IP SLAs operations or the specified operation.

show ip sla monitor configuration

Displays configuration values including all defaults for all IP SLAs operations or the specified operation.

show ip sla monitor distributions-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 show ip sla mpls-lsp-monitor collection-statistics command in user EXEC or privileged EXEC mode.

show ip sla mpls-lsp-monitor collection-statistics [group-id]

Syntax Description

group-id

(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 show ip sla monitor mpls-lsp-monitor collection-statistics command.


Usage Guidelines

Use the show ip sla mpls-lsp-monitor collection-statistics command 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 show ip sla mpls-lsp-monitor collection-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-Se
3/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


Table 41 describes the significant fields shown in the display.

Table 41 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

auto ip sla mpls-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 show ip sla mpls-lsp-monitor configuration command in user EXEC or privileged EXEC mode.

show ip sla mpls-lsp-monitor configuration [operation-number]

Syntax Description

operation-number

(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 show rtr mpls-lsp-monitor configuration command.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB. This command replaces the show ip sla monitor mpls-lsp-monitor configuration 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 show ip sla mpls-lsp-monitor configuration 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


Table 42 describes the significant fields shown in the display.

Table 42 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