Repository files navigation

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

rbspy lets you profile Ruby processes that are already running. You give it a PID, and it startsprofiling. It's a sampling profiler, which means it'slow overhead andsafe to run inproduction.

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

=>https://rbspy.github.io

rbspy supports Linux*, Mac, Windows, and FreeBSD.

Did rbspy help you make your program faster? An awesome way to thank the project is to add asuccess story to this GitHub issuewhere people talk about ways rbspy has helped them! Hearing that rbspy is working for people is goodmotivation :)

On Mac, you can install with Homebrew:brew install rbspy.

On Linux:

1. Download recent release ofrbspy fromthe GitHub releases page.
   • The binaries tagged withmusl are statically linked against musl libc and can be used on most systems. The ones tagged withgnu are dynamically linked against GNU libc, so you will need it to be installed.
2. Unpack it
3. Move therbspy binary to/usr/local/bin

Or have a look atInstalling rbspy on our documentation.

To use rbspy in your Rust project, add the following to your Cargo.toml:

[dependencies]rbspy ="0.8"

WARNING: The rbspy crate's API is not stable yet. We will followsemantic versioning after rbspy reaches version 1.0.

Pull requests that improve usability, fix bugs, or help rbspy support more operating systems arevery welcome. If you have a question, the best way to ask is tocreate a GitHub issue!

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

1. Install cargo fromcrates.io
2. cargo build to build
3. cargo test to test

The built binary will end up attarget/debug/rbspy