Banner
HomeTOCPrevNextGlossSearchHelp

PDF

Table of Contents

Statistics and Data Collection

Statistics and Data Collection

Statistics and Data Collection

Statistics are counters collected by a LightStream 2020 (LS2020) enterprise ATM switch. This chapter tells you how to monitor and evaluate the state and performance of your LightStream switch by reviewing and sometimes processing the statistics.


Viewing Lightstream 2020 Statistics

LS2020 statistics are stored in MIB objects. Examples of statistics include the following MIB objects:

Many statistics of interest for the LS2020 switch are defined in some of the standard MIBs and the LS2020 private MIB. For a list of standard MIBs and information on the LS2020 private MIB, see the LightStream 2020 CLI Reference Manual.

All statistics in an LS2020 switch are initialized at system startup. When they reach their maximum value (or if you do another startup), they are reset to 0. You can use the collector to collect statistics at regular intervals.


Viewing Port Statistics

To view port statistics, use the show command. All of the information displayed for port interfaces is generic and applies to all interfaces, regardless of the interface type.

Step 1 Verify that the target switch is set correctly by entering the following at the cli> prompt:


cli> show snmp

If you need instructions on changing the target switch, see the "Setting the Target Switch for CLI Commands" section in the chapter entitled "The Command Line Interface."

Step 2 Enter the following at the cli> prompt:


cli> show port <port#> statistics

where

<port#> = The number of the port for which statistics is displayed. The port number is in card.port format (card = 2 - 10; port = 0 - 7).

Figure 7-1 is an example of the information that displays when you enter show port 2.0 statistics

Figure 7-1 : Sample Port Statistics Display

h3378.gif

where

Octets Rcvd = Total octets received from the media

Normal Packets Rcvd = Number of unicast packets delivered (a portion of the total)

Multicast Packets Rcvd = Number of broadcast/multicast packets delivered (a portion of the total)

Discarded Rcvd Packets = Packets from the switch discarded due to resource limitation

Receive Errors = Packets discarded due to format error

Unknown Protocols Rcvd = Packets destined for unknown protocols

Octets Sent = Total octets sent on the media

Normal Packets Sent = Number of unicast packets sent (a portion of the total)

Multicast Packets Sent = Number of broadcast/multicast packets sent (a portion of the total)

Discarded Output Packets = Packets discarded due to resource limitation

Output Errors = Packets discarded due to error

The first time you request statistics for a particular port, you see a display like the one shown in Figure 7-1. However, if you request statistics on that port again, the current value of each statistic displays with additional information. The additional information shows the amount that each statistic increased since your last request and the rate at which the statistic is changing. Figure 7-2 shows an example of the statistics display that you receive when you enter show port 2.0 statistics anytime after the first time.

Figure 7-2 : Sample Subsequent port statistics Display

h3379.gif


Using Data Collection

The LS2020 switch provides a data collection facility called the collector. The collector allows you to define a set of MIB objects, collect their values at regular intervals, and save the information in a file. The set of MIB objects and their collected values is a collection.

The collector maintains a table called collectTable in the private section of the LS2020 MIB. It uses the information in this table to control the operations of its collections. Table 7-1 shows a sample collection table. Each row defines a collection.

Table 7-1 : Sample Collection Table

Collection
Number 		Collection Status Operational
Status 		Begin Time End Time Interval File Name File Size
1 Valid Running 10:00:00 1/4/95 11:00:00 1/4/95
60 collect.1 100
2 Under
creation 		Waiting 12:30:15 1/14/95 12:00
1/28/95
360 collect.2 100
75 Valid Running 00:01:00
4/2/95 		00:01:00
4/3/95 		3600 collect.75 50

You can use the begintime and endtime arguments to control the collection duration and the filesize argument to control the collection size. If you do not specify the begintime and endtime arguments, the collection runs continually.

The collector can run up to 25 collections simultaneously on a particular switch. If you attempt to start more than 25 collections, any additional collections have an operational status of waiting. When the number of running collections falls below 25, the next waiting collection begins running.

You can collect any set of MIB objects you want at various time intervals. For example, you can define a collection of ifInErrors and ifOutErrors objects for a particular set of ports to be collected once an hour or once a day. Once the collection starts, the specified information is collected at the correct interval and appended to the collection file.

The collector automatically generates the file and file name for every collection that you create. The file name is of the form collect.<collection number>. All collection files are placed in the /usr/tmp/collector directory. Sample names are /usr/tmp/collector/collect.6 and /usr/tmp/collector/collect.128.

Collection files are circular ASCII files containing the time each object was collected, the object name, and the object value. Figure 7-3 shows a sample collection file. When the circular file is full, the oldest data (including start date) is overwritten by newer data. Files are displayed in chronological order from the oldest entries to the newest. The default for the maximum file size is 100 Kbytes.

Figure 7-3 : Sample Collection File

h3380.gif

You can view and use the collection files as they are or you can process the data. (You may want to sort the data or make calculations to determine when changes in performance or state occur.)

You may want to perform these functions on your collections.

To begin a new collection, follow these procedures in the order listed below.

Each of these procedures is explained in the sections that follow.


Creating a Collection

These steps tell you how to create a collection. They set up a row in the collectTable object for a collection with the number you specify.

Step 1 Set the SNMP community to a read/write community by entering the following at the cli> prompt:


cli> set snmp community <community name>

where

<community name> = The name for the SNMP community with read/write privileges that you want to access.

Step 2 Enter the following at the cli> prompt:

cli> set collection <collection number> create

where

<collection number> = An integer between 1 and 128, inclusive.

Step 3 To verify that the collection has been created, enter the following at the cli> prompt:


cli> show collection <collection number>


Setting the Collection Interval

These steps show you how to set the time interval for collecting data for a particular collection.

Step 1 Set the SNMP community to a read/write community by entering the following at the cli> prompt:


cli> set snmp community <community name>

where

<community name> = The name for the SNMP community with read/write privileges that you want to access.

Step 2 Enter the following at the cli> prompt:


cli> set collection <collection number> frequency <interval>

where

<collection number> = The number of a collection for which you are setting the collection interval.

<interval> = The interval (in seconds) at which you want to collect the data. The default is 60 seconds. Table 7-2 lists the typical intervals that you may want set to collect the data.

Table 7-2 : Collection Interval Details

Typical Time Interval No. of Seconds in Interval
1 second 1 second
10 seconds 10 seconds
30 seconds 30 seconds
1 minute 60 seconds
5 minutes 300 seconds
10 minutes 600 seconds
15 minutes 900 seconds
30 minutes 1800 seconds
1 hour 3600 seconds
2 hours 7200 seconds
12 hours 43200 seconds
24 hours 86400 seconds
1 week 604800 seconds

Note If you set extremely short intervals to collect many objects, there is a noticeable difference in response time.

Step 3 To verify the collection interval for a particular collection, enter the following at the cli> prompt:


cli> show collection <collection number>

Check the information in the Collection Interval field.


Adding or Deleting Collection Objects

This procedure explains how to specify a MIB object and add or delete it from a collection. Each MIB object is added or deleted individually.


Adding Objects to a Collection

Step 1 Set the SNMP community to a read/write community by entering the following at the cli> prompt:


cli> set snmp community <community name>

where

<community name> = The name for the SNMP community with read/write privileges that you want to access.

Step 2 If you do not know which MIB objects are available for collection, use the browse or the walksnmp command (described in the "SNMP Commands" chapter) to list the objects that are available.

Step 3 To add MIB objects to a collection, enter the following at the cli> prompt:


cli> set collection <collection number> addvar <MIB address>

where

<collection number> = The number of a collection for which you are adding objects.

<MIB address> = The MIB name or address of the object you want to add to the collection. The MIB address must include the instance identifier as described in the "SNMP Commands" chapter.

For example, to collect the ifInOctets MIB object for ports 1 and 2 on card 3, enter the following at the cli> prompt:

cli> set collection 10 addvar ifInOctets.3001

cli> set collection 10 addvar ifInOctets.3002

Step 4 To verify that the object(s) you specified in step 3 are collected, enter the following from the cli> prompt:


cli> show collection <collection number>

Check the information in the Collection Items field. You should see the MIB object(s) listed that you added to the collection.


Deleting Objects from a Collection

Step 1 Set the SNMP community to a read/write community by entering the following at the cli> prompt:


cli> set snmp community <community name>

where

<community name> = The name for the SNMP community with read/write privileges that you want to access.

Step 2 To delete objects from a collection, enter the following from the cli> prompt:


cli> set collection <collection number> delvar <MIB address>

where

<collection number> = The number of a collection for which you are deleting objects.

<MIB address> = The MIB name or address of the object you want to delete from the collection.

Step 3 To display the current objects to be collected for the collection, enter the following from the cli> prompt:


cli> show collection <collection number>

Check the information in the Collection Items field. The MIB object you specified should not appear in the display.


Specifying Collection Size

To specify the size of a collection file, follow these steps.

Step 1 Set the SNMP community to a read/write community by entering the following at the cli> prompt:


cli> set snmp community <community name>

where

<community name> = The name for the SNMP community with read/write privileges that you want to access.

Step 2 Enter the following at the cli> prompt:


cli> set collection <collection number> filesize <size>

where

<collection number> = The number of a collection for which you are specifying the collection file size.

<size> = The size of the collection file in Kbytes. The default is 100 Kbytes. The actual file size is 100 x 1024 bytes.

Step 3 To display the size of the collection, enter the following from the cli> prompt:


cli> show collection <collection number>

Check the information in the Collection File Size.


Starting a Collection

Starting the collector causes the LightStream switch to collect the specified MIB objects (at the defined times) and store the data in the collection file. To start a collection, follow these steps.

Step 1 Set the SNMP community to a read/write community by entering the following at the cli> prompt:


cli> set snmp community <community name>

where

<community name> = The name for the SNMP community with read/write privileges that you want to access.

Step 2 Enter the following at the cli> prompt:

Step 3 cli> set collection <collection number> start


where

<collection number> = The number of a collection that you are starting.

Step 4 To confirm that the collection has been started, enter the following from the cli> prompt:


cli> show collection <collection number>

Look at the Collection Status field.

If the Collection Status field status is Valid, the collection has been started and is running. If the status is Waiting, you have more than 25 collections running on this switch, or the collection is scheduled to start at a future time.


Specifying Collection Start and End Times

This optional procedure tells you how to specify a start and end time for a collection.


Specifying Start Time

Step 1 Set the SNMP community to a read/write community by entering the following at the cli> prompt:


cli> set snmp community <community name>

where

<community name> = The name for the SNMP community with read/write privileges that you want to access.

Step 2 To specify the start time, enter the following from the cli> prompt:


cli> set collection <collection number> begintime <time>


where

<collection number> = The number of a collection for which you are specifying the start time.

<time> = The time when you want the collection to start. Enter the time in [[[yy:]mm:]dd:]hh:mm:ss format. The default is the current time and date.

Step 3 To determine collection start time, enter the following from the cli> prompt:


cli> show collection <collection number>

Look at the Start Time field.


Specifying End Time

Step 1 Set the SNMP community to a read/write community by entering the following at the cli> prompt:


cli> set snmp community <community name>


where

<community name> = The name for the SNMP community with read/write privileges that you want to access.

Step 2 To specify the stop time, enter the following from the cli> prompt:


cli> set collection <collection number> endtime <time>


where

<collection number> = The number of a collection for which you are specifying the end time.

<time> = The time when you want the collection to stop. Enter the time in [[[yy:]mm:]dd:]hh:mm:ss format. The default is the time when the LightStream system clock runs out (for example, Thu Dec 31 23:59:59 2037).


Viewing a Collection

You can view the collection file from the command line interface (CLI) or you can copy it to a third-party network management system (NMS) or workstation where you can view it or process it.

Two procedures can be used to view the collection from CLI. The first is used if you are running CLI on the network processor (NP) of the LightStream switch on which the collection is being run and the second is used if you are running CLI on a remote NP or Sun SPARCstation.

Note You must be in protected mode to view a collection if CLI is running from a remote NP or Sun SPARCstation, or if you are moving the collection file to a third-party NMS or workstation. See the chapter entitled "The Command Line Interface" for instructions on accessing protected mode. You must also have an account (user name and password) for the workstation or host to which you are moving the collection file. Your network administrator should provide you with this information.


Procedure 1: Viewing a Collection

Enter the following at the *cli> prompt: 

*cli> shell "cbufpr /usr/tmp/collector/collect.<collection#>"

For more information on the circular buffer print (cbufpr) command, see the chapter entitled "The Command Line Interface."


Procedure 2: Copying a Collection File for Viewing or Processing

Step 1 Enter the following at the cli> prompt:


cli> protected

Step 2 Enter the protected mode password when you see the following prompt:


Enter password:

Step 3 Enter the following at the *cli> prompt:


* cli> shell "ftp <name or address of workstation or host to which you want to move the collection file>"

The LightStream switch responds with a message similar to the following:

Connection to 127.1.41.22.
220 NMS1 FTP server (version 4.162 Tue Nov 1 10:50:37 PST 1988) ready.

Step 4 When you see the following prompt, enter the user name for the account on the workstation or host to which you are moving the collection file:


Name (127.1.41.22:<user name>):

Step 5 Enter the password for the account when you see the following prompt:


Password:

If you enter the user name and password correctly, the workstation or host displays information similar to the following:

230 User <user name> logged in.

ftp>

Step 6 Enter the following at the ftp> prompt:


ftp> put /usr/tmp/mma/collectIndex.8 [<new name>]

where

<new name> = The name of the file that identifies the chassis or appropriate directory name for the file. For example, if you are moving a trap log for a switch called Light5, the new name could be mma_Light5.traplog.

Step 7 To exit the file transfer program and return to CLI, enter bye or quit at the ftp> prompt:

Step 8 The put command sends the log file to the specified workstation or host. The system tells you when the transfer is complete.

You can use a standard UNIX command such as more or cat to view the collection file on the workstation or host. You can also use the text file with any text processing tool you have available.


Listing Defined Collections

To get a list of all defined collections and to determine the status and contents of any defined collection, follow these steps:

Step 1 Enter the following at the cli> prompt:


cli> show collection [<collection number>]

The numbers following the term Value: are the collection numbers that have been defined.

Step 2 Once you know the numbers of the collections that have been defined, you can determine the contents and status of each collection by typing the following from the cli> prompt:


cli> show collection [<collection number>]

If you do not enter a collection number, all collections are displayed.

The following is an example of the output that displays when you enter show collection 10:

cli> show collection 10
Collection Record 10:
Collection Status: Under Creation
Begin Time: Mon Aug 2 15:43 1995
Ending Time: Thu Dec 31 23:59:59 2037
Collection Interval: 30 sec
Collection File: /usr/tmp/collector/collect.10
Collection File Size: 100 KB

Collection Items:

Name: collectDBObjectID.10.1 Value: ifInOctets.3000
Name: collectDBObjectID.10.2 Value: ifInOctets.3001
Name: collectDBObjectID.10.2 Value: ifInOctets.3005
cli>


Stopping a Collection

To temporarily stop a collection, follow these steps.

Step 1 Set the SNMP community to a read/write community by entering the following at the cli> prompt:


cli> set snmp community <community name>

where

<community name> = The name for the SNMP community with read/write privileges that you want to access.

Step 2 Enter the following at the cli> prompt:


cli> set collection <collection number> halt

where

<collection number> = The number of a collection you are stopping.

Step 3 To determine if a collection has been stopped, enter the following from the cli> prompt:


cli> show collection <collection number>

If you restart this collection at a later time, new data is appended to the existing collection file.

The show collection <collection number> command displays the Collection Status field. If the status is Under Creation, the collection has been stopped.

If a collection has been restarted, the Collection Status changes from Under Creation to Valid.

If you have 25 collections running and you stop one or more of them, collections with a Collection Status of Waiting may be started as a result. (In this case, you may not be able to restart the collection you just stopped, unless you halt another collection.)


Deleting a Collection

The following steps tell you how to delete the definition of a collection.The procedure deletes the definition of the collection from the collecTable, but it does not delete the collection file itself. Once a collection is deleted, you can no longer restart it because its definition no longer exists.

Step 1 Set the SNMP community to a read/write community by entering the following at the cli> prompt:


cli> set snmp community <community name>

where

<community name> = The name for the SNMP community with read/write privileges that you want to access.

Step 2 Enter the following at the cli> prompt:


cli> set collection <collection number> del

where

<collection number> = The number of a collection to be deleted.

Step 3 To list the collection numbers that have been defined for this switch, enter the following from the cli> prompt:

cli> walksnmp collectIndex

The walksnmp collectIndex command displays the collection numbers that have been defined for this switch. The number that you deleted should not appear on this list.


Sample Collection Scenario

The following shows a list of commands used to create, define, and then start a collection. This sample collection is defined to collect the ifInErrors MIB object for two ports on card 1 and two ports on card 3 of the target LightStream switch. It is placed in /usr/tmp/collector/collect.2. The data is collected every hour starting when you issue the set collection start command and continuing until you stop it. (No end time has been defined.) 

cli> set collection 2 create


cli> set collection 2 frequency 3600


cli> set collection 2 addvar ifInErrors.1000


cli> set collection 2 addvar ifInErrors.1001


cli> set collection 2 addvar ifInErrors.3000


cli> set collection 2 addvar ifInErrors.3001


cli> set collection 2 start

You can view the collection file by following the instructions in the section "Procedure 1: Viewing a Collection." Figure 7-4 is a sample display of the collection file:

Figure 7-4 : Sample Display of a Collection File

h3382.gif

HomeTOCPrevNextGlossSearchHelp
-

Copyright 1988-1996 © Cisco Systems Inc.