IP-STATS(8)

💖 IP-STATS(8) 💖

okay bestie, welcome to ip-stats, straight out of the iproute2 crew, sitting pretty in section 8 of the Linux manuals. this is the one that handles interface statistics — showing them, managing them, the whole vibe. let's get into it 🫶

---

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

so this one is for toggling whether a certain HW statistics suite gets collected on a given netdevice. it's giving on/off switch energy, no cap.

these are the statistics suites that 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. literally the L3 traffic, mirrored onto your soft netdev. slay.

ip stats show 👑

this is for showing stats on a given netdevice, or dumping statistics across all netdevices. by default, all stats are requested — it wants everything, main character energy fr fr. but you can filter which stats get requested by using the group and subgroup keywords.

you can also specify several groups, or several subgroups for one group. and here's the tea: when no subgroups are given for a group, all the subgroups are requested. generous of it honestly 💅

these are the groups it recognizes:

• group link — Link statistics. the same suite that ip -s link show shows. yes, that one.
• group offload — a group that contains a number of HW-oriented statistics. see below for the individual subgroups hanging out inside 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.

🎀 group offload subgroups 🎀

• 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. so it's the lil slice of truth underneath 🍓
• subgroup hw_stats_info — this suite does not include traffic statistics, it's more of a vibe check 👀 — it communicates the state of other statistics. through this subgroup, it's 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

see?? used off becomes used on. character development 💖

• 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. do not skip that step bestie, it will not work 🙈

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. it just comes along, it's invited 🎀

🌈 group xstats and group xstats_slave subgroups 🌈

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

⭐ group afstats subgroups ⭐

• 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. turning it ON bestie ✨
• # ip stats show group offload — shows all offload statistics on all netdevices. everything, everywhere, all at once 🫶
• # ip stats show dev swp1 group link — shows link statistics on the given netdevice. just the one. focused. iconic.

---

👀 SEE ALSO 👀

ip(8), ip-link(8),

---

🎀 AUTHOR 🎀

Manpage by Petr Machata. thank you king 👑

---

and that's the whole page bestie, no notes 💖

okay so this little masterpiece lives in iproute2 and it's dated 16 Mar 2022 — go forth and read your stats, you've absolutely got this 🦋🌸✨