IOPING(1) | User Commands | IOPING(1) |
ioping - simple disk I/O latency monitoring tool
ioping |
[-ABCDJLNRWGYykq]
[-a count]
[-b count]
[-c count]
[-e seed]
[-i interval]
[-l speed]
[-r rate]
[-t time]
[-T time]
[-s size]
[-S wsize]
[-o offset]
[-w deadline]
[-p period]
[-P period]
[-I [format]]
directory|file|device
|
ioping |
-h | -v
|
This tool generates various I/O patterns and lets you monitor I/O speed and latency in real time.
This option suppress human-readable output for each request (as -quiet), sets default interval to zero (-interval 0), stops measurement after 3 seconds (-work-time 3) and increases default working set size to 64m (-work-size 64m). Working set (-work-size) should be increased accordingly if disk has huge hardware cache.
For options that expect time argument (-interval, -print-interval and -work-time), default is seconds, unless you specify one of the following suffixes (case-insensitive):
For options that expect "size" argument (-size, -speed-limit, -work-size and -work-offset), default is bytes, unless you specify one of the following suffixes (case-insensitive):
For options that expect "number" argument (-count and -print-count) you can optionally specify one of the following suffixes (case-insensitive):
Returns 0 upon success. The following error codes are defined:
ioping -print-count 100 -count 200 -interval 0 -quiet .
99 10970974 9024 36961531 90437 110818 358872 30756 100
12516420
100 9573265 10446 42785821 86849 95733 154609 10548 100 10649035
(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
(1) count of requests in statistics
(2) running time (nanoseconds)
(3) requests per second (iops)
(4) transfer speed (bytes per second)
(5) minimal request time (nanoseconds)
(6) average request time (nanoseconds)
(7) maximum request time (nanoseconds)
(8) request time standard deviation (nanoseconds)
(9) total requests (including warmup, too slow or too fast)
(10) total running time (nanoseconds)
With option -J|--json ioping prints json array of objects:
[
...
{
// timestamps
"timestamp": (unix time in seconds as float),
"localtime": (local time ISO 8601),
// io target
"target": {
"path": (target path),
"fstype": (filesystem name),
"device": (device name),
"device_size": (device size in bytes)
},
// io request
"io": {
"request": (request index),
"operation": (request type: "read" | "write"),
"size": (request size in bytes),
"time": (io time in ns),
"ignored": (ignored in statistics: true | false)
},
// statistics
"stat": {
"count": (nr reqeusts),
"size": (total io size in bytes),
"time": (total io time in ns),
"iops": (avg iops),
"bps": (avg rate),
"min": (min io time in ns),
"avg": (avg io time in ns),
"max": (max io time in ns),
"mdev": (standard deviation in ns)
},
// load statistics
"load": {
"count": (nr requests),
"size": (total io size in bytes),
"time": (total real time in ns),
"iops": (avg iops),
"bps": (avg rate)
},
},
...
]
iostat(1), dd(1), fio(1), stress(1), stress-ng(1), dbench(1), sysbench(1), fsstress, xfstests, hdparm(8), badblocks(8),
This program was written by Konstantin Khlebnikov
koct9i@gmail.com.
Man-page was written by Kir Kolyshkin
kir@openvz.org.
Oct 2014 |