rbperf is a low-overhead sampling profiler and tracer for Ruby (CRuby) which runs in BPF
To build rbperf you would need a Linux machine with:
- The Rust toolchain
clangto compile the BPF codeelfutilsandzlibinstalledmakeandpkg-configto build libbpf
Once the dependencies are installed:
# As we are statically linking elfutils and zlib, we have to tell Rustc
# where are they located. On my Ubuntu system they are under
$ export RUSTFLAGS='-L /usr/lib/x86_64-linux-gnu'
$ cargo build [--release]Stay tuned for pre-compiled binaries!
$ sudo rbperf record --pid `pidof ruby` cpu
The available system calls to trace can be found with sudo ls /sys/kernel/debug/tracing/events/syscalls/
$ sudo rbperf record --pid `pidof ruby` syscall enter_writev
Some debug information will be printed, and a flamegraph called rbperf_flame_$date will be written to disk 🎉
rbperf is in active development and the CLI and APIs might change any time
If you encounter any bugs, feel free to open an issue on rbperf's repo
rbperf wouldn't be possible without all the open source projects that we benefit from, such as Rust and all the superb crates we use in this project, Ruby and its GDB file, the BPF ecosystem, and many others!
Licensed under the MIT license