runqlen(8)

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

NAME

6       runqlen.bt  -  CPU scheduler run queue length as a histogram. Uses bpf‐
7       trace/eBPF.
8

SYNOPSIS

10       runqlen.bt
11

DESCRIPTION

13       This program summarizes scheduler queue length as a histogram, and  can
14       also  show  run  queue  occupancy.  It  works by sampling the run queue
15       length on all CPUs at 99 Hertz.
16
17       This tool can be used to identify imbalances, eg,  when  processes  are
18       bound to CPUs causing queueing, or interrupt mappings causing the same.
19
20       Since this uses BPF, only the root user can use this tool.
21

REQUIREMENTS

23       CONFIG_BPF and bpftrace.
24

EXAMPLES

26       Trace CPU run queue length system wide, printing a histogram on Ctrl-C:
27              # runqlen.bt
28

FIELDS

30       1st, 2nd
31              The run queue length is shown in the first field (after "[").
32
33       3rd    A column showing the count of samples in for that length.
34
35       4th    This is an ASCII histogram representing the count column.
36

OVERHEAD

38       This samples scheduler structs at 99 Hertz across all CPUs. Relatively,
39       this is a low rate of events, and the overhead of this tool is expected
40       to be near zero.
41

SOURCE

43       This is from bpftrace.
44
45              https://github.com/iovisor/bpftrace
46
47       Also  look  in  the bpftrace distribution for a companion _examples.txt
48       file containing example usage, output, and commentary for this tool.
49
50       This is a bpftrace version of the bcc tool of the same  name.  The  bcc
51       tool may provide more options and customizations.
52
53              https://github.com/iovisor/bcc
54

OS

56       Linux
57

STABILITY

59       Unstable - in development.
60

AUTHOR

62       Brendan Gregg
63