OnCallReadyStart learning

biolatency-bpfcc: Summarize block device I/O latency as a histogram

biolatency-bpfcc [-h] [-T] [-Q] [-m] [-D] [-F] [-e] [-j] [-d DISK] [interval] [count]

What it does

Summarize block device I/O latency as a histogram. Part of the bcc tools (bpfcc-tools 0.35.0 on Ubuntu, installed as /usr/sbin/biolatency-bpfcc; upstream and other distributions call it biolatency). It loads an eBPF program, so it needs root.

Options you will use

interval
output interval, in seconds
count
number of outputs
-T, --timestamp
include timestamp on output
-Q, --queued
include OS queued time in I/O time
-m, --milliseconds
millisecond histogram
-D, --disks
print a histogram per disk device
-F, --flags
print a histogram per set of I/O flags
-e, --extension
summarize average/total value
-j, --json
json output
-d, --disk DISK
Trace this disk only

Examples

$ sudo biolatency-bpfcc

summarize block I/O latency as a histogram

$ sudo biolatency-bpfcc 1 10

print 1 second summaries, 10 times

$ sudo biolatency-bpfcc -mT 1

1s summaries, milliseconds, and timestamps

$ sudo biolatency-bpfcc -Q

include OS queued time in I/O time

$ sudo biolatency-bpfcc -D

show each disk device separately

$ sudo biolatency-bpfcc -F

show I/O flags separately

$ sudo biolatency-bpfcc -j

print a dictionary

$ sudo biolatency-bpfcc -e

show extension summary(total, average)

Gotchas

Taught in

On the blog

Try biolatency-bpfcc in a real terminal Free, in your browser - a real Ubuntu terminal to try it in, with missions that check your work.