---
title: "Grafana Pyroscope: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/grafana-pyroscope/
description: "Select SDK or Alloy profiling and inspect service-specific CPU, allocation and contention profiles."
---

# Grafana Pyroscope: review, setup & limitations · Undominated.ai

> Select SDK or Alloy profiling and inspect service-specific CPU, allocation and contention profiles.

[← Explore all skills](/skills/)

OBSERVABILITY / Grafana Labs

# Grafana Pyroscope

Select SDK or Alloy profiling and inspect service-specific CPU, allocation and contention profiles.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/grafana/skills/tree/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-lgtm/pyroscope)

SOURCE REVIEW

 Reviewed 2026-10-15
 Evidence 4 linked sources
 Publisher Grafana Labs
 Licence [Apache-2.0 ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE)
 Revision 1ccacf29049f
 [Read what was—and wasn’t—checked ↓](#review)

“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. …”

 [Grafana Labs · upstream description ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-lgtm/pyroscope/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - It instruments an application for Grafana Pyroscope, either against a local server on port 4040 or Grafana Cloud with a numeric user and API key.
- A ready check and a labels query are the local proof that profiles arrived; Cloud still needs the stack id.
- The definition distinguishes three instrumentation paths, profile-type selectors and receiver versus application connectivity checks.
- Investigate CPU or allocation hotspots with the appropriate profile type

### A good fit for

 - Adding Pyroscope SDK or eBPF profiling and checking that samples reach a local server
- Investigate CPU or allocation hotspots with the appropriate profile type
- Connect application profiles with trace context where supported
- Diagnose profiles without frames separately from missing profile ingestion.

### Weigh up before choosing

 - The skill does not grant Cloud access; it requires a numeric Pyroscope user and an API key.
- The eBPF path is a separate Alloy configuration, not the Python SDK snippet.
- This review did not curl the ready endpoint or reload Alloy.
- This review did not execute the resource.
- Readiness or the existence of a label does not prove the target service supplied useful profiles; inspect its frames and time interval.
- eBPF collection needs host-level privileges and compatible kernel/runtime support; SDK support and available profile types vary by language.
- The pinned Python SDK and profile examples are source guidance, not a tested deployment.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - skills/grafana-lgtm/pyroscope/SKILL.md
- README.md
- LICENSE

### Our findings

 - The Python example pushes to http://pyroscope:4040 and then checks /ready and /api/v1/labels.
- Grafana Cloud needs a numeric stack id and an API key, which the skill does not embed.
- Cluster-wide profiling is eBPF through Alloy, with a reload against http://localhost:12345.
- The skill does not query ProfileQL results as a substitute for the service appearing in Grafana.
- The definition distinguishes three instrumentation paths, profile-type selectors and receiver versus application connectivity checks.
- The troubleshooting section distinguishes an absent profile from a profile without frames, with separate Java format and Python-on-Alpine compatibility checks.

### Not established by this review

 - The resource was not executed and its tools were not called.
- No skill execution, authenticated service operation, or outcome benchmark was performed.
- Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md)

DOCUMENTED COMMAND

 npx skills add grafana/skills --skill pyroscope Copy command ↗

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

 - The README documents npx skills add grafana/skills --skill <name>. The table names this skill pyroscope.
- That command does not pin revision 1ccacf29049fde66637fe01ab93a83a772da323b. Inspect the installed SKILL.md against that revision before use.
- Do not apply the eBPF example on a host you are not authorised to profile.

### Before you start

 - Node.js and npm for the documented Skills installer
- A Pyroscope server or Grafana Cloud Profiles endpoint only if you run the instrumentation examples

### Compatibility

Agent Skills-compatible hosts · Grafana Pyroscope · Grafana Alloy

### Local instructions; runtime access depends on the workflow

 - Read runtime profiles, change SDK/collector settings and transmit profiling data; eBPF paths inspect host processes.

### Cost model

The skill is free; service usage and infrastructure can incur charges.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Pinned skill definition ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-lgtm/pyroscope/SKILL.md) Checked 2026-10-14 https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-lgtm/pyroscope/SKILL.md Supports: summary, whySelected, bestFor, limitations, install, access, review
- [Publisher repository and installation guidance ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md) Checked 2026-10-14 https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md Supports: install
- [Apache-2.0 licence ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE) Checked 2026-10-14 https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE Supports: license
- [Pinned continuation review C2-W27 ↗](https://raw.githubusercontent.com/grafana/skills/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-lgtm/pyroscope/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/grafana/skills/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-lgtm/pyroscope/SKILL.md Supports: review.findings, bestFor, upstreamDescription

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Elasticsearch Cluster Health ↗ Triage unassigned Elasticsearch shards through allocation evidence.](/skills/elastic-elasticsearch-cluster-health/)[### Elasticsearch ES|QL ↗ Pins Elastic's ES|QL skill, which routes queries through the elastic CLI and refuses to treat a Serverless build number as a feature gate.](/skills/elastic-esql/)[### Grafana App Admission Control ↗ Implement validators and mutators for Grafana app resources before persistence.](/skills/grafana-admission-control/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
