1biolatency(8) System Manager's Manual biolatency(8)
2
3
4
6 biolatency.bt - Block I/O latency as a histogram. Uses bpftrace/eBPF.
7
9 biolatency.bt
10
12 This tool summarizes time (latency) spent in block device I/O (disk
13 I/O) as a power-of-2 histogram. This allows the distribution to be
14 studied, including modes and outliers. There are often two modes, one
15 for device cache hits and one for cache misses, which can be shown by
16 this tool. Latency outliers will also be shown.
17
18 This tool currently works by dynamic tracing of the blk_account*() ker‐
19 nel functions, which will need updating to match any changes to these
20 functions in future kernels versions.
21
22 Since this uses BPF, only the root user can use this tool.
23
25 CONFIG_BPF and bpftrace.
26
28 Trace block device I/O (disk I/O), and print a latency histogram on
29 Ctrl-C:
30 # biolatency.bt
31
33 1st, 2nd
34 This is a range of latency, in microseconds (shown in "[...)"
35 set notation).
36
37 3rd A column showing the count of operations in this range.
38
39 4th This is an ASCII histogram representing the count column.
40
42 Since block device I/O usually has a relatively low frequency (<
43 10,000/s), the overhead for this tool is expected to be negligible. For
44 high IOPS storage systems, test and quantify before use.
45
47 This is from bpftrace.
48
49 https://github.com/iovisor/bpftrace
50
51 Also look in the bpftrace distribution for a companion _examples.txt
52 file containing example usage, output, and commentary for this tool.
53
54 This is a bpftrace version of the bcc tool of the same name. The bcc
55 tool may provide more options and customizations.
56
57 https://github.com/iovisor/bcc
58
60 Linux
61
63 Unstable - in development.
64
66 Brendan Gregg
67
69 biosnoop(1)
70
71
72
73USER COMMANDS 2018-09-13 biolatency(8)