netqtop(8) System Manager's Manual netqtop(8)
NAME
netqtop - Summarize PPS, BPS, average size of packets and packet counts
ordered by packet sizes on each queue of a network interface.
SYNOPSIS
netqtop [-n nic] [-i interval] [-t throughput]
DESCRIPTION
netqtop accounts statistics of both transmitted and received packets on
each queue of a specified network interface to help developers check if
its traffic load is balanced. The result is displayed as a table with
columns of PPS, BPS, average size and packet counts in range [0,64),
[64, 5120), [512, 2048), [2048, 16K), [16K, 64K). This is printed
every given interval (default 1) in seconds.
The tool uses the net:net_dev_start_xmit and net:netif_receive_skb ker-
nel tracepoints. Since it uses tracepoint, the tool only works on
Linux 4.7+.
netqtop introduces significant overhead while network traffic is large.
See OVERHEAD section below.
REQUIREMENTS
CONFIG_bpf and bcc
OPTIONS
-n NIC Specify the network interface card
-i INTERVAL
Print results every INTERVAL seconds. The default value is 1.
-t THROUGHPUT
Print BPS and PPS of each queue.
EXAMPLES
Account statistics of eth0 and output every 2 seconds:
# netqtop -n eth0 -i 1
OVERHEAD
In performance test, netqtop introduces a overhead up to 30% PPS drop
while printing interval is set to 1 second. So be mindful of potential
packet drop when using this tool.
It also increases ping-pong latency by about 1 usec.
SOURCE
This is from bcc
https://github.com/iovisor/bcc
Also look in the bcc distribution for a netqtop_example.txt file con-
taining example usage, output and commentary for this tool.
OS
Linux
STABILITY
Unstable - in development
AUTHOR
Yolandajn
USER COMMANDS 2020-07-30 netqtop(8)
Generated by dwww version 1.16 on Tue Dec 16 17:12:38 CET 2025.