blkiomon(8)

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 ] [ -Q path_name
12       -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.
22
23       There are options for binary output and human-readable output to  files
24       and stdout. Output to a message queue is supported as well.
25
26       There  is no need to use blkparse with blkiomon. blkiomon is capable of
27       consuming binary output written to stdout by blktrace.
28
29
30

OPTIONS

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

EXAMPLES

70       To get I/O statistics for /dev/sdw every 10 seconds for a period of one
71       hour, use the following command:
72
73           % blktrace /dev/sdw -a issue -a complete -w 3600 -o - | blkiomon -I
74       10 -h -
75
76
77

AUTHORS

79       blkiomon and this man page were written by Martin Peschke.
80
81
82

REPORTING BUGS

84       Report bugs to <linux-btrace@vger.kernel.org>
85
86
87

COPYRIGHT

89       Copyright © 2008 IBM Corp.
90       This  is  free  software.   You may redistribute copies of it under the
91       terms      of      the      GNU      General       Public       License
92       <http://www.gnu.org/licenses/gpl.html>.   There  is NO WARRANTY, to the
93       extent permitted by law.
94
95
96