bcc-virtiostat(8)

1virtiostat(8)               System Manager's Manual              virtiostat(8)
2
3
4

NAME

6       virtiostat  -  Trace VIRTIO devices input/output statistics. Uses Linux
7       eBPF/bcc.
8

SYNOPSIS

10       virtiostat [-h] [-T] [-D] [-d DRIVER] [-n DEVNAME] [INTERVAL] [COUNT]
11

DESCRIPTION

13       This tool traces VIRTIO devices input/output statistics.  It  works  in
14       lower layer of VIRTIO base driver, so it could trace all the devices of
15       VIRTIO family. For example, we can't get IO statistics of  9p-fs  in  a
16       guest  virtual machine by iostat command, but we can analyze IO statis‐
17       tics by virtiostat.  The outputing result shows In/Out SGs(scatter list
18       operation)  to  represent  positive  correlation IOPS, and In/Out BW to
19       represent throughput.
20
21       Since this uses BPF, only the root user can use this tool.
22

REQUIREMENTS

24       CONFIG_BPF and bcc.
25

OPTIONS

27       -h     Print usage message.
28
29       -T     Include a time column on output (HH:MM:SS).
30
31       -D     Show debug infomation of bpf text.
32
33       -d DRIVER
34              Filter for driver name.
35
36       -n DEVNAME
37              Filter for device name.
38
39       INTERVAL
40              Print output every interval seconds.
41
42       COUNT  Total count of trace in seconds.
43

EXAMPLES

45       Trace virtio device statistics and print 1 second summaries, 10 times:
46              # virtiostat 1 10
47
48       Trace virtio block deivces only:
49              # virtiostat -d virtio_blk
50

OVERHEAD

52       This  traces  the   kernel   virtqueue_add_sgs,   virtqueue_add_outbuf,
53       virtqueue_add_inbuf,  virtqueue_add_inbuf_ctx  functions.   The rate of
54       this depends on all the VIRTIO devices IOPS.
55

SOURCE

57       This is from bcc.
58
59              https://github.com/iovisor/bcc
60
61       Also look in the bcc distribution for a  companion  _examples.txt  file
62       containing example usage, output, and commentary for this tool.
63

OS

65       Linux
66

STABILITY

68       Unstable - in development.
69

AUTHOR

71       zhenwei pi
72