xref: /linux-tools/perf/profiler/README.md (revision c995a2d01ec016e07a0052d1d0b650e51fec4753)
1# A simple profiler
2Fit for lightwight usage, minimum dependency
3
4## Build
5```
6g++ -o profiler profiler.cpp
7```
8The code needs c++11 features, if an old g++ compiler is used, `-std=c++11` is needed.
9You can also use static c/c++ libs via `-static-libstdc++ -static-libgcc`, or even further to build a static executable `-static`
10
11
12## How it works
13Profiler open  perf-event and collect sampled (pid,callchain) pair, whether userspace call-chain is collected depends on kernel version, a new kernel which can unwind user space stack is recommended, (I only tested the profiler on limited number of kernel version, and they all can unwind user stack, the lowest version of kernel I have tested is 3.10.0 from centos/redhat distributions.)
14For each (pid, callchain) pair, if this pid has not been symbol-collected, profiler would  parse elf information based on `/proc/[pid]/maps` and `/proc/[pid]/map_files/*`; (If the program has its symbol stripped, e.g. via `ld -s`, user space call chain will be dropped.) Symbols are stored in an ordered structure, C++ map,  after symbols collected, each callchain address is binary searched for its  function name, and then full chain is inserted into a tree.
15
16
17## Run
18The profiler would open perf event with the cgroup which controls the specified pid
19```
20./profiler <pid>
21```
22
23To create a perf-event cgroup
24
25cgroup v1
26```
27mkdir /sys/fs/cgroup/perf_event/<somename>
28echo $$ > /sys/fs/cgroup/perf_event/<somename>/cgroup.procs
29# run the target progrom
30# run profiler with any pid within the cgroup
31```
32For cgroup v2, just use /sys/fs/cgroup/<somename>
33
34
35## Example
36When profiler terminated, a report is generated, following is an example showing the performance impact from seccomp when running a high-IO program within a docker container.
37![example](./example1.png "report")
38