Guest

Cisco IOS Software Releases 12.2 T

SAA SLM for ATM Intefaces

Table Of Contents

SAA SLM for ATM Interfaces

Contents

Information About SAA SLM for ATM Interfaces

ATM Service Level Monitoring

Enabling Operations on Both Ends of the Connection

Restrictions

How to Configure SAA Monitoring for ATM Connections

Configuring Monitoring of a Physical Interface or Controller

Restrictions

Example

What to Do Next

Configuring Monitoring of an ATM Link

Restrictions

Example

What to Do Next

Configuring Monitoring of a ATM Circuit

Restrictions

Examples

What to Do Next

Enabling CNS for SAA Data Retrieval

Configuration Examples for SAA Monitoring for ATM Connections

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Command Reference

atm-slm statistics

type slm interface

type slm controller

type slm atm interface

type slm atm pvc interface

show rtr enhanced-history distribution-statistics


SAA SLM for ATM Interfaces


The Cisco Service Assurance Agent (SAA) is an embedded performance monitoring utility in Cisco IOS software. The Service Level Monitor (SLM) is one of the features available in the SAA feature set.

The SAA Service Level Monitor (SLM) for ATM Interfaces feature expands the capabilities of SAA by providing detailed monitoring statistics for your ATM network. The SAA SLM can be used to gather statistics for either physical links or circuits. Monitoring service levels for ATM connections allows service providers to ensure that their networks are meeting or exceeding the performance outlined in service level agreements (SLAs).

Specifications for the SAA SLM for ATM Interfaces Feature

Feature History
 
Release
Modification

12.2(11)T

The SAA for ATM Interfaces (Service Level Monitor) feature was introduced. Only T1 ATM interfaces and DS1 Port Adapters were supported in this release.

12.2(15)T

The SAA SLM for ATM Interfaces feature was introduced to replace the SAA for ATM Interfaces feature: the command syntax was changed, and support for OC3 and DS3 (T3) ATM Port Adaptors was added.

Supported Platforms

Cisco IAD2420 Smart Integrated Access Device (IAD); Cisco 2600 Series with T1 or E1interfaces (Cisco 2650 and 2651 Modular Access Routers); Cisco 3660 Series with T1 or E1 ATM interfaces; Cisco MC3810 Multiservice Access Concentrators; and Cisco 7200 series. For support updates, see Feature Navigator.

Document Version
 
1.0

August 5, 2003


Finding Support Information for Platforms and Cisco IOS Software Images

Use Cisco Feature Navigator to find updated information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.

Contents

Information About SAA SLM for ATM Interfaces

How to Configure SAA Monitoring for ATM Connections

Configuration Examples for SAA Monitoring for ATM Connections

Additional References

Command Reference

Information About SAA SLM for ATM Interfaces

To configure the SAA SLM for ATM Interfaces feature, you should understand the following concepts:

ATM Service Level Monitoring

Enabling Operations on Both Ends of the Connection

ATM Service Level Monitoring

The SLM ATM operations provide both active and passive monitoring and can be applied to either interfaces or circuits.

Specifically, this feature provides four operations that perform the following functions:

Monitoring of a Physical Interface—The SLM interface operation ("type slm interface") provides physical layer (Layer 1) data for interfaces configured for ATM. This operation provides data for T1 (IMA) interfaces and Serial interfaces.

Monitoring of a Physical Controller— The SLM controller operation ("type slm controller") provides physical layer (Layer 1) data for controllers configured for ATM. This operation provides data for T1 or E1 controllers.

Monitoring of a ATM Link—The SLM ATM interface operation ("type slm atm interface") provides Layer 2 data for an ATM interface.

Monitoring of a ATM Circuit—The SLM ATM circuit operation ("type slm atm pvc interface") provides ATM permanent virtual circuit (PVC) data.

By using these operations together, you can generate statistics for the physical interface, the ATM connection as a whole, and for specific ATM circuits (PVCs). Table 1shows the correspondence between the operation name and the command used to enable the operation.

Table 1 Types of SAA Frame Relay Monitoring Operations

Operation
Purpose
Command
Name (Type) in CLI
       

SLM Interface or Controller Operation

Monitors a physical interface configured for ATM or Frame Relay.

For ATM, applies to T1 or E1 controllers, and IMA interfaces.

type slm {interface | controller}

"slm interface" or

"slm controller"

SLM ATM Interface Operation

Monitors an ATM connection at the link layer.

type slm atm interface

"Slm Atm Interface"

SLM ATM Circuit Operation

Monitors an ATM permanent virtual circuit (PVC).

type slm atm pvc interface

"Slm Atm Pvc"


The metrics provided by SAA service level monitoring operations, such as the ATM SLM operations, are designed to provide information useful in determining that service level agreements (SLAs) are being met (SLA validation). Service providers can use the SLM ATM operations to determine round trip time (RTT), bandwidth usage, throughput, packet loss, burst analysis, delivery ratio, utilization, total frames transmitted, total frames received, and more. The SLM ATM operations can provide over 100 different metrics for traffic analysis.

The SAA for ATM Interfaces feature can be used with Cisco Networking Services (CNS). A device running CNS, such as the IE2100, can be used to retrieve the ATM performance statistics generated by the SAA. An XML Get or Set request can be issued from the IE2100 after the router registers with the CNS event agent. Additionally, these results can be passed, in an XML format, to other devices running third-party monitoring software, such as Visual Networks' UpTime application.

Figure 1 Retrieval Methods for SAA SLM Operational Data

SAA, when used with external applications such as Visual Network's UpTime, provides the information and toolsets required to:

completely automate the collection, archiving, and presentation of data to validate a carrier SLA

accurately measure network availability

accurately measure network delay

accurately measure throughput

Trending, reporting, troubleshooting and planning tools enhance the performance and availability of the integrated access network. This provides short and long-term cost savings through reduced downtime, increased productivity of network support staff, and optimization of the network.

Enabling Operations on Both Ends of the Connection

Unlike other SAA operations, you do not enable the SAA Responder on the operational target (replying) device. Instead, to get the full monitoring statistics for ATM connections, you should enable the same operation on both the sending (agent) device and replying (target) device. SAA will automatically retrieve the additional statistics generated when the Frame Relay operations are configured on the target device. For ATM SLM operations, it may be helpful to think of the routers as "near-end" and "far-end" devices instead of as "sending" and "replying" devices.

Restrictions

The following operations are not supported in the CISCO-RTTMON-MIB:

HTTP first byte operations

Frame Relay operations

Path Jitter operations

ATM interface service level monitoring operations

Frame Relay service level monitoring operations

Interface service level monitoring operations (Serial/HSSI/DDS/IMA-E1/IMA-T1)

Controller service level monitoring operations (T1/E1/DS3/E3/FT1)

This means that ATM performance statistics cannot be retrieved from Cisco IOS devices using SNMP. This feature was designed to provide data by responding to extensible markup language (XML) requests.

How to Configure SAA Monitoring for ATM Connections

To configure SAA Monitoring for ATM connections, perform one or more of the following tasks:

Configuring Monitoring of a Physical Interface or Controller

Configuring Monitoring of an ATM Link

Configuring Monitoring of a ATM Circuit

Enabling CNS for SAA Data Retrieval

Configuring Monitoring of a Physical Interface or Controller

ATM monitoring using SAA can be configured for an interface or controller at the physical layer, for an interface at the data layer, or for a specific circuit. The follow task describes configuring the SAA operation for an ATM interface or controller at the physical layer.

All steps are required unless otherwise indicated.

Restrictions

To enable full statistics gathering for SAA ATM service level monitoring operations, the operation must be configured on both ends of the ATM connection.

Standard SAA distribution and history statistics are not supported in SLM operations; instead, use the show enhanced-history commands. Enhanced history data is stored as individual samples in each bucket. Aggregated (averaged) data for SLM operations is not available from the CLI.

SUMMARY STEPS

1. enable

2. configure terminal

3. atm slm statistics

4. rtr operation-id

5. type slm interface OR type slm controller

6. enhanced history

7. exit

8. Repeat Steps 1 through 7 on the device at the far end of the connection.

9. rtr schedule

10. end

11. copy running-config startup-config (optional)

12. Allow statistics to be gathered for the desired amount of time.

13. show rtr operational-state (optional)

14. show rtr enhanced-history collection-statistics (optional)

15. show rtr enhanced-history distribution-statistics (optional)

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode.

Enter your password if prompted.

Step 2 

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 3 

atm slm statistics

Example:

Router(config)# atm-slm statistics

Enables the SAA SLM to collect ATM performance monitoring statistics.

This command is required to begin gathering statistics for ATM interfaces or circuits.

Step 4 

rtr operation-number

Example:

Router(config)# rtr 1

Specifies an identification number (ID) for the operation being configured, and enters SAA RTR configuration mode.

Step 5 

type slm interface interface-id

OR

type slm controller controller-id

Example:

Router(config-rtr)# type slm interface ATM 0.1

OR

Router(config-rtr)# type slm controller T1 0 

Specifies that the operation is an SLM physical interface operation, which provides information about the data link layer connection, and specifies the interface that the operation should be run on.

Controllers that can be monitored using this operation include T1,E1,T3, and E3.

For a T1 controller operation on an Integrated (IMA) interface, use the type slm interface IMA-interface-number command.

The specified interface or controller should be configured for ATM.

The type slm interface or type slm controller commands bring you into SAA SLM Controller/Interface configuration mode.

Step 6 

enhanced-history interval seconds buckets number-of-buckets

Example:

Router(config-rtr-slm-if)# enhanced-history interval 900 buckets 100

Enables SAA enhanced history for the operation. Performance statistics are stored in "buckets" which keep the accumulated data separate from each other. Each bucket consists of data accumulated over the specified interval. For Frame Relay SLM and ATM SLM operations, each bucket consists of 15 minutes (900 seconds) worth of statistics. The following line will be written to the configuration:

enhanced-history interval 900 buckets 100

Note Regardless of the values entered for seconds and number-of-buckets, the default of value of a 900 second interval and 100 history buckets will be used. Your input is overridden in the ATM operations so that complete SLM statistics can be provided.

Step 7 

exit

Example:

Router(config-rtr-slm-if)# exit

Exits SAA SLM Controller/Interface configuration mode.

Step 8 

Repeat Steps 1 through 7 on the device at the far end of the connection.

Step 9 

rtr schedule operation-number {start-time {hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss} [ageout seconds] [life {forever | seconds}]

Example:

Router(config)# rtr schedule 1 start-time now life forever

Specifies when the operation should start.

This step, unlike Steps 1 through 7, only has to be performed on one end of the ATM connection.

Step 10 

end

Example:

Router(config)# end

(Optional) Ends the current configuration session.

Step 11 

copy running-config startup-config

or

copy system:running-config nvram:startup-config 
Example:

Router# copy running-config startup-config

(Optional) Saves the configuration to NVRAM.

Step 12 

Allow statistics to be gathered for the desired amount of time.

Step 13 

show rtr operational-state operation-number

Example:

Router# show rtr operation 1


(Optional) Displays the state of the operation and the statistics for the last probe operation.

Step 14 

show rtr enhanced-history collection-statistics operation-number

Example:

Router# show rtr enhanced-history collection-statistics 1


(Optional) Displays data for all collected history buckets for the specified SAA operation with failure data for each bucket.

Step 15 

show rtr enhanced-history distribution-statistics operation-number

Example:

Router# show rtr enhanced-history distribution-statistics 1



(Optional) Displays enhanced history data for all collected buckets in a summary table.

Because the enhanced history aggregation interval is fixed at 900 seconds for SLM operations, the optional interval keyword available for this command will not work for SLM operations.

Example

Router> enable 
Password:
Router# configure terminal 
Enter configuration commands, one per line.
Router(config)# atm-slm statistics 
Router(config)# rtr 1 
Router(config-rtr)# type slm controller T1 0 
Router(config-rtr-slm-if)# enhanced-history interval 900 buckets 100 
Router(config-rtr-slm-if)# exit 
Router(config)# rtr schedule 1 start-time now life forever 
Router(config)# end 
Router#
slm1-3810-4# show rtr config 1
Entry number: 1
Owner: 
Tag: 
Type of operation to perform: slm controller
T1/E1/T3/E3 Controller: T1 0
Operation timeout (milliseconds): 5000
Operation frequency (seconds): 900
Next Scheduled Start Time: Start Time already passed
Life (seconds): Forever
Entry Ageout (seconds): never
Status of entry (SNMP RowStatus): Active
Connection loss reaction enabled: No
Timeout reaction enabled: No
Verify error enabled: No
Threshold reaction type: Never
Threshold (milliseconds): 5000
Threshold Falling (milliseconds): 3000
Threshold Count: 5
Threshold Count2: 5
Reaction Type: None
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 1
Statistic distribution interval (milliseconds): 20
Enhanced History:
Aggregation Interval:900 Buckets:100

Router#
Router# show rtr operational-state 1 

Entry number: 1
Modification time: *02:13:28.643 UTC Mon May 5 2003
Number of operations attempted: 9
Number of operations skipped: 0
Current seconds left in Life: Forever
Operational state of entry: Active
Last time this entry was reset: Never
Connection loss occurred: FALSE
Timeout occurred: FALSE
Over thresholds occurred: FALSE
Latest RTT (milliseconds): 0
Latest operation start time: *02:15:00.007 UTC Mon May 5 2003
Latest operation return code: OK

  Ds1StatRxLineStatus:  16385
  Ds1StatRxBPVs:  0,             Ds1StatRxCrcFrameErrors:  0
  Ds1StatRxErrSecs:  0,          Ds1StatRxSevereErrSecs:  0
  Ds1StatRxUnavailSecs:  0,      Ds1StatRxBurstyErrSecs:  0

Sample Index = 9


Router# show rtr enhanced-history collection-statistics 1 

Entry number: 1
Aggregation Interval: 900

Bucket Index: 1
Aggregation start time 00:15:00.004 UTC Mon May 5 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


Ds1StatRxLineStatus:  16385
  Ds1StatRxBPVs:  0,             Ds1StatRxCrcFrameErrors:  0
  Ds1StatRxErrSecs:  0,          Ds1StatRxSevereErrSecs:  0
  Ds1StatRxUnavailSecs:  0,      Ds1StatRxBurstyErrSecs:  0

Sample Index = 1

Bucket Index: 2
Aggregation start time 00:30:00.005 UTC Mon May 5 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


  Ds1StatRxLineStatus:  16385
  Ds1StatRxBPVs:  0,             Ds1StatRxCrcFrameErrors:  0
  Ds1StatRxErrSecs:  0,          Ds1StatRxSevereErrSecs:  0
  Ds1StatRxUnavailSecs:  0,      Ds1StatRxBurstyErrSecs:  0

Sample Index = 2

Bucket Index: 3
 .
 .

 .

Rotuer# show rtr enhanced-history distribution-statistics 1 
Point by point Enhanced History
Entry    = Entry Number
Int      = Aggregation Interval
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   n
1     900 1    900001     1   1   1     0     0          0          0           
1     900 2    1800003    1   1   1     0     0          0          0           
1     900 3    2700001    1   1   1     0     0          0          0           
1     900 4    3600002    1   1   1     0     0          0          0           
1     900 5    4500004    1   1   1     0     0          0          0           
1     900 6    5400002    1   1   1     0     0          0          0           
1     900 7    6300003    1   1   1     0     0          0          0           
1     900 8    7200001    1   1   1     0     0          0          0           
1     900 9    8100003    1   1   1     0     0          0          0 
 .
 .
 .

What to Do Next

If SAA data is to be passed to a CNS enabled router, you should perform the task in the "Enabling CNS for SAA Data Retrieval" section.

Configuring Monitoring of an ATM Link

ATM monitoring using SAA can be configured for an interface at the physical layer, for an interface at the data link layer, or for a specific circuit. The follow task describes configuring the SAA operation for a ATM interface at the data link layer.

Restrictions

To enable full statistic gathering for the SAA ATM service level monitoring operation, the operation must be configured on both ends of the ATM connection.

Standard SAA distribution and history statistics are not supported in SLM operations. Aggregated (averaged) data for SLM operations is not available from the CLI. Enhanced history data is stored as individual samples in each bucket.

SUMMARY STEPS

1. enable

2. configure terminal

3. atm-slm statistics

4. rtr operation-number

5. type slm atm interface

6. enhanced history

7. exit

8. Repeat Steps 1 through 7 on the device at the far end of the connection.

9. rtr schedule

10. end

11. copy running-config startup-config (optional)

12. Allow statistics to be gathered for the desired amount of time.

13. show rtr operational-state (optional)

14. show rtr enhanced-history collection-statistics (optional)

15. show rtr enhanced-history distribution-statistics (optional)

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode.

Enter your password if prompted.

Step 2 

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 3 

atm-slm statistics

Example:

Router(config)# atm-slm statistics

Enables SAA to collect ATM performance monitoring statistics.

This command is required to begin gathering statistics for the ATM interface or circuit.

Step 4 

rtr operation-number

Example:

Router(config)# rtr 2

Specifies an identification number for the operation being configured, and enters SAA RTR configuration mode.

To stop a previously configured operation, use the no rtr operation-number command.

Step 5 

type slm atm interface interface-id

Example:

Router(config-rtr)# type slm atm interface ATM1/1/0

Specifies that the operation is an SLM ATM interface operation, which provides Layer 2 data for a ATM link, and specifies the interface that the operation should be run on.

The specified interface should be configured for ATM.

The ATM interface link statistics are used to monitor the basic health of a ATM interface. This information includes some traffic counters, assorted error counts, and some performance related counters.

Step 6 

enhanced-history interval seconds buckets number-of-buckets

Example:
Router(config-rtr-slm-atm-if)# enhanced-history 
interval 900 buckets 100

Enables SAA enhanced history for the operation. Performance statistics are stored in "buckets" which keep the accumulated data separate from each other. Each bucket consists of data accumulated over the specified interval. For Frame Relay SLM and ATM SLM operations, each bucket consists of 15 minutes (900 seconds) worth of statistics. The following line will be written to the configuration:

enhanced-history interval 900 buckets 100

Note Regardless of the values entered for seconds and number-of-buckets, the default of value of a 900 second interval and 100 history buckets will be used. Your input is overridden in the ATM operations so that complete SLM statistics can be provided.

Step 7 

exit

Example:

Router(config-rtr-slm-atm-if)# exit

Exits SAA SLM ATM Interface configuration mode.

Step 8 

Repeat Steps 1 through 7 on the device at the far end of the connection.

Step 9 

rtr schedule operation-number {start-time {hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss} [ageout seconds] [life {forever | seconds}]

Example:

Router(config)# rtr schedule 2 start-time now life forever

Specifies when the operation should start.

This step, unlike Steps 1 through 7, only has to be performed on one end of the ATM connection.

Step 10 

end

Example:

Router(config)# end

(Optional) Ends the current configuration session.

Step 11 

copy running-config startup-config

or

copy system:running-config nvram:startup-config 
Example:

Router# copy running-config startup-config

(Optional) Saves the configuration to NVRAM.

Step 12 

Allow statistics to be gathered for the desired amount of time.

Step 13 

show rtr operational-state operation-number

Example:

Router# show rtr operation 2


(Optional) Displays the state of the operation and the statistics for the last probe operation.

Step 14 

show rtr enhanced-history collection-statistics operation-number

Example:

Router# show rtr enhanced-history collection-statistics 2


(Optional) Displays data for all collected history buckets for the specified SAA operation with failure data for each bucket.

Because the command displays statistics per bucket, and SLM operations are configured for 100 buckets, this command may generate a large amount of output. To escape back to the command line, use Ctrl-Z.

Step 15 

show rtr enhanced-history distribution-statistics operation-number

Example:

Router# show rtr enhanced-history distribution-statistics 2



(Optional) Displays enhanced history data for all collected buckets in a summary table.

Because the enhanced history aggregation interval is fixed at 900 seconds for SLM operations, the optional interval keyword available for this command will not work for SLM operations.

Example

Router> enable 
Password:
Router# configure terminal 
Enter configuration commands, one per line.
Router(config)# atm-slm statistics
Router(config)# rtr 2

Router(config-rtr)# type slm atm interface ATM0

Router(config-rtr-slm-atm-if)# ?
SAA slm atm interface Configuration Commands:
! Only the following list of commands in this mode apply to SLM operations: 
  default                           Set a command to its defaults
  enhanced-history                  Enable enhanced history collection
  exit                              Exit from RTR configuration mode
  no                                Negate a command or set its defaults
  owner                             Owner of Entry
  tag                               User defined tag
  threshold                         Operation threshold in milliseconds
  timeout                           Timeout of an operation

Router(config-rtr-slm-atm-if)# enhanced-history interval 900 buckets 100
Router(config-rtr-slm-atm-if)# exit
Router(config)# rtr schedule 2 start-time now life forever
Router(config)# end 
Router# show rtr configuration 2 
Entry number: 2
Owner: 
Tag: 
Type of operation to perform: Slm Atm Interface
Atm Interface: ATM0
Operation timeout (milliseconds): 5000
Operation frequency (seconds): 900
Next Scheduled Start Time: *12:44:59.851 PDT Fri Mar 26 1993
Life (seconds): Forever
Entry Ageout (seconds): never
Status of entry (SNMP RowStatus): Active
Connection loss reaction enabled: No
Timeout reaction enabled: No
Verify error enabled: No
Threshold reaction type: Never
Threshold (milliseconds): 5000
Threshold Falling (milliseconds): 3000
Threshold Count: 5
Threshold Count2: 5
Reaction Type: None
Number of statistic hours kept: 2
Number of statistic distribution buckets kept: 1
Statistic distribution interval (milliseconds): 20
Enhanced History:
Aggregation Interval:900 Buckets:100
Router# show rtr operational-state 2 
Entry number: 2
Modification time: *17:00:07.502 PDT Sun June 29 2003
Number of operations attempted: 2476
Number of operations skipped: 0
Current seconds left in Life: Forever
Operational state of entry: Active
Last time this entry was reset: Never
Connection loss occurred: FALSE
Timeout occurred: FALSE
Over thresholds occurred: FALSE
Latest RTT (milliseconds): 0
Latest operation start time: *11:59:59.856 PDT Fri Jul 4 2003
Latest operation return code: OK

LinkState :0 
LinkState :0 
Tx Total Cells:  185               Rx Total Cells:  185            
Tx AAL1 Cells:   0                 Rx AAL1 Cells:   0              
Tx AAL2 Cells:   0                 Rx AAL2 Cells:   0              
Tx AAL5 Cells:   3                 Rx AAL5 Cells:   3              
Tx Path Cells:   0                 Rx Path Cells:   0              
Tx Plcp Framing: 2                 Rx Plcp Framing: 0              
Tx Plcp Errors:  0                 Rx Plcp Errors:  0              
Tx Corrected Cells:  0             Rx Corrected Cells: 0              
Tx Uncorrected Cells:  0           Rx Uncorrected Cells: 0              
Tx OCD Secs:  0                    Rx OCD Secs: 0              
Tx AIS Secs:  0                    Rx AIS Secs: 0              
Tx RDI Secs:  0                    Rx RDI Secs: 0              
Tx Max Cells Per Secs:  2          Rx Max Cells Per Secs: 2
Cell Replacement Events:  0        Rx Cell Unalayzed Data Event: 0
Tx Burst Percent1(sec):  900       Rx Burst Percent1(sec): 900
Tx Burst Percent2(sec):  0         Rx Burst Percent2(sec): 0
Tx Burst Percent3(sec):  0         Rx Burst Percent3(sec): 0
Tx Burst Percent4(sec):  0         Rx Burst Percent4(sec): 0
Tx Burst Percent5(sec):  0         Rx Burst Percent5(sec): 0

Sample Index = 2476

Router# show rtr enhanced-history collection-statistics 2 

Entry number: 2
Aggregation Interval: 900
Bucket Index: 1
Aggregation start time 11:14:59.856 PDT Thu Jul 3 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


LinkState :0 
Tx Total Cells:  184               Rx Total Cells:  184            
Tx AAL1 Cells:   0                 Rx AAL1 Cells:   0              
Tx AAL2 Cells:   0                 Rx AAL2 Cells:   0              
Tx AAL5 Cells:   3                 Rx AAL5 Cells:   3              
Tx Path Cells:   0                 Rx Path Cells:   0              
Tx Plcp Framing: 2                 Rx Plcp Framing: 0              
Tx Plcp Errors:  0                 Rx Plcp Errors:  0              
Tx Corrected Cells:  0             Rx Corrected Cells: 0 
Tx Uncorrected Cells:  0           Rx Uncorrected Cells: 0              
Tx OCD Secs:  0                    Rx OCD Secs: 0              
Tx AIS Secs:  0                    Rx AIS Secs: 0              
Tx RDI Secs:  0                    Rx RDI Secs: 0              
Tx Max Cells Per Secs:  2          Rx Max Cells Per Secs: 2
Cell Replacement Events:  0        Rx Cell Unalayzed Data Event: 0
Tx Burst Percent1(sec):  900       Rx Burst Percent1(sec): 900
Tx Burst Percent2(sec):  0         Rx Burst Percent2(sec): 0
Tx Burst Percent3(sec):  0         Rx Burst Percent3(sec): 0
Tx Burst Percent4(sec):  0         Rx Burst Percent4(sec): 0
Tx Burst Percent5(sec):  0         Rx Burst Percent5(sec): 0

Sample Index = 2377

Bucket Index: 2
Aggregation start time 11:29:59.852 PDT Thu Jul 3 2003
 .
 .
 .

Router# show rtr enhanced-history distribution-statistics 2 
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
2     900 1    2140200001 1   1   1     0     0          0          0          0       0         
2     900 2    2141100003 1   1   1     0     0          0          0          0       0         
2     900 3    2142000001 1   1   1     0     0          0          0          0       0         
2     900 4    2142900002 1   1   1     0     0          0          0          0       0         
2     900 5    2143800004 1   1   1     0     0          0          0          0       0         
2     900 6    2144700002 1   1   1     0     0          0          0          0       0         
2     900 7    2145600004 1   1   1     0     0          0          0          0       0         
2     900 8    2146500001 1   1   1     0     0          0          0          0       0         
2     900 9    2147400003 1   1   1     0     0          0          0          0       0         
2     900 10   2148300001 1   1   1     0     0          0          0          0       0         
2     900 11   2149200002 1   1   1     0     0          0          0          0       0         
2     900 12   2150100004 1   1   1     0     0          0          0          0       0         
2     900 13   2151000002 1   1   1     0     0          0          0          0       0         
2     900 14   2151900003 1   1   1     0     0          0          0          0       0         
2     900 15   2152800001 1   1   1     0     0          0          0          0       0         
 --More-- 

What to Do Next

If SAA data is to be passed to a CNS enabled router, you should perform the task in the "Enabling CNS for SAA Data Retrieval" section.

Configuring Monitoring of a ATM Circuit

ATM monitoring using SAA can be configured for an interface at the physical layer, for an interface at the data link layer, or for a specific circuit. The follow task describes configuring the SAA operation for a ATM circuit.

Restrictions

To enable full statistic gathering for the SAA ATM service level monitoring operation, the operation must be configured on both ends of the ATM connection.

Standard SAA distribution and history statistics are not supported in SLM operations; instead use the show enhanced history commands. Enhanced history data is stored as individual samples in each bucket. Aggregated (averaged) data for SLM operations is not available from the CLI.

SUMMARY STEPS

All steps are required unless otherwise indicated.

1. enable

2. configure terminal

3. atm-slm statistics

4. rtr operation-number

5. type slm atm pvc interface

6. enhanced history

7. exit

8. Repeat Steps 1 through 7 on the device at the far end of the connection.

9. rtr schedule

10. end

11. copy running-config startup-config (optional)

12. Allow statistics to be gathered for the desired amount of time.

13. show rtr operational-state (optional)

14. show rtr enhanced-history collection-statistics (optional)

15. show rtr enhanced-history distribution-statistics (optional)

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode.

Enter your password if prompted.

Step 2 

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 3 

atm-slm statistics

Example:

Router(config)# atm-slm statistics

Enables SAA to collect ATM performance monitoring statistics.

This command is required to begin gathering statistics for the ATM interface or circuit.

Step 4 

rtr operation-number

Example:

Router(config)# rtr 3

Specifies an identification number for the operation being configured, and enters SAA RTR configuration mode.

Step 5 

type slm atm pvc interface interface-id pvc-id

Example:
Router(config-rtr)# type slm atm pvc interface ATM0 
100/100


Specifies that the operation is an SLM ATM circuit operation, which provides data for the specified circuit, and specifies the interface that the operation should be run on.

The specified interface should be configured with a permanent virtual circuit (PVC) connection.

The ATM circuit statistics are used to monitor the basic health of a ATM circuit. This information includes some traffic counters, assorted error counts, and some performance related counters.

This command bring you into SAA SLM ATM Circuit configuration mode.

Step 6 

enhanced-history interval seconds buckets number-of-buckets

Example:

Router(config-rtr-slm-atm-pvc)# enhanced-history interval 900 buckets 100

Enables SAA enhanced history for the operation. Performance statistics are stored in "buckets" which keep the accumulated data separate from each other. Each bucket consists of data accumulated over the specified interval. For ATM SLM and ATM SLM operations, each bucket consists of 15 minutes (900 seconds) worth of statistics. The following line will be written to the configuration:

enhanced-history interval 900 buckets 100

Note Regardless of the values entered for seconds and number-of-buckets, the default of value of a 900 second interval and 100 history buckets will be used. Your input is overridden in the ATM operations so that complete SLM statistics can be provided.

Step 7 

exit

Example:

Router(config-rtr)# exit

Exits SAA SLM FR Circuit configuration mode.

Step 8 

Repeat Steps 1 through 7 on the device at the far end of the connection.

Step 9 

rtr schedule operation-number {start-time {hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss} [ageout seconds] [life {forever | seconds}]

Example:

Router(config)# rtr schedule 3 start-time now life forever

Specifies when the operation should start.

This step, unlike Steps 1 through 7, only has to be performed on one end of the ATM connection.

Step 10 

end

Example:

Router(config)# end

(Optional) Ends the current configuration session.

Step 11 

copy running-config startup-config

or

copy system:running-config nvram:startup-config 
Example:

Router# copy running-config startup-config

(Optional) Saves the configuration to NVRAM.

Step 12 

Allow statistics to be gathered for the desired amount of time.

Step 13 

show rtr operational-state operation-number

Example:

Router# show rtr operation 3


(Optional) Displays the state of the operation and the statistics for the last probe operation.

Step 14 

show rtr enhanced-history collection-statistics operation-number

Example:

Router# show rtr enhanced-history collection-statistics 3


(Optional) Displays data for all collected history buckets for the specified SAA operation with failure data for each bucket.

Because this command displays statistics per bucket, and SLM operations are configured for 100 buckets, this command may generate a large amount of output. To escape back to the command line, use Ctrl-Z.

Step 15 

show rtr enhanced-history distribution-statistics operation-number

Example:

Router# show rtr enhanced-history distribution-statistics 3



(Optional) Displays enhanced history data for all collected buckets in a summary table.

Because the enhanced history aggregation interval is fixed at 900 seconds for SLM operations, the optional interval keyword available for this command will not work for SLM operations.

Examples

Router> enable 
Password:
Router# configure terminal 
Enter configuration commands, one per line.
Router(config)# atm-slm statistics 
Router(config)# rtr 3
Router(config-rtr)# type slm atm pvc interface ATM0 100/100 
Router(config-rtr-slm-atm-dlci)# enhanced-history interval 900 buckets 100 
Router(config-rtr-slm-atm-dlci)# exit 
Router(config)# rtr schedule 3 start-time now life forever 
Router(config)# end 
Router#
Router# show rtr configuration 3 | include Type 
Type of operation to perform: Slm Atm Pvc
Reaction Type: None

Router# show rtr operational-state 3 
Entry number: 3
Modification time: *00:12:35.686 UTC Thur May 1 2003
Number of operations attempted: 276
Number of operations skipped: 277
Current seconds left in Life: Forever
Operational state of entry: Active
Last time this entry was reset: Never
Connection loss occurred: FALSE
Timeout occurred: FALSE
Over thresholds occurred: FALSE
Latest RTT (milliseconds): 16
Latest operation start time: *21:07:29.988 UTC Sat May 3 2003
Latest operation return code: OK

Sample Index = 277

Echo Receive Time = *00:22:30.005 UTC Thur May 1 2003
Echo Response Time = 21 (ms)
Remote IP Address     : 14.1.1.1        Remote Product Id     : 2198864392
Remote Interface Type : 32              Remote Interface Index: 11
Remote Circuit Index  : 111

Offered Frames/PDUs   : 2               Delivered Frames/PDUs: 2
Tx Total Frames:  2                        Rx Total Frames:  2              
Tx Total Octets:  60                       Rx Total Octets:  70             
Tx DeFrames:  0                            Rx DeFrames:  0              
Tx MaxThroughput:  448                     Rx MaxThroughput:  528            
Rx FecnSeconds:  0                         Rx BecnSeconds:  0              
OctetsAboveCIR:  0                         FramesAboveCIR:  0              
Unavailable Seconds:  0              

Tx Burst Percent1(sec):  900               Tx Burst Percent2(sec): 0
Tx Burst Percent3(sec):  0                 Tx Burst Percent4(sec): 0
Tx Burst Percent5(sec):  0      


Router# show rtr enhanced-history collection-statistics 3 
Entry number: 3
Aggregation Interval: 900
!-----------------------------------------------------!
Bucket Index: 1
Aggregation start time 21:37:29.988 UTC Fri May 2 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


Sample Index = 183

Echo Receive Time = *00:22:30.006 UTC Thur May 1 2003
Echo Response Time = 21 (ms)
Remote IP Address     : 14.1.1.1        Remote Product Id     : 2198864392
Remote Interface Type : 32              Remote Interface Index: 11
Remote Circuit Index  : 111

Offered Frames/PDUs   : 2               De