Menu
Documentation
Grafana Pyroscope
Open source
Grafana Pyroscope
Grafana Pyroscope is an open source software project for aggregating continuous profiling data. Continuous profiling is an observability signal that allows you to understand your workload’s resources usage down to the source code line number. Grafana Pyroscope is fully integrated with Grafana allowing you to correlate with other observability signals, like metrics, logs, and traces.
Overview
Grafana Pyroscope is a multi-tenant, continuous profiling aggregation system, aligning its architectural design with Grafana Mimir, Grafana Loki, and Grafana Tempo. This integration enables a cohesive correlation of profiling data with existing metrics, logs, and traces.
Explore continuous profiling data to gain insights into application performance. You can query and analyze production data in a structure way. Use the Pyroscope UI or Grafana to visualize the data.
Explore
Learn about profiling
Learn about continuous profiling and how you identify performance bottlenecks and optimize your applications. After an application is profiled, you can start with system-wide observability and drill down to actionable code-level insights.
Get started with Pyroscope
Learn how to install and configure Grafana Pyroscope with several examples.
Instrument your app and configure the client
When sending profiles to Pyroscope, you can choose between SDK instrumentation and auto-instrumentation using the Grafana Agent. This document explains these two techniques and guide you when to choose each one.
Configure the server
Configure your Pyroscope server to meet your needs by setting disk storage, tenant IDs, memberlist, proxies, shuffle sharding, and more. You can also use the server HTTP API.
View and analyze profile data
Profiling data can be presented in a variety of formats presents, including flame graphs, tables, as well as charts and graphs. Flame graphs visualize call relationships and identify hot spots. Tables let you view detailed statistics for specific functions or time periods. Charts and graphs help you analyze trends and compare performance across different metrics.
Pyroscope architecture
Take a deep-dive into the microservices-based architecture to learn about deployment modes, components (microservices), and more. The system has multiple horizontally scalable microservices that can run separately and in parallel.
Was this page helpful?
Related documentation
Related resources from Grafana Labs
Additional helpful documentation, links, and articles:
![Getting started with continuous profiling with Grafana Cloud Profiles](/media/webinar/cont-profiling-meta-2.png?w=200 200w, /media/webinar/cont-profiling-meta-2.png?w=400 400w)
Getting started with continuous profiling with Grafana Cloud Profiles
In this webinar, you'll learn how to get started with Grafana Cloud Profiles - a hosted continuous profiling tool in Grafana Cloud
![Continuous profiling with Grafana Pyroscope: developer experience, flame graphs, and more](/media/events/grafanacon/2023/meta-no-dates/GrafanaCON-2023-Session-Continuous-profiling.png?w=200 200w, /media/events/grafanacon/2023/meta-no-dates/GrafanaCON-2023-Session-Continuous-profiling.png?w=400 400w)
Continuous profiling with Grafana Pyroscope: developer experience, flame graphs, and more
Learn about the new Grafana Pyroscope open source project and how continuous profiling can improve developer experience.
![Building scalable OSS observability with Mimir, Loki, Tempo, and Pyroscope](/media/events/obscon/2023/meta/obscon23-session-mi-10-Building-scalable-OSS-observability-with-Mimir,-Loki,-Tempo,-and-Pyroscope.png?w=200 200w, /media/events/obscon/2023/meta/obscon23-session-mi-10-Building-scalable-OSS-observability-with-Mimir,-Loki,-Tempo,-and-Pyroscope.png?w=400 400w)
Building scalable OSS observability with Mimir, Loki, Tempo, and Pyroscope
Learn the latest scalability and performance improvements in OSS telemetry backends Loki, Tempo, Mimir, and Pyroscope for profiles. Watch on demand.