Poster of Linux kernelThe best gift for a Linux geek
BLKIOMON

BLKIOMON

Section: (8) Updated: July 17, 2008
Local index Up

 

NAME

blkiomon - monitor block device I/O based o blktrace data

 

SYNOPSIS

blkiomon -I interval [ -h file ] [ -b file ] [ -D file ] [ -Q path_name -q msg_queue_id -m msg_id ] [ -V ]

 

DESCRIPTION

blkiomon is a block device I/O monitor. It periodically generates per-device request size and request latency statistics from blktrace data. It provides histograms as well as data that can be used to calculate min, max, average and variance. For this purpose, it consumes D and C traces read from stdin.

There are options for binary output and human-readable output to files and stdout. Output to a message queue is supported as well.

There is no need to use blkparse with blkiomon. blkiomon is capable of consuming binary output written to stdout by blktrace.

 

OPTIONS

-I interval
--interval=interval

Set sample interval

-h file
--human-readable=file

Human-readable output file. Use '-' for stdout.

-b file
--binary=file

Binary output file. Use '-' for stdout.

-D file
--debug=file

Output file for debugging data. Use '-' for stdout.

-Q path_name
--msg-queue=path_name

Sets path_name as path name for existing message queue to be used for binary output.

-q msg_queue_id
--msg-queue-id=msg_queue_id

Sets msg_queue_id as ID for an existing message queue to be used for binary output.

-m msg_id
--msg-id=msg_id

Sets msg_id as message identifier to be used for binary output messages written to an existing message queue.

-V
--version

Print program version.

 

EXAMPLES

To get I/O statistics for /dev/sdw every 10 seconds for a period of one hour, use the following command:


    % blktrace /dev/sdw -a issue -a complete -w 3600 -o - | blkiomon -I 10 -h -

 

AUTHORS

blkiomon and this man page were written by Martin Peschke.

 

REPORTING BUGS

Report bugs to <linux-btrace@vger.kernel.org>

 

COPYRIGHT

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

 

SEE ALSO

btrace (8), blktrace (8), blkparse (1), verify_blkparse (1), blkrawverify (1), btt (1)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
AUTHORS
REPORTING BUGS
COPYRIGHT
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 22:01:21 GMT, April 16, 2011