The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter contains the following sections:
Top-N reports allows you to collect and analyze data for each interface on a switch. The statistics for each port are sorted by one of the statistic types that are listed in the following table.
Statistic Type | Definition |
---|---|
broadcast |
Number of input/output broadcast packets |
bytes |
Number of input/output bytes |
multicast |
Number of input/output multicast packets |
drops |
Number of drops |
packets |
Number of input/output packets |
utilization |
Utilization |
When you enter the collect top command, processing begins and the system prompt reappears immediately. When processing completes, the reports are not displayed immediately on the screen; the reports are saved for later viewing. The Top-N reports notify you when the reports are complete by sending a syslog message to the screen.
To view the completed reports, enter the show top counters interface report command. Only completed reports are displayed. For reports that are not completed, there is a short description of the process information.
To terminate a Top-N reports process, enter the clear top counters interface report command. Pressing Ctrl-C does not terminate Top-N reports processes. The completed reports remain available for viewing until you remove them by entering the clear top counters interface report{ all report_num } command.
When enabling Top-N reports creation, note the following information:
This example shows how to collect interface statistics for Top-N reports for an interval of 76 seconds for the four ports with the highest utilization:
switch# collect top 4 counters interface all sort-by utilization interval 76
You can use this procedure to display Top-N reports. Top-N reports statistics are not displayed in the following situations:
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | switch(config)# show top counters interface report | Displays Top-N reports.
|
||
Step 2 | switch(config)# show top counters interface report [report_num] | Displays Top-N reports for a specific report number. |
This example shows how to display information about all the Top-N reports:
switch# show top counters interface report
This example shows how to display information about a specific Top-N report:
switch# show top counters interface report 1
You can use this procedure to clear Top-N reports.
Command or Action | Purpose | |
---|---|---|
Step 1 | switch(config)# clear top counters interface report {all|rep_num } | Clears all the Top-N reports. You can specify a particular report or you can use all to clear all reports. You can also use this command to cancel a report which is being collected. |
This example shows how to remove Top-N reports:
switch# clear top counters interface report 4