Pyroscope

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

Stars
8.85K
Forks
511
Open issues
491
Closed issues
603
Last release
5 months ago
Last commit
5 months ago
Watchers
8.85K
Total releases
98
Total commits
4.13K
Open PRs
12
Closed PRs
1.5K
Repo URL
Platform
License
agpl-3.0
Category
Offers premium version?
NO
Proprietary?
NO
About

🌟 What is Grafana Pyroscope?

Grafana Pyroscope is an open source continuous profiling platform. It will help you:

  • Find performance issues and bottlenecks in your code
  • Use high-cardinality tags/labels to analyze your application
  • Resolve issues with high CPU utilization
  • Track down memory leaks
  • Understand the call tree of your application
  • Auto-instrument your code to link profiling data to traces

πŸ”₯ Pyroscope Live Demo πŸ”₯

πŸŽ‰ Features

  • Minimal CPU overhead
  • Horizontally scalable
  • Efficient compression, low disk space requirements
  • Can handle high-cardinality tags/labels
  • Calculate the performance "diff" between various tags/labels and time periods
  • Advanced analysis UI

πŸ’» Quick Start: Run Pyroscope Locally Homebrew

brew install pyroscope-io/brew/pyroscope
brew services start pyroscope
Docker
docker run -it -p 4040:4040 grafana/pyroscope

For more documentation on how to configure Pyroscope server, see our server documentation.

Send data to server via Pyroscope agent (language specific)

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


Golang

Documentation
Examples


Java

Documentation
Examples


Python

Documentation
Examples


Ruby

Documentation
Examples


NodeJS

Documentation
Examples


Dotnet

Documentation
Examples


eBPF

Documentation
Examples


Rust

Documentation
Examples

Deployment Diagram

Documentation

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

Downloads

You can download the latest version of pyroscope for macOS, linux and Docker from our Releases page.

Supported Languages

  • Go (via pprof)
  • Python (via py-spy)
  • Ruby (via rbspy)
  • Linux eBPF
  • Java (via async-profiler)
  • Rust (via pprof-rs)
  • .NET
  • PHP (via phpspy)
  • Node

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:

  • Brendan Gregg β€” inventor of Flame Graphs
  • Julia Evans β€” creator of rbspy β€” sampling profiler for Ruby
  • Vladimir Agafonkin β€” creator of flamebearer β€” fast flamegraph renderer
  • Ben Frederickson β€” creator of py-spy β€” sampling profiler for Python
  • Adam Saponara β€” creator of phpspy β€” sampling profiler for PHP
  • Alexei Starovoitov, Brendan Gregg, and many others who made BPF based profiling in Linux kernel possible
  • Jamie Wong β€” creator of speedscope β€” interactive flamegraph visualizer

Contributing

To start contributing, check out our Contributing Guide

Thanks to the contributors of Pyroscope!

Alternative Projects

Subscribe to Open Source Businees Newsletter

Twice a month we will interview people behind open source businesses. We will talk about how they are building a business on top of open source projects.

We'll never share your email with anyone else.