Information¶
Hardware statistics¶
The show interface hardware-statistics command is used to display and
set options related to network drivers (for those that support it).
To display the statistics for a given port, use
show interface hardware-statistics:
# show interface hardware-statistics
...
------------- iface1 -------------
rx_good_packets: 11246553
tx_good_packets: 11272871
rx_good_bytes: 3925735284
tx_good_bytes: 3925615259
rx_missed_errors: 0
rx_errors: 6
tx_errors: 0
rx_mbuf_allocation_errors: 0
rx_q0_packets: 11246553
rx_q0_bytes: 3925735284
rx_q0_errors: 0
tx_q0_packets: 11272871
tx_q0_bytes: 3925615259
...
rx_total_packets: 192087588
rx_total_bytes: 14776198828
tx_total_packets: 11272871
...
The most important stats to look at are the {r,t}x_good_{packets,bytes} and
errors such as {r,t}x_errors, rx_mbuf_allocation_errors, rx_missed_errors.
They indicate globally how well the port is handling packets.
There is also per queue statistics that might be interesting in case of multiqueue. It’s better to have packets transmitted on as many different queues as possible, but it depends on various factors, such as the IP addresses and UDP / TCP ports.
The drop statistics provide useful information about why packets are dropped.
For instance, the rx_missed_errors counter represents the number of packets
dropped because the CPU was not fast enough to dequeue them. A non-zero value
for rx_mbuf_allocation_errors shows that there is not enough mbuf structure configured
in the fast path.
Note
Statistics field names may vary considering the driver.
show interface hardware-features name <interface> can be used to check
whether offload is enabled, using the following:
vsr> show interface hardware-features name iface1
TX vlan insert off [fixed]
TX IPv4 checksum off [fixed]
TX TCP checksum off [fixed]
TX UDP checksum off [fixed]
TX SCTP checksum off [fixed]
TX TSO off [fixed]
TX UFO off [fixed]
RX vlan strip off
RX vlan filter off
RX IPv4 checksum on
RX TCP checksum on
RX UDP checksum on
RX MPLS IP off
RX LRO off
RX timestamp off
RX GRO off
If you want to list every features of every interface, you can just
use show interface hardware-features
If you want to enable TSO (which should provide you with better performance for TCP, as the hardware will handle the segmentation), use:
# fp-cli dpdk-port-offload-set eth1 tso on
Note
You can get various error messages when trying to change hardware parameters.
For instance, Cannot change tcp-segmentation-offload may appear if the
driver does not support to dynamically change TSO offload.
Note
The offload configuration is not synchronized between the tap interface in Linux and the fast path port. Thus, refer to fp-cli for displaying and modifying the hardware parameters, instead of Linux tools (i.e ethtool).
Hardware Topology¶
The troubleshooting-report command retrieves the hardware topology of the system. It gives informations about shared caches, CPU’s, processor cores, threads and much more.
The hardware topology can be found in the archive created by this command, in two formats:
XML version in
lstopo.xml(contains raw data in XML format).SVG version in
lstopo.svg(contains a schematic visual representation, can be opened with Firefox for example).
You can also use the show hardware command, to display informations about CPU,
RAM, NIC and disks.
vsr> show hardware
System serial number: 186DWY3
CPUs:
Model Vendor Frequency Serial Cores Threads
===== ====== ========= ====== ===== =======
Intel(R) Xeon(R) Silver 4310 CPU @ 2.10GHz Intel Corp. 2.10GHz n/a 12 24
Intel(R) Xeon(R) Silver 4310 CPU @ 2.10GHz Intel Corp. 2.10GHz n/a 12 24
Memory units:
Description Model Vendor Serial Storage size
=========== ===== ====== ====== ============
System Memory n/a n/a n/a 64GiB
DIMM DDR4 Synchronous Registered (Buffered) 3200 MHz (0.3 ns) 18ASF2G72PDZ-3G2R1 002C0632002C 3FEB05F4 16GiB
DIMM DDR4 Synchronous Registered (Buffered) 3200 MHz (0.3 ns) 18ASF2G72PDZ-3G2R1 002C0632002C 3FEB0815 16GiB
DIMM DDR4 Synchronous Registered (Buffered) 3200 MHz (0.3 ns) 18ASF2G72PDZ-3G2R1 002C0632002C 3FEB0638 16GiB
DIMM DDR4 Synchronous Registered (Buffered) 3200 MHz (0.3 ns) 18ASF2G72PDZ-3G2R1 002C0632002C 3FEB0864 16GiB
Network interfaces:
Description Model Vendor MAC address Speed Driver Firmware Port
=========== ===== ====== =========== ===== ====== ======== ====
Ethernet interface NetXtreme BCM5720 Gigabit Ethernet PCIe Broadcom Inc. and subsidiaries c4:cb:e1:a7:13:f6 1Gb/s tg3 FFV22.31.6 bc 5720-v1.39 pci-b4s0
Disk units:
Description Model Vendor Serial Storage size
=========== ===== ====== ====== ============
ATA Disk Micron_5200_MTFD n/a 190220540682 894GiB
NVMe disk n/a n/a n/a 894GiB
Memory¶
The command show state system linux memory presents
a short memory status summary.
On a physical machine running with 64GB or RAM
vsr> show state system linux memory
memory
available 64762789888
total 67400708096
..
Note
MemTotalThe total physical memory installed on the machine in bytes.
MemAvailableEstimate of how much memory is available (in bytes) for starting new applications without swapping.
NUMA statistics¶
This command displays per-node NUMA hit and miss system statistics from the kernel memory allocator.
vsr> show numa statistics
======= ======== ========= ============ ============== ========== ==========
Node id NUMA hit NUMA miss NUMA foreign Interleave hit Local node Other node
node0 1695092 0 0 2116 1695092 0
node1 58924643 0 0 7511 58924643 0