39-2
Catalyst 6000 Family Software Configuration Guide—Releases 6.3 and 6.4
78-13315-02
Chapter 39 Using Switch TopN Reports
Understanding How the Switch TopN Reports Utility Works
The Switch TopN Reports utility collects the following data for each physical port:
•
Port utilization (
util
)
•
Number of in/out bytes (
bytes
)
•
Number of in/out packets (
pkts
)
•
Number of in/out broadcast packets (
bcst
)
•
Number of in/out multicast packets (
mcst
)
•
Number of in errors (
in-errors
)
•
Number of buffer-overflow errors (
buf-ovflw
)
When the Switch TopN Reports utility starts, it gathers data from the appropriate hardware counters, and
then goes into sleep mode for a user-specified period. When the sleep time ends, the utility gathers the
current data from the same hardware counters, compares the current data from the earlier data, and stores
the difference. The data for each port is sorted using a user-specified metric chosen from the values
shown in
Table 39-1
.
Running Switch TopN Reports without the Background Option
If you enter the
show top
command without specifying the
background
option, processing begins but
the system prompt does not reappear on the screen and you cannot enter other commands while the report
is being generated.
You can terminate the Switch TopN process before it finishes by pressing
Ctrl-C
from the same console
or Telnet session, or by opening a separate console or Telnet session and entering the
clear top
[
report_num
] command. After the Switch TopN Reports utility finishes processing the data, it displays
the output on the screen immediately. The output is not saved.
Running Switch TopN Reports with the Background Option
If you enter the
show top
command and specify the
background
option, processing begins and the
system prompt reappears immediately. When processing completes, the reports do not display
immediately on the screen, but are saved for later viewing.
The system notifies you when the reports are complete by sending a syslog message to the screen. Enter
the
show top report
[
report_num
] command to view the completed reports. The system displays only
those reports that are completed. For reports that are not completed, the system displays a short
description of the Switch TopN process information.
Table 39-1 Valid Switch TopN Reports Metric Values
Metric Value
Definition
util
Utilization
bytes
Input/output bytes
pkts
Input/output packets
bcst
Input/output broadcast packets
mcst
Input/output multicast packets
errors
Input errors
overflow
Buffer overflows
