1BLKIOMON(8)                                                        BLKIOMON(8)
2
3
4

NAME

6       blkiomon - monitor block device I/O based o blktrace data
7
8
9

SYNOPSIS

11       blkiomon  -I interval [ -h file ] [ -b file ] [ -d file ] [ -D file ] [
12       -Q path_name -q msg_queue_id -m msg_id ] [ -V ]
13
14
15

DESCRIPTION

17       blkiomon is a block device I/O monitor. It periodically generates  per-
18       device  request size and request latency statistics from blktrace data.
19       It provides histograms as well as data that can be  used  to  calculate
20       min,  max,  average and variance. For this purpose, it consumes D and C
21       traces read from stdin.  Note, that this doesn't work for logical  vol‐
22       umes, as high-level drivers don't see the completion of the events (C).
23
24       There  are options for binary output and human-readable output to files
25       and stdout. Output to a message queue is supported as well.
26
27       There is no need to use blkparse with blkiomon. blkiomon is capable  of
28       consuming binary output written to stdout by blktrace.
29
30
31

OPTIONS

33       -I interval
34       --interval=interval
35              Set sample interval
36
37       -h file
38       --human-readable=file
39              Human-readable output file. Use '-' for stdout.
40
41       -b file
42       --binary=file
43              Binary output file. Use '-' for stdout.
44
45       -d file
46       --dump-lldd=file
47              Output file for data emitted by low level device driver.
48
49       -D file
50       --debug=file
51              Output file for debugging data. Use '-' for stdout.
52
53       -Q path_name
54       --msg-queue=path_name
55              Sets  path_name  as  path  name for existing message queue to be
56              used for binary output.
57
58       -q msg_queue_id
59       --msg-queue-id=msg_queue_id
60              Sets msg_queue_id as ID for an existing message queue to be used
61              for binary output.
62
63       -m msg_id
64       --msg-id=msg_id
65              Sets  msg_id  as message identifier to be used for binary output
66              messages written to an existing message queue.
67
68       -V
69       --version
70              Print program version.
71
72
73

EXAMPLES

75       To get I/O statistics for /dev/sdw every 10 seconds for a period of one
76       hour, use the following command:
77
78           % blktrace /dev/sdw -a issue -a complete -w 3600 -o - | blkiomon -I
79       10 -h -
80
81
82

AUTHORS

84       blkiomon and this man page were written by Martin Peschke.
85
86
87

REPORTING BUGS

89       Report bugs to <linux-btrace@vger.kernel.org>
90
91
92
94       Copyright © 2008 IBM Corp.
95       This is free software.  You may redistribute copies  of  it  under  the
96       terms       of       the      GNU      General      Public      License
97       <http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY,  to  the
98       extent permitted by law.
99
100
101

SEE ALSO

103       btrace (8), blktrace (8), blkparse (1), verify_blkparse (1), blkrawver‐
104       ify (1), btt (1)
105
106
107
108
109                                 July 17, 2008                     BLKIOMON(8)
Impressum