pyroscope README

The project's README from github.com/grafana/pyroscope. As one markdown file: README.md.

Pyroscope

ci Go Report License: AGPLv3 FOSSA Status Latest release DockerHub Go Reference

🎉 Announcement: Pyroscope 2.0 is here!

Pyroscope 2.0 makes the new v2 architecture the default. Profiles are written directly to object storage, removing the need for in-memory ingesters and local disks - simplifying operations and lowering resource usage at scale. Existing v1 deployments can opt in via a flag and migrate without data loss.

Read the 2.0 release notes and the v2 architecture overview. Upgrading from v1? See the migration guide.

Want the full story? Watch the GrafanaCON 2026 talk Pyroscope 2.0: Continuous Profiling Architecture Deep Dive.

What is Grafana Pyroscope?

Grafana Pyroscope is a continuous profiling platform designed to surface performance insights from your applications, helping you optimize resource usage such as CPU, memory, and I/O operations. With Pyroscope, you can both proactively and reactively address performance bottlenecks across your system.

The typical use cases are:

Pyroscope provides powerful tools to give you a comprehensive view of your application's behavior while allowing you to drill down into specific services for more targeted root cause analysis.

How Does Pyroscope Work?

deployment_diagram

Pyroscope consists of three main components:

Under the hood, Pyroscope v2 writes profiles straight to object storage—no ingesters, no local disk. The animations below trace the three parts of the architecture. For the details behind each component, see the v2 architecture documentation.

Write path — profiles are routed by service and written straight to object storage:

Pyroscope v2 write path

Compaction — compaction-workers merge small segments into larger blocks in the background:

Pyroscope v2 compaction

Read path — queries fan out across object storage to build flame graphs in Grafana Profiles Drilldown:

Pyroscope v2 read path


Pyroscope Live Demo

Pyroscope GIF Demo


Quick Start: Run the Pyroscope server locally

Docker

docker run -it -p 4040:4040 grafana/pyroscope

Homebrew (macOS / Linux)

brew install pyroscope-io/brew/pyroscope
brew services start pyroscope

Binary

Download the archive for your operating system and architecture from the latest release, unpack it, and run the binary:

tar xvf pyroscope_*.tar.gz
./pyroscope

Pyroscope listens on port 4040. For Kubernetes/Helm, Linux packages, building from source, and full configuration options, see the Get started guide and the server documentation.

Quick Start: Visualize profiles with Grafana Profiles Drilldown

image

Grafana Profiles Drilldown (formerly Explore Profiles) is the primary, queryless way to visualize and analyze your profiling data.

Grafana Cloud / OSS

Profiles Drilldown is pre-installed and is the default way to explore your profiles – all you need to do is start sending data.

Documentation

For more information on how to use Pyroscope with other programming languages, install it on Linux, or use it in a production environment, check out our documentation:

Send data to the server

You can send profiles to Pyroscope with the language SDKs, with Grafana Alloy, or over OTLP from OpenTelemetry-compatible sources such as the OpenTelemetry eBPF profiler.

For more documentation on how to add the Pyroscope SDK to your code, see the client documentation on our website or find language-specific examples and documentation below:


Golang

Documentation
Examples

Java

Documentation
Examples

Python

Documentation
Examples

Ruby

Documentation
Examples

Node.js

Documentation
Examples

.NET

Documentation
Examples

eBPF

Documentation
Examples

Rust

Documentation
Examples

Supported Languages

Our documentation contains the most recent list of supported languages and also an overview over what profiling types are supported per language.

Let us know what other integrations you want to see in our issues or in our slack.

Credits

Pyroscope is possible thanks to the excellent work of many people, including but not limited to:

Contributing

To start contributing, check out our Contributing Guide

Thanks to the contributors of Pyroscope!

pyroscope (grafana/pyroscope)

Searching Database…

11.7K ·GitHub
Что это такое?Grafana Pyroscope — это платформа непрерывного профилирования, которая собирает подробные данные о производительности CPU, памяти и I/O из ваших приложений, чтобы вы могли найти узкие места вплоть до отдельной строки кода.
Это библиотека, которую я встраиваю, или отдельный сервер, который я запускаю?Это отдельный сервер (плюс клиентские SDK и агенты). Вы запускаете сервер Pyroscope, чтобы хранить и запрашивать данные профилирования, а в свои приложения встраиваете SDK, Grafana Alloy или OTLP, чтобы отправлять в него профили.
Как запустить сервер?Запустите его через Docker, Homebrew (macOS/Linux) или скачав бинарный файл для вашей ОС и архитектуры из последнего релиза и выполнив его; он слушает порт 4040. Также описаны варианты для Kubernetes/Helm и пакеты для Linux.
Что нужно, чтобы отправлять в него профили?Вы встраиваете в приложение Pyroscope SDK (push), Grafana Alloy (pull или push) или OTLP из совместимых с OpenTelemetry источников, например, eBPF-профилировщика OpenTelemetry. Поддерживаемые языки включают Go, Java, Python, Ruby, Node.js, .NET, eBPF и Rust.
Что изменилось в архитектуре 2.0 и нужно ли мигрировать?Pyroscope 2.0 записывает профили напрямую в объектное хранилище вместо ингестеров, работающих в памяти, и локальных дисков. Это упрощает эксплуатацию и снижает потребление ресурсов при большом масштабе. Существующие развертывания v1 могут перейти на новую архитектуру через флаг и мигрировать без потери данных.
На каких платформах можно запустить сервер?Сервер работает на Linux и macOS (через Docker, Homebrew или бинарные файлы) и может быть развернут в Kubernetes/Helm. Он написан на Go, поэтому доступны сборки под разные платформы.
Как визуализировать данные профилирования после сбора?Используйте Grafana Profiles Drilldown (ранее Explore Profiles) — встроенный в Grafana интерфейс без запросов для визуализации и анализа флеймграфов по данным Pyroscope.
Кто стоит за техниками профилирования, которые здесь используются?Pyroscope отдаёт должное пионерам, таким как Brendan Gregg (изобретатель флеймграфов), Julia Evans (rbspy), Ben Frederickson (py-spy) и Adam Saponara (phpspy). Их сэмплирующие профилировщики и визуализации лежат в основе проекта.
Можно ли попробовать без установки?Да, в README есть ссылка на Pyroscope Live Demo, где можно изучить интерфейс и флеймграфы до настройки собственного сервера.
Creator
grafana
Size
248.2 MB
Stars
11.7K
Age
5y
Commits · 90 Days