display counters top interface

Function

The display counters top interface command displays top N interface traffic statistics reports.

Format

display counters top interface report [ report-number ]

Parameters

Parameter	Description	Value
report-number	Specifies the number of a top N interface traffic statistics report. If you do not specify this parameter, the command output displays the summary information about all top N interface traffic statistics reports.	The value is an integer ranging from 1 to 5.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The collect counters top command generates top N interface traffic statistics reports, but does not display these reports. To view the generated reports, run the display counters top interface report [ report-number ] command.

Precautions

Before you run the display counters top interface report [ report-number ] command, ensure that a top N interface traffic statistics report has been generated using the collect counters top command. Otherwise, the "There is no TOPN interface counters report." message is displayed after you run the display counters top interface report [ report-number ] command.

Example

# Display the summary information about all top N interface traffic statistics reports.

<HUAWEI> display counters top interface report
Id Start Time                   Interval Number Sort-By   Status Interface-Type
-------------------------------------------------------------------------------
1  2012-09-05 09:03:13-08:00    30       20     bytes     doing  GigabitEthernet

**Table 1** Description of the **display counters top interface report** command output
Item	Description
Id	Indicates the number of a top N interface traffic statistics report.
Start Time	Indicates the start time of statistics collection.
Interval	Indicates the statistics collection interval.
Number	Indicates the number of busiest interfaces for which interface statistics reports are to be generated.
Sort By	Indicates the statistics type by which ports are determined to be the busiest, which can be: utilization: indicates to sort statistics by bandwidth utilization. bytes: indicates to sort statistics by the total number of bytes. packets: indicates to sort statistics by the total number of packets. multicast: indicates to sort statistics by the total number of multicast packets. broadcast: indicates to sort statistics by the total number of broadcast packets. errors: indicates to sort statistics by the total number of error packets. discards: indicates to sort statistics by the total number of dropped packets.
Status	Indicates the generation status of a top N interface traffic statistics report, which can be: doing: The report is being generated. done: The report has been generated.
Interface-Type	Indicates the type of interfaces for which the top N interface traffic statistics report is generated, which can be: all: indicates all interfaces. layer-2: indicates Layer 2 interfaces. layer-3: indicates Layer 3 interfaces. Specified interface type: indicates Ethernet physical interfaces or Eth-Trunk interfaces.

# Display the detailed information about the top N interface traffic statistics report numbered 1.

<HUAWEI> display counters top interface report 1
Owner             : RT1(10.1.1.1)                                                                                               
Start Time        : 2012-09-17 13:26:06
End Time          : 2012-09-17 13:26:36
Interface Type    : GigabitEthernet                                                                                                 
Sort By           : bytes                                                                                                           
Interval          : 30 seconds 
Port       Band  Util Bytes      Packets    Broadcast  Multicast  Error Discards                                                    
           width      (In + Out) (In + Out) (In + Out) (In + Out)                                                                   
-------  ----- ------ ---------- ---------- ---------- ---------- ----- --------                                                    
GE0/0/1   1000M   0% 974        4          0          4          0     0

**Table 2** Description of the **display counters top interface report 1** command output
Item	Description
Owner	Indicates the device on which the top N interface traffic statistics report is generated.
Start Time	Indicates the start time of statistics collection.
End Time	Indicates the end time of statistics collection.
Interface Type	Indicates the type of interfaces for which the top N interface traffic statistics report is generated, which can be: all: indicates all interfaces. layer-2: indicates Layer 2 interfaces. layer-3: indicates Layer 3 interfaces. Specified interface type: indicates Ethernet physical interfaces or Eth-Trunk interfaces.
Sort By	Indicates the statistics type by which ports are determined to be the busiest, which can be: utilization: indicates to sort statistics by bandwidth utilization. bytes: indicates to sort statistics by the total number of bytes. packets: indicates to sort statistics by the total number of packets. multicast: indicates to sort statistics by the total number of multicast packets. broadcast: indicates to sort statistics by the total number of broadcast packets. errors: indicates to sort statistics by the total number of error packets. discards: indicates to sort statistics by the total number of dropped packets.
Interval	Indicates the statistics collection interval.
Port	Indicates the interface name.
Band width	Indicates interface bandwidth.
Util	Indicates bandwidth utilization.
Bytes	Indicates the total number of sent and received bytes.
Packets	Indicates the total number of sent and received packets.
Multicast	Indicates the total number of sent and received multicast packets.
Broadcast	Indicates the total number of sent and received broadcast packets.
Error	Indicates the total number of error packets.
Discards	Indicates the total number of dropped packets.