---
name: "netqtop-bpfcc"
section: "8"
platform: "linux"
package: "bpfcc-tools"
version: "0.31.0+ds-7"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/netqtop-bpfcc"
---

# netqtop-bpfcc(8)

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

## 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 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

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 containing example usage, output and commentary for this tool.

## OS

Linux

## STABILITY

Unstable - in development

## AUTHOR

Yolandajn