rbspy

Documentation: https://rbspy.github.io

Have a running Ruby program that you want to profile without restarting it? Want to profile a Ruby command line program really easily? You want rbspy! rbspy can profile any Ruby program just by running 1 simple command.

rbspy lets you profile Ruby processes that are already running. You give it a PID, and it starts profiling. It's a sampling profiler, which means it's low overhead and safe to run in production.

rbspy lets you record profiling data, save the raw profiling data to disk, and then analyze it in a variety of different ways later on.

Requirements

rbspy runs on Linux* and Mac.

* kernel version 3.2+ required. For Ubuntu, this means Ubuntu 12.04 or newer.

Add a testimonial

Did rbspy help you make your program faster? An awesome way to thank the project is to add a success story to this GitHub issue where people talk about ways rbspy has helped them! Hearing that rbspy is working for people is good motivation :)

Installing

Download recent release of rbspy from the github releases page
Unpack it
Move the rbspy binary to /usr/local/bin

Contributing

Pull requests that improve usability, fix bugs, or help rbspy support more operating systems are very welcome. If you have questions about contributing come chat on gitter or email rbspy-users@googlegroups.com.

If you're not a very experienced Rust programmer, you're very welcome to contribute. A major reason rbspy is written in Rust is that Rust is more approachable for beginners than C/C++. https://www.rust-lang.org/en-US/ has great resources for learning Rust.

Building rbspy

Install cargo from crates.io
cargo build to build
cargo test to test

The built binary will end up at target/debug/rbspy

liaden/rbspy