{"repo":"grafana/pyroscope","free":true,"listed":false,"github":"https://github.com/grafana/pyroscope","clone":"git clone https://github.com/grafana/pyroscope.git","description":"Continuous Profiling Platform. Debug performance issues down to a single line of code","language":"Go","stars":11628,"topics":["continuous-profiling","developer-tools","devops","find-bottlenecks","golang","hacktoberfest","linux","monitoring","observability","performance","profiling","pyroscope","python","ruby"],"license":"AGPL-3.0","category":"observability_platform","readme_excerpt":"
\n\n\n[](https://github.com/grafana/pyroscope/actions/workflows/ci.yml)\n[](https://goreportcard.com/report/github.com/grafana/pyroscope)\n[](LICENSE)\n[](https://app.fossa.com/projects/git%2Bgithub.com%2Fgrafana%2Fpyroscope?ref=badge_shield)\n[](https://github.com/grafana/pyroscope/releases)\n[](https://hub.docker.com/r/grafana/pyroscope)\n[](https://pkg.go.dev/github.com/grafana/pyroscope/v2)\n\n## 🎉 **Announcement: Pyroscope 2.0 is here!**\n\nPyroscope 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.\n\nRead the [2.0 release notes](https://grafana.com/docs/pyroscope/latest/release-notes/v2-0/) and the [v2 architecture overview](https://grafana.com/docs/pyroscope/latest/reference-pyroscope-v2-architecture/). Upgrading from v1? See the [migration guide](https://grafana.com/docs/pyroscope/latest/reference-pyroscope-v2-architecture/migrate-from-v1/).\n\nWant the full story? Watch the GrafanaCON 2026 talk [_Pyroscope 2.0: Continuous Profiling Architecture Deep Dive_](https://www.youtube.com/watch?v=vseSm-pzgmc).\n\n## What is Grafana Pyroscope?\n\nGrafana 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.\n\nThe typical use cases are:\n\n- **Proactive:** Reducing resource consumption, improving application performance, or preventing latency issues.\n- **Reactive:** Quickly resolving incidents with line-level detail and debugging active CPU, memory, or I/O bottlenecks.\n\nPyroscope 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.\n\n## How Does Pyroscope Work?\n\n\n\nPyroscope consists of three main components:\n- **Pyroscope Server:** Stores and processes profiling data and serves queries.\n- **Clients and instrumentation:** Profiling data reaches the server in several ways: the [Pyroscope SDKs](https://grafana.com/docs/pyroscope/latest/configure-client/language-sdks/) (push), [Grafana Alloy](https://grafana.com/docs/pyroscope/latest/configure-client/grafana-alloy/) (pull or push), or OTLP from OpenTelemetry-compatible sources such as the [OpenTelemetry eBPF profiler](https://grafana.com/docs/pyroscope/latest/configure-client/opentelemetry/ebpf-profiler/).\n- **Grafana Profiles Drilldown:** A queryless, intuitive UI for visualizing and analyzing profiling data (formerly Explore Profiles).\n\nUnder 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](https://grafana.com/docs/pyroscope/latest/reference-pyroscope-v2-architecture/).\n\n**Write path** — profiles are routed by service and written straight to object storage:\n\n\n\n**Compaction** — compaction-workers merge small segments into larger blocks in the background:\n\n\n\n**Read path** — queries fan out across object storage to build flame graphs in Grafana Profiles Drilldown:\n\n\n\n---\n\n## [Pyroscope Live Demo](https://play.grafana.org/a/grafana-pyroscope-app/explore)\n\n[](https://play.grafana.org/a/grafana-pyroscope-app/explore)\n\n\n---\n\n## **Quick Start: Run the Pyroscope server locally**\n\n### Docker\n```sh\ndocker run -it -p 4040:4040 grafana/pyroscope\n```\n\n### Homebrew (macOS / Linux)\n```sh\nbrew install pyroscope-io/brew/pyroscope\nbrew services start pyroscope\n```\n\n### Binary\nDownload the archive for your operating system and architecture from the [latest release](https://github.com/grafana/pyroscope/releases/latest), unpack it, and run the binary:\n```sh\ntar xvf pyroscope_*.tar.gz\n./pyroscope\n```\n\nPyroscope listens on port `4040`. For Kubernetes/Helm, Linux packages, building from source, and full configuration options, see the [Get started guide](https://grafana.com/docs/pyroscope/latest/get-started/) and the [server documentation](https://grafana.com/docs/pyroscope/latest/configure-server/).\n\n## **Quick Start: Visualize profiles with Grafana Profiles Drilldown**\n\n\n\n[Grafana Profiles Drilldown](https://grafana.com/docs/grafana/latest/visualizations/simplified-exploration/profiles/) (formerly Explore Profiles) is the primary, queryless way to visualize and analyze your profiling data.\n\n### Grafana Cloud / OSS\nProfiles Drilldown is pre-installed and is the default way to explore your profiles – all you need to do is start sending data.\n\n## Documentation\n\nFor 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:\n\n* [Getting Started](https://grafana.com/docs/pyroscope/latest/get-started/)\n* [Deployment Guide](https://grafana.com/docs/pyroscope/latest/deploy-kubernetes/)\n* [Pyroscope v2 Architecture](https://grafana.com/docs/pyroscope/latest/reference-pyroscope-v2-architecture/)\n\n## Send data to the server\n\nYou can send profiles to Pyroscope with the language SDKs, with [Grafana Alloy](https://grafana.com/docs/pyroscope/latest/configure-client/grafana-alloy/), or over OTLP from OpenTelemetry-compatible sources such as the [OpenTelemetry eBPF profiler](https://grafana.com/docs/pyroscope/latest/configure-client/opentelemetry/ebpf-profiler/).\n\nFor more documentation on how to add the Pyroscope SDK to your code, see the [client documentation](https://grafana.com/docs/pyroscope/latest/configure-client/) on our website or find language-specific examples and documentation below:\n
![\"\"/](\"https://user-images.githubusercontent.com/23323466/178160549-2d69a325-56ec-4e19-bca7-d460d400b163.png\")
![\"\"/](\"https://user-images.githubusercontent.com/23323466/178160550-2b5a623a-0f4c-4911-923f-2c825784d45d.png\")
![\"\"/](\"https://user-images.githubusercontent.com/23323466/178160553-c78b8c15-99b4-43f3-a2a0-252b6c4862b1.png\")
![\"\"/](\"https://user-images.githubusercontent.com/23323466/178160554-b0be2bc5-8574-4881-ac4c-7977c0b2c195.png\")
![\"\"/](\"https://user-images.githubusercontent.com/23323466/178160551-a79ee6ff-a5d6-419e-89e6-39047cb08126.png\")