Skip to content
Ethernet NIC Queue stats viewer
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
tests Amazon ENA support Oct 29, 2018
COPYRIGHT initial commit Sep 24, 2018
LICENSE initial commit Sep 24, 2018
Makefile strip output binary Oct 30, 2018
README.md README.md: correct driver name Oct 29, 2018
drv_amazon.cc Amazon ENA support Oct 29, 2018
drv_bcm.cc added Broadcom bnx2 support Oct 28, 2018
drv_emulex.cc remove need to use std::regex explicitly in constructor Oct 22, 2018
drv_generic.cc support generic fallback Oct 25, 2018
drv_intel.cc remove need to use std::regex explicitly in constructor Oct 22, 2018
drv_mellanox.cc
drv_virtio.cc
drv_vmware.cc allow separate accumulation of totals Oct 19, 2018
ethq.cc make it easier to customise the display interval Feb 4, 2019
ethq_test.cc allow separate accumulation of totals Oct 19, 2018
ethtool++.cc refactored output code Oct 1, 2018
ethtool++.h refactored output code Oct 1, 2018
interface.cc refactor offset calculation, typos Oct 30, 2018
interface.h refactor offset calculation, typos Oct 30, 2018
optval.h allow values to be unset Oct 19, 2018
parser.cc remove need to use std::regex explicitly in constructor Oct 22, 2018
parser.h remove need to use std::regex explicitly in constructor Oct 22, 2018
util.cc initial commit Sep 24, 2018
util.h initial commit Sep 24, 2018

README.md

EthQ

Displays an auto-updating per-second count of the number of packets and bytes being handled by each specified NIC, and on multi-queue NICs shows the per-queue statistics too.

Usage: ethq [-g] [-t] <interface> [interface ...].

With -t specified the display just scrolls on the terminal, otherwise it runs in an auto-refreshing window.

For information about the -g flag see "NIC Support", below.

Requirements

This software only runs on Linux. It requires a C++11 compiler and the NCurses library.

NIC Support

The format of the names of the statistics values from a NIC is highly driver specific.

The code currently supports the output from the following NIC drivers:

  • Broadcom bnx2, bnx2x, tg3
  • Emulex be2net
  • Intel e1000e, igb, ixgbe, i40e
  • Mellanox mlx5_core
  • RealTek r8169
  • Virtio virtio_net
  • VMware vmxnet3

The -g flag allows for fallback to a generic driver that knows how to parse statistics in this format:

rx_packets: 567425
tx_packets: 274383
rx_bytes: 703224479
tx_bytes: 31313190

To request support for additional NICs, please raise a github issue and include the output of ethtool -i and attach the output of ethtool -S for your interface.

You can’t perform that action at this time.