display counters

Function

The display counters command displays traffic statistics on interfaces.

The display counters rate command displays traffic rates on interfaces.

Format

display counters [ bit ] [ rate ] [ inbound | outbound ] [ interface { interface-name | interface-type [ interface-number ] } ]

display counters [ bit ] [ rate ] [ inbound | outbound ] [ interface interface-type ] slot slot-id

Parameters

Parameter	Description	Value
rate	Indicates the packet rate, which is calculated based on interface counters. If the packet rate is not specified, interface counters of specified interfaces will be listed.	-
inbound	Indicates statistics and traffic rate about incoming traffic.	-
outbound	Indicates statistics and traffic rate about outgoing traffic.	-
interface interface-type interface-number	Specifies the type of an interface.	-
slot slot-id	Specifies the slot ID of an interface board.	-
bit	Displays traffic rates by bits/s. The traffic statistics can be displayed only on Ethernet interfaces, Ethernet sub-interfaces, Eth-Trunk interfaces, and Eth-Trunk sub-interfaces, not on remote Eth-Trunk interfaces.	-
interface-name	Specifies the name of an interface.	The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
interface-mgr	read

Usage Guidelines

Usage Scenario

To check statistics about traffic sent or received by an interface, run the display counters command with an interface type or slot ID specified. The command output helps you locate and rectify a fault.

If you want to check traffic statistics about an interface within a specified period, run the reset counters interface command to delete existing statistics on the interface. Then, you can re-collect traffic statistics about the interface.

To view incoming or outgoing traffic rates on an interface, run the display counters rate command with an interface type or slot ID specified. The command output helps you locate and rectify a fault.

If you want to check traffic rates on an interface within a specified period, run the reset counters interface command to delete existing statistics on the interface. Then, you can recalculate traffic rates on the interface.

Precautions

If a large number of interfaces exist on the device, specify an interface number or a slot ID in the display counters command to view traffic statistics on a specified interface. Otherwise, excessive output information may cause the following problems:

The output information is repeatedly refreshed, and then required information cannot be obtained.
The system does not respond because of long-time information traversing and searching.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the traffic rate on GE 0/1/0.

<HUAWEI> display counters rate interface gigabitethernet 0/1/0
Inbound
Interface   Octets(bytes/s) Unicast(pkts/s) Multicast(pkts/s) Broadcast(pkts/s)
GE0/1/0                   0               0                 0                 0
Outbound
Interface   Octets(bytes/s) Unicast(pkts/s) Multicast(pkts/s) Broadcast(pkts/s)
GE0/1/0                   0               0                 0                 0

# Display traffic rates on all interfaces on a device.

<HUAWEI> display counters rate
Inbound
Interface   Octets(bytes/s) Unicast(pkts/s) Multicast(pkts/s) Broadcast(pkts/s)
Eth-Trunk2                0               0                 0                 0
GE0/1/0                   0               0                 0                 0
Loop1                     0               0                 0                 0
NULL0                     0               0                 0                 0
Outbound
Interface   Octets(bytes/s) Unicast(pkts/s) Multicast(pkts/s) Broadcast(pkts/s)
Eth-Trunk2                0               0                 0                 0
GE0/1/0                   0               0                 0                 0
Loop1                     0               0                 0                 0
NULL0                     0               0                 0                 0

# Display traffic statistics by bit.

<HUAWEI> display counters bit
Inbound
Interface           Unicast(bits) Multicast(bits) Broadcast(bits)
GE0/1/0                         0               0               0
GE0/1/1                         0           66168               0
GE0/1/2                   2168736            4552           52784 
GE0/1/3                         0               0               0
Outbound        
Interface           Unicast(bits) Multicast(bits) Broadcast(bits)
GE0/1/0                         0               0               0
GE0/1/1                         0               0               0
GE0/1/2                3821688246             432             768
GE0/1/3                         0               0               0

# Display traffic statistics about GE 0/1/0.

<HUAWEI> display counters interface gigabitethernet 0/1/0
Inbound
Interface           Octets(bytes) Unicast(pkts) Multicast(pkts) Broadcast(pkts)
GE0/1/0                         0          7629           41914         2768376
Outbound
Interface           Octets(bytes) Unicast(pkts) Multicast(pkts) Broadcast(pkts)
GE0/1/0                         0         46800               0             712

# Display traffic rates by bits/s.

<HUAWEI> display counters bit rate
Inbound
Interface   Unicast(bits/s) Multicast(bits/s) Broadcast(bits/s)
Eth-Trunk2                0             52784                 0
GE                  2168736              4552           2168736
Outbound
Interface   Unicast(bits/s) Multicast(bits/s) Broadcast(bits/s)
Eth-Trunk2       3821688246               432              9968
GE                 18569246                 0                 0

# Display traffic statistics about all interfaces on a device.

<HUAWEI> display counters
Inbound
Interface           Octets(bytes) Unicast(pkts) Multicast(pkts) Broadcast(pkts)
Eth-Trunk2                      0             0               0               0
GE0/1/0                         0          6860           39961         2697089
Loop1                           0             0               0               0
NULL0                           0             0               0               0
Outbound
Interface           Octets(bytes) Unicast(pkts) Multicast(pkts) Broadcast(pkts)
Eth-Trunk2                      0             0               0               0
GE0/1/0                         0         44910               0             702
Loop1                           0             0               0               0
NULL0                           0             0               0               0

**Table 1** Description of the **display counters** command output
Item	Description
Inbound	Statistics about traffic received by an interface.
Interface	Name and number of an interface.
Octets(bytes/s)	Incoming and outgoing traffic rates, in bytes/s.
Unicast(pkts/s)	Incoming and outgoing unicast packet rates, in pkts/s.
Multicast(pkts/s)	Incoming and outgoing multicast packet rates, in pkts/s.
Broadcast(pkts/s)	Incoming and outgoing broadcast packet rates, in pkts/s.
Outbound	Statistics about traffic sent by an interface.
Unicast(bits)	Total number of incoming and outgoing unicast packets, in bits.
Multicast(bits)	Total number of incoming and outgoing multicast packets, in bits.
Broadcast(bits)	Total number of incoming and outgoing broadcast packets, in bits.
Octets(bytes)	Total number of incoming and outgoing bytes.
Unicast(pkts)	Total number of incoming and outgoing unicast packets, in pkts.
Multicast(pkts)	Total number of incoming and outgoing multicast packets, in pkts.
Broadcast(pkts)	Total number of incoming and outgoing broadcast packets, in pkts.
Unicast(bits/s)	Incoming and outgoing unicast packet rates, in bits/s.
Multicast(bits/s)	Incoming and outgoing multicast packet rates, in bits/s.
Broadcast(bits/s)	Incoming and outgoing broadcast packet rates, in bits/s.