← Explore all skills

OBSERVABILITY / grafana

Profilecli Source Insights

Retrieve Pyroscope profiles and map hot functions to the corresponding source checkout.

“Query live Pyroscope profiles with profilecli, analyze them with pprof, and correlate hot functions with checked-out source code. …”

01 / THE REASONING

Why this made the selection.

  • It queries an existing Pyroscope server with profilecli and maps hot functions back to this checkout only when the module path matches.
  • PROFILECLI_URL is mandatory, and third-party frames are reported without pretending their source is in the repo.
  • The procedure discovers profile types rather than assuming them, matches service_repository with origin, and checks git_ref before line-level recommendations.
  • Separate flat self-time from cumulative callee time

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/profilecli-insights/SKILL.md
  • README.md
  • LICENSE

Our findings

  • The procedure says not to skip steps, starting with whether profilecli is installed.
  • PROFILECLI_URL is required and may be http://localhost:4040 or a Grafana datasource proxy that also needs PROFILECLI_TOKEN.
  • Third-party or runtime frames are still reported, but their source cannot be read from this checkout.
  • The skill does not treat a module path with an @version suffix as this repository.
  • The procedure discovers profile types rather than assuming them, matches service_repository with origin, and checks git_ref before line-level recommendations.
  • Service discovery compares service_repository with the checkout remote and requires a user choice when the question cannot be mapped clearly to a service.

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 ↗

DOCUMENTED COMMAND

npx skills add grafana/skills/skills/grafana-lgtm/profilecli-insights

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.

Optional: install the reviewed revision

Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.

npx skills add https://github.com/grafana/skills/tree/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-lgtm/profilecli-insights
  1. Install the pinned skill directory interactively, retaining its bundled references and scripts.
  2. Verify profilecli and pprof or go tool pprof; discover available profile types and services.
  3. Configure PROFILECLI_URL and the appropriate Viewer service-account access for the Grafana datasource proxy, with a tenant ID where required.
  4. Download a bounded profile window, compare repository/build identity and inspect matching source.

Before you start

  • profilecli and pprof or Go
  • Authorized read access to a Pyroscope-compatible server
  • The relevant source checkout

04 / FOLLOW THE EVIDENCE

The source trail.

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

  1. Pinned skill definition ↗Checked

    https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-lgtm/profilecli-insights/SKILL.md

    Supports: summary, whySelected, bestFor, limitations, install, access, review

  2. https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md

    Supports: install

  3. Apache-2.0 licence ↗Checked

    https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE

    Supports: license

  4. https://raw.githubusercontent.com/grafana/skills/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-lgtm/profilecli-insights/SKILL.md

    Supports: review.findings, bestFor, upstreamDescription

Evidence & Ask