bcc-bitesize(8)

1bitesize(8)                 System Manager's Manual                bitesize(8)
2
3
4

NAME

6       bitesize  -  Summarize  block  device  I/O  size as a histogram - Linux
7       eBPF/bcc.
8

SYNOPSIS

10       bitesize
11

DESCRIPTION

13       Show I/O distribution for requested block sizes, by process name.
14
15       This works by tracing block I/O kernel functions using dynamic  tracing
16       and prints a historgram of I/O size.
17
18       Since this uses BPF, only the root user can use this tool.
19

REQUIREMENTS

21       CONFIG_BPF and bcc.
22

EXAMPLES

24       Count I/O size per process until Ctrl-C is hit:
25              # bitesize
26

FIELDS

28       Kbtes  Size in kilobytes of range
29
30       count  How many I/O fell into this range
31
32       distribution
33              An ASCII bar chart to visualize the distribution (count column)
34
35

OVERHEAD

37       This traces kernel block I/O functions to update a histgroam, which are
38       asynchronously copied to user-space. This method is very efficient, and
39       the overhead for most storage I/O rates (< 10k IOPS) should be negligi‐
40       ble.  If you have a higher IOPS storage environment, test and  quantify
41       the overhead before use.
42
43

SOURCE

45       This is from bcc.
46
47              https://github.com/iovisor/bcc
48
49       Also  look  in  the bcc distribution for a companion _examples.txt file
50       containing example usage, output, and commentary for this tool.
51

OS

53       Linux
54

STABILITY

56       Unstable - in development.
57

AUTHOR

59       Allan McAleavy
60