# rbspy/rbspy

Sampling CPU profiler for Ruby

Repository: https://github.com/rbspy/rbspy
Canonical: https://ross.abutalabs.com/products/rbspy
Homepage: https://rbspy.github.io
Language: Rust
License: MIT
License Family: permissive
Topics: rust, profilers, cpu, ruby
Last push: 2026-08-20T10:49:09+00:00

## Health v2 (maintenance only)
Score: 97/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 94, longevity 100
- inputs: {"age_days": 3765, "days_push": 13, "days_rel": 41, "gap_med": 15, "n_releases_24m": 32}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2573, forks 106 (observed 2026-08-28T04:07:01.535261+00:00)

## What it is
rbspy is a sampling CPU profiler for Ruby that can profile already-running processes by PID or launch new ones, with low overhead safe for production. It records profiling data, saves raw data to disk, and generates flamegraphs for analysis.

## Use cases
- profile a running Ruby process without restarting it
- generate flamegraphs for Ruby programs
- profile Ruby code in production with low overhead
- find which functions a Ruby program is calling
- record and analyze Ruby CPU usage over time
- profile a Ruby script run with bundle exec

## When to choose
- you need to profile a Ruby process that is already running
- you want a low-overhead profiler safe for production use
- you want flamegraphs and saved raw profiling data
- you need cross-platform support (Linux, macOS, Windows, FreeBSD)

## When to avoid
- you need to profile languages other than Ruby
- you need an instrumenting profiler with exact call counts rather than sampling
- you need a stable Rust library API (the crate API is not yet stable)

## Facets
- artifact type: cli-tool
- maturity: active
- function: benchmarking, monitoring, cli
- domain: developer-tools, performance
- platform: windows, bsd, rust, cli
- tags: profiler, sampling-profiler, ruby, flamegraph, production-profiling, command-line, linux, macos

## Member repositories
- rbspy/rbspy (main) score 97

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:01.535261+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:23:06.064530+00:00, confidence not recorded.
  - readme: https://github.com/rbspy/rbspy (fetched 2026-08-28T04:07:01.535261+00:00, sha efd80fe8f170)
  - homepage: https://rbspy.github.io (fetched 2026-08-29T10:05:28.985099+00:00, sha 7235b9b581eb)
  - registry_crates: https://crates.io/api/v1/crates/rbspy (fetched 2026-08-29T10:05:29.019826+00:00, sha c59c3a5e499b)
- Data as of 2026-08-30T08:39:29.467469+00:00.