pyroscope

Continuous Profiling Platform. Debug performance issues down to a single line of code

What is pyroscope?

Continuous Profiling Platform. Debug performance issues down to a single line of code

Overview of pyroscope

What it is

Grafana Pyroscope is a continuous profiling platform designed to surface performance insights from applications, helping to optimize resource usage such as CPU, memory, and I/O operations. It allows both proactive and reactive addressing of performance bottlenecks across a system. The platform consists of a Pyroscope Server that stores and processes profiling data and serves queries, clients and instrumentation (Pyroscope SDKs, Grafana Alloy, or OTLP from OpenTelemetry-compatible sources), and Grafana Profiles Drilldown (formerly Explore Profiles) as a queryless UI for visualizing and analyzing profiling data. Pyroscope v2 writes profiles directly to object storage, removing the need for in-memory ingesters and local disks, simplifying operations and lowering resource usage at scale.

Key features

  • Continuous profiling to debug performance issues down to a single line of code.
  • Supports profiling of CPU, memory, and I/O operations.- v2 architecture writes profiles directly to object storage, eliminating ingesters and local disks.
  • Provides a queryless UI (Grafana Profiles Drilldown) for visualizing flame graphs and analyzing data.
  • Supports multiple data ingestion methods: Pyroscope SDKs (push), Grafana Alloy (pull or push), and OTLP from OpenTelemetry-compatible sources.
  • Compatible with multiple languages including Go, Java, Python, Ruby, Node.js, .NET, Rust, and eBPF.
  • Can be used both proactively (reducing resource consumption, improving performance) and reactively (debugging active bottlenecks).

Use cases

  • Proactively reducing resource consumption and improving application performance.
  • Preventing latency issues before they affect users.
  • Reactively resolving incidents with line-level detail to debug active CPU, memory, or I/O bottlenecks.
  • Gaining a comprehensive view of application behavior and drilling down into specific services for root cause analysis.

Getting started

Run the Pyroscope server locally using Docker:shdocker run -it -p 4040:4040 grafana/pyroscopeOr with Homebrew (macOS/Linux):shbrew install pyroscope-io/brew/pyroscopebrew services start pyroscopeOr download the binary from the latest release, unpack it, and run:shtar xvf pyroscope_*.tar.gz./pyroscopePyroscope listens on port 4040. For Kubernetes/Helm, Linux packages, building from source, and full configuration options, see the Get started guide and server documentation.

License and pricing

Pyroscope is licensed under AGPL-3.0 and is open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/grafanapyroscope.svg)](https://yunodb.com/tools/grafanapyroscope?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/grafanapyroscope?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/grafanapyroscope.svg" alt="Featured on YunoDB" height="20"></a>