virtiostat_example.txt

Demonstrations of virtiostat, the Linux eBPF/bcc version.


This program traces virtio devices to analyze the IO operations and
throughput. For example, guest side mounts a 9p fs, and we can't get
io statistics by `iostat` command any more. In this scenario, we can
only get statistics from VIRTIO layer instead of block layer.

Example
#./virtiostat -T
Tracing virtio devices statistics ... Hit Ctrl-C to end.
14:48:30
        Driver   Device    VQ Name  In SGs Out SGs          In BW         Out BW
    virtio_net  virtio0    input.0  260669       0      406743040              0
    virtio_net  virtio0   output.0       0    9873              0         833344
    virtio_blk  virtio4      req.0      28      46            448         278976
  9pnet_virtio  virtio6   requests   99083   99354        1883687      137537263
14:48:33
        Driver   Device    VQ Name  In SGs Out SGs          In BW         Out BW
    virtio_net  virtio0    input.0  260718       0      406819328              0
    virtio_net  virtio0   output.0       0    7139              0         562355
    virtio_blk  virtio4      req.0      11      18            176         110768
  9pnet_virtio  virtio6   requests   91520   91141        1737364      125320785


Full USAGE:

#./virtiostat -h
usage: virtiostat.py [-h] [-T] [-D] [interval] [count]

Show virtio devices input/output statistics

positional arguments:
  interval         output interval, in seconds
  count            number of outputs

optional arguments:
  -h, --help       show this help message and exit
  -T, --timestamp  show timestamp on output
  -D, --debug      print BPF program before starting (for debugging purposes)

examples:
    ./virtiostat            # print 3(default) second summaries
    ./virtiostat  1  10     # print 1 second summaries, 10 times
    ./virtiostat -T         # show timestamps
    ./virtiostat -D         # show debug bpf text