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.