STANNIX Community


Manual: netqtop-bpfcc

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

USER COMMANDS						 2020-07-30						  netqtop(8)