1netqtop(8)                  System Manager's Manual                 netqtop(8)
2
3
4

NAME

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

SYNOPSIS

10       netqtop [-n nic] [-i interval] [-t throughput]
11

DESCRIPTION

13       netqtop accounts statistics of both transmitted and received packets on
14       each queue of a specified network interface to help developers check if
15       its traffic load is balanced.  The result is displayed as a table  with
16       columns  of  PPS,  BPS, average size and packet counts in range [0,64),
17       [64, 5120), [512, 2048), [2048, 16K),  [16K,  64K).   This  is  printed
18       every given interval (default 1) in seconds.
19
20       The tool uses the net:net_dev_start_xmit and net:netif_receive_skb ker‐
21       nel tracepoints.  Since it uses tracepoint,  the  tool  only  works  on
22       Linux 4.7+.
23
24       netqtop introduces significant overhead while network traffic is large.
25       See OVERHEAD section below.
26
27

REQUIREMENTS

29       CONFIG_bpf and bcc
30

OPTIONS

32       -n NIC Specify the network interface card
33
34       -i INTERVAL
35              Print results every INTERVAL seconds.  The default value is 1.
36
37       -t THROUGHPUT
38              Print BPS and PPS of each queue.
39

EXAMPLES

41       Account statistics of eth0 and output every 2 seconds:
42              # netqtop -n eth0 -i 1
43

OVERHEAD

45       In performance test, netqtop introduces a overhead up to 30%  PPS  drop
46       while  printing interval is set to 1 second. So be mindful of potential
47       packet drop when using this tool.
48
49       It also increases ping-pong latency by about 1 usec.
50

SOURCE

52       This is from bcc
53
54              https://github.com/iovisor/bcc
55
56       Also look in the bcc distribution for a netqtop_example.txt  file  con‐
57       taining example usage, output and commentary for this tool.
58

OS

60       Linux
61

STABILITY

63       Unstable - in development
64

AUTHOR

66       Yolandajn
67
68
69
70USER COMMANDS                     2020-07-30                        netqtop(8)
Impressum