# pyroscope

> Claude/Codex skill by [@grafana](https://omgskills.com/library/grafana/index.md) · 286 stars · Updated 2026-10-17

Continuously profile applications with Grafana Pyroscope and read the result as flame graphs. Covers three instrumentation paths — language SDK push (Go / Java / Python / Ruby / Node / .NET / Rust), Alloy eBPF auto-instrumentation (no code change, requires kernel 5.8+ with BTF), and SDK → Alloy receiver — plus ProfileQL queries, profile types (CPU / memory / allocations / goroutines / mutex), Grafana Cloud Profiles endpoint, and Span Profiles trace-to-profile linking. Use when adding profiling to a service, deploying Alloy as a cluster-wide eBPF profiler, hunting CPU / memory hotspots from a flame graph, comparing two profiles to find a regression, or correlating a slow Tempo trace to its profile — even when the user says "find what's burning CPU", "flame graph this app", "continuous profiling", "heap hotspots", or "why is allocation so high" without naming Pyroscope.

## Install

```sh
git clone https://github.com/grafana/skills /tmp/skills && ln -s /tmp/skills/skills/grafana-lgtm/pyroscope ~/.claude/skills/pyroscope
```

## From README

Grafana Pyroscope Docs: https://grafana.com/docs/pyroscope/latest/ Continuous profiling — flame graphs of CPU, memory, allocations, mutex contention, goroutines. Prerequisites Pyroscope server (OSS) or Grafana Cloud Profiles endpoint For Cloud: numeric Pyroscope user (stack id) + API key For eBPF via Alloy: root + host PID + Linux ≥ 5.8 with BTF (or RHEL 4.18+) Instrumentation paths Alloy eBPF (preferred) — auto-instrument, no code change SDK direct push — application calls Pyroscope API SDK → Alloy — SDK posts to pyroscope.receivehttp, Alloy forwards Common Workflows Instrument an app with the SDK (representative: Python) Other SDKs (Java agent, Node, Ruby, .NET, Rust) + Cloud auth + tunable env vars: references/sdks.md. Cluster-wide eBPF profiling with Alloy Query with ProfileQL Profile-type list + full ProfileQL grammar: references/ebpf-and-query.md.

## Links

- HTML page: https://omgskills.com/library/grafana/skills/pyroscope/
- GitHub: https://github.com/grafana/skills
- Author: [@grafana](https://omgskills.com/library/grafana/index.md)

## More from this repo

- [k6-docs](https://omgskills.com/library/grafana/skills/k6-docs/index.md) — Used to write or review k6 documentation across the three k6 repositories - k6-DefinitelyTyped (TypeScript types),...
   - [@grafana](https://omgskills.com/library/grafana/index.md) · 295 stars
- [adaptive-metrics](https://omgskills.com/library/grafana/skills/adaptive-metrics/index.md) — Cut Grafana Cloud Metrics cost by shrinking active-series count with Adaptive Metrics aggregation rules —...
   - [@grafana](https://omgskills.com/library/grafana/index.md) · 286 stars
- [admin](https://omgskills.com/library/grafana/skills/admin/index.md) — Used to manage Grafana Cloud accounts — organizations, stacks, RBAC roles and assignments, SSO/SAML/OAuth/GitHub auth,...
   - [@grafana](https://omgskills.com/library/grafana/index.md) · 286 stars