STANNIX Solutions for the Real World


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)