pidpersec(8)

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

NAME

6       pidpersec.bt - Count new processes (via fork()). Uses bpftrace/eBPF.
7

SYNOPSIS

9       pidpersec.bt
10

DESCRIPTION

12       pidpersec  shows how many new processes were created each second. There
13       can be performance issues caused by many short-lived  processes,  which
14       may  not  be  visible in sampling tools like top(1). pidpersec provides
15       one way to investigate this behavior.
16
17       This works by tracing  the  tracepoint:sched:sched_process_fork  trace‐
18       point.
19
20       Since this uses BPF, only the root user can use this tool.
21

REQUIREMENTS

23       CONFIG_BPF and bpftrace.
24

EXAMPLES

26       Count new processes, printing per-second summaries until Ctrl-C is hit:
27              # pidpersec.bt
28

FIELDS

30       1st    Count of processes (after "@")
31

OVERHEAD

33       This  traces  kernel  forks,  and maintains an in-kernel count which is
34       read asynchronously from user-space. As the rate of this  is  generally
35       expected  to  be  low  (<< 1000/s), the overhead is also expected to be
36       negligible.
37

SOURCE

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

OS

52       Linux
53

STABILITY

55       Unstable - in development.
56

AUTHOR

58       Brendan Gregg
59