---
name: "ip-stats"
section: "8"
platform: "linux"
package: "iproute2"
version: "7.3.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/ip-stats"
---

# ip-stats(8)

manage and show interface statistics

## NAME

ip-stats - manage and show interface statistics

## SYNOPSIS

**ip** **stats**  { *COMMAND* \|  **help** }

**ip stats show** \[ **dev** *DEV* \]  \[ **group** *GROUP* \[  **subgroup** *SUBGROUP*  \[ **suite**  *SUITE* \] ... \] ... \] ...

**ip stats set** **dev** *DEV* **l3\_stats** {  **on** \| **off** }

## DESCRIPTION

- **ip stats set**

  is used for toggling whether a certain HW statistics suite is collected on a given netdevice. The following statistics suites are supported:

  **l3\_stats** L3 stats reflect traffic that takes place in a HW device on an object that corresponds to the given software netdevice.

- **ip stats show** **group offload** subgroups: **group xstats** and **group xstats\_slave** subgroups: **group afstats** subgroups:

  is used for showing stats on a given netdevice, or dumping statistics across all netdevices. By default, all stats are requested. It is possible to filter which stats are requested by using the **group** and **subgroup** keywords.

  It is possible to specify several groups, or several subgroups for one group. When no subgroups are given for a group, all the subgroups are requested.

  The following groups are recognized:

  **group link** - Link statistics. The same suite that "ip -s link show" shows.

  **group offload** - A group that contains a number of HW-oriented statistics. See below for individual subgroups within this group.

  **group xstats** - Extended statistics. A subgroup identifies the type of netdevice to show the statistics for.

  **group xstats\_slave** - Extended statistics for the slave of a netdevice of a given type. A subgroup identifies the type of master netdevice.

  **group afstats** - A group for address-family specific netdevice statistics.

  **subgroup cpu\_hit** - The **cpu\_hit** statistics suite is useful on hardware netdevices. The **link** statistics on these devices reflect both the hardware- and software-datapath traffic. The **cpu\_hit** statistics then only reflect software-datapath traffic.

  **subgroup hw\_stats\_info** - This suite does not include traffic statistics, but rather communicates the state of other statistics. Through this subgroup, it is possible to discover whether a given statistic was enabled, and when it was, whether any device driver actually configured its device to collect these statistics. For example, **l3\_stats** was enabled in the following case, but no driver has installed it:

  \# ip stats show dev swp1 group offload subgroup hw\_stats\_info\
   56: swp1: group offload subgroup hw\_stats\_info\
  \
       l3\_stats on used off

  After an L3 address is added to the netdevice, the counter will be installed:

  \# ip addr add dev swp1 192.0.2.1/28\
   \# ip stats show dev swp1 group offload subgroup hw\_stats\_info\
   56: swp1: group offload subgroup hw\_stats\_info\
  \
       l3\_stats on used on

  **subgroup l3\_stats** - These statistics reflect L3 traffic that takes place in HW on an object that corresponds to the netdevice. Note that this suite is disabled by default and needs to be first enabled through **ip stats set.**

  For example:

  \# ip stats show dev swp2.200 group offload subgroup l3\_stats\
   112: swp2.200: group offload subgroup l3\_stats on used on\
  \
       RX:  bytes packets errors dropped   mcast\
  \
             8900      72      2       0       3\
  \
       TX:  bytes packets errors dropped\
  \
             7176      58      0       0

  Note how the l3\_stats\_info for the selected group is also part of the dump.

  **subgroup bridge - Various statistics on bridges and their slaves.**

  **suite stp** - STP statistics\
   **suite mcast** - IGMP / MLD statistics\
   **suite vlan** - per-VLAN traffic statistics\

  **subgroup bond \[ suite 802.3ad \]** - Statistics for LACP traffic on bond devices and their slaves.

  **subgroup mpls** - Statistics for MPLS traffic seen on the netdevice. For example:

  \# ip stats show dev veth01 group afstats subgroup mpls\
   3: veth01: group afstats subgroup mpls\
  \
       RX: bytes packets errors dropped noroute\
  \
               0       0      0       0       0\
  \
       TX: bytes packets errors dropped\
  \
             216       2      0       0

## EXAMPLES

\# ip stats set dev swp1 l3\_stats on

Enables collection of L3 HW statistics on swp1.

\# ip stats show group offload

Shows all offload statistics on all netdevices.

\# ip stats show dev swp1 group link

Shows link statistics on the given netdevice.

## SEE ALSO

[**ip**(8)](/ip/8.md), [**ip-link**(8)](/ip-link/8.md),

## AUTHOR

Manpage by Petr Machata.