This is documentation for the next version of Grafana documentation. For the latest stable release, go to the latest version.

Data sources

Pyroscope

Grafana Cloud Enterprise Open source

Last reviewed: July 8, 2026

Pyroscope data source

Grafana Pyroscope is a horizontally scalable, highly available, multi-tenant, OSS, continuous profiling aggregation system. Add a Pyroscope data source to query your profiles in Explore.

Grafana includes built-in support for Pyroscope, so you don’t need to install a plugin. The Pyroscope data source requires Grafana v12.3 or later.

Refer to Introduction to Pyroscope to understand profiling and Pyroscope.

Supported features

The Pyroscope data source supports the following features.

Feature	Supported
Metrics	Yes
Logs	No
Traces	No
Alerting	No
Annotations	No

The Pyroscope data source returns profiling data visualized as flame graphs and time-series metrics derived from profiles. It also integrates with tracing data through the Trace to profiles feature.

Get started

The following documents help you get started with the Pyroscope data source:

Before you query profiles, configure your application to send profiles to Pyroscope.

Continuous profiling

While code profiling has been a long-standing practice, continuous profiling represents a modern and more advanced approach to performance monitoring.

This technique adds two critical dimensions to traditional profiles:

Time: Profiling data is collected continuously, providing a time-centric view that allows querying performance data from any point in the past.
Metadata: Profiles are enriched with metadata, adding contextual depth to the performance data.

These dimensions, coupled with the detailed nature of performance profiles, make continuous profiling a uniquely valuable tool.

Flame graphs

Flame graphs help you visualize resource allocation and performance bottlenecks. For more information about the visualization and its features, refer to the Flame graph panel.

Grafana Cloud-only features

Some Pyroscope features are available only in Grafana Cloud:

Explain flame graph: On views with a flame graph, Grafana Cloud provides an AI-driven analysis that explains the performance bottleneck, its root cause, and a recommended fix. For more information, refer to Flame graph AI.
GitHub line-level insights: Through the GitHub integration, Grafana Cloud maps profiling data to your source code and shows line-level performance insights.

Integrate profiles into dashboards

Using the Pyroscope data source, you can integrate profiles into your dashboards. For example, you can embed flame graphs using the flame graph panel.

This example shows memory profiles alongside panels for logs and metrics, which helps you debug out of memory (OOM) errors together with the associated logs and metrics.

Visualize traces and profiles data using Trace to profiles

You can link profile and tracing data using your Pyroscope data source with the Tempo data source.

Combined traces and profiles let you see granular line-level detail when available for a trace span. This allows you to pinpoint the exact function that’s causing a bottleneck in your application as well as a specific request.

For more information, refer to Configure Trace to profiles and Link tracing and profiling with span profiles.

For more information about Pyroscope beyond the data source, refer to the following Pyroscope product documentation:

Introduction to Pyroscope: Understand continuous profiling and how Pyroscope works.
Configure the client to send profiles: Instrument your application to send profiling data to Pyroscope.
Link traces to profiles with span profiles: Correlate trace spans with profiling data.
Deploy Pyroscope: Deploy and run a self-managed Pyroscope backend.
Configure the Pyroscope server: Reference the available server configuration parameters.