| ip stats set | 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 | 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. |
| group offloadsubgroups: | 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. |
| group xstatsandgroup xstats_slavesubgroups: | subgroup bridge [suite stp] [suite mcast] - Statistics for STP and, respectively, IGMP / MLD (under the keyword mcast) traffic on bridges and their slaves. subgroup bond [suite 802.3ad] - Statistics for LACP traffic on bond devices and their slaves. |
| group afstatssubgroups: | 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 |
NAME
ip-stats - manage and show interface statistics
SYNOPSIS
ipstats { COMMAND | help }
ip stats show [ devDEV ] [ groupGROUP [ subgroupSUBGROUP [ suiteSUITE ] ... ] ... ] ...
ip stats setdevDEVl3_stats { on | off }
DESCRIPTION
- ip stats set
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
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.
- group offloadsubgroups:
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.
- group xstatsandgroup xstats_slavesubgroups:
subgroup bridge [suite stp] [suite mcast] - Statistics for STP and, respectively, IGMP / MLD (under the keyword mcast) traffic on bridges and their slaves.
subgroup bond [suite 802.3ad] - Statistics for LACP traffic on bond devices and their slaves.
- group afstatssubgroups:
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
# ip stats show group offload
# ip stats show dev swp1 group link
SEE ALSO
ip(8), ip-link(8),
AUTHOR
Manpage by Petr Machata.