Debian Codegraph @

EXAMPLES/lwtools/biolatency-nd.8

raw
1 .TH biolatency-nd 8 "2015-01-30" "USER COMMANDS"
2 .SH NAME
3 biolatency-nd \- Measure block I/O latency distribution. Uses Linux SystemTap (non-debuginfo).
4 .SH SYNOPSIS
5 .B biolatency-nd.stp
6 [interval [count]]
7 .SH DESCRIPTION
8 This measures block I/O latency (storage I/O, ie, disk I/O), and shows the
9 distribution as a histogram. This can be useful to identify the characteristics
10 of I/O latency, beyond the averages shown by iostat(1). For example, to study
11 I/O latency outliers, or multi-modal distributions.
12
13 This script uses the kernel tracepoints block_rq_issue and block_rq_complete,
14 to trace the time from storage request to completion. To include extra time
15 spent queued in the kernel, change block_rq_issue to block_rq_insert.
16 .SH REQUIREMENTS
17 SystemTap.
18 .SH OPTIONS
19 .TP
20 interval
21 Interval for reports, in seconds.
22 .TP
23 count
24 Number of reports to output.
25 .SH EXAMPLES
26 .TP
27 Measure block I/O latency, and show a distribution histogram on Ctrl-C:
28 #
29 .B biolatency-nd.stp
30 .TP
31 Measure block I/O latency, and show a report every second, five times:
32 #
33 .B biolatency-nd.stp 1 5
34 .SH FIELDS
35 .TP
36 value
37 The minimum value, in nanoseconds, for this histogram bucket. Read this value
38 as "I/O latency was at least xxx".
39 .TP
40 count
41 How many I/O fell into this latency range.
42 .SH OVERHEAD
43 Should be low, relative to the rate of disk I/O. Test first.
44 .SH SOURCE
45 This is from the SystemTap lwtools collection.
46 .IP
47 https://github.com/brendangregg/systemtap-lwtools
48 .PP
49 Also look under the examples directory for a text file containing example
50 usage, output, and commentary for this tool.
51 .SH OS
52 Linux
53 .SH STABILITY
54 Unstable - in development.
55 .SH AUTHOR
56 Brendan Gregg
57 .SH SEE ALSO
58 iostat(1)