netqtop(8) System Manager's Manual netqtop(8)

# [NAME](#NAME)

netqtop - Summarize PPS, BPS, average size of packets and packet counts ordered by packet sizes on each queue of a network interface.

# [SYNOPSIS](#SYNOPSIS)

**netqtop \[-n nic] \[-i interval] \[-t throughput]**

# [DESCRIPTION](#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 kernel 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](#REQUIREMENTS)

CONFIG\_bpf and bcc

# [OPTIONS](#OPTIONS)

[-n NIC](#n)

Specify the network interface card

[-i INTERVAL](#i)

Print results every INTERVAL seconds. The default value is 1.

[-t THROUGHPUT](#t)

Print BPS and PPS of each queue.

# [EXAMPLES](#EXAMPLES)

[Account statistics of eth0 and output every 2 seconds:](#Account)

\# **netqtop -n eth0 -i 1**

# [OVERHEAD](#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](#SOURCE)

This is from bcc

https://github.com/iovisor/bcc

Also look in the bcc distribution for a netqtop\_example.txt file containing example usage, output and commentary for this tool.

# [OS](#OS)

Linux

# [STABILITY](#STABILITY)

Unstable - in development

# [AUTHOR](#AUTHOR)

Yolandajn

2020-07-30 USER COMMANDS

---

Document: netqtop(8) from bcc 0.37.0-r2 (Chainguard OS)
Source: https://github.com/iovisor/bcc