Download for MacApple silicon, macOS 14+
Skill

fleet-management

@grafana Updated 2026-10-17

Manage a fleet of Grafana Alloy collectors with Fleet Management — author Alloy pipelines once, target them via attribute matchers (`env="production"`, regex `region=~"us-.*"`), push remotely via OpAMP without restarting collectors. Covers pipeline create / update / matcher RPCs, collector attribute API, `remotecfg` bootstrap block (standalone + Helm), pre-deploy `alloy fmt` validation, the local Alloy UI at port 12345 for component health, and post-deploy `REMOTE_CONFIG_STATUS_APPLIED` verification. Use when standing up a Cloud Alloy fleet, pushing a config change to 200 collectors, hunting why one collector shows `REMOTE_CONFIG_STATUS_FAILED`, validating River syntax before saving, or wiring `discovery.kubernetes` → `prometheus.remote_write` — even when the user says "configure Alloy", "remote config the collectors", "push pipeline", "OpAMP", "collector is unhealthy", or "manage agent config centrally" without naming Fleet Management.

Install

With your agent

Install OMGSkills skill "grafana/skills:fleet-management" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.

Manual command

git clone https://github.com/grafana/skills /tmp/skills && ln -s /tmp/skills/skills/grafana-cloud/fleet-management ~/.claude/skills/fleet-management

From README

Grafana Fleet Management + Alloy Configuration Docs: https://grafana.com/docs/grafana-cloud/send-data/fleet-management/ Remote pipeline distribution to Alloy collectors via OpAMP — author once, target with matchers, hot-apply (no restart). Prerequisites Grafana Cloud stack with Fleet Management enabled API token with Fleet Management access (Authorization: Bearer : ) Alloy ≥ 1.0 installed on the targets (standalone or via grafana/alloy Helm chart) alloy CLI locally for alloy fmt syntax validation Concepts Collector — Alloy instance with unique ID + attributes Pipeline — named Alloy River config stored in Fleet Management Matcher — selector mapping a pipeline to collectors by attribute Attributes — key/value labels on a collector (env, team, region) Common Workflows Author + validate + deploy a pipeline Troubleshoot a REMOTECONFIGSTATUSFAILED collector Failure-message decoder table: references/api.md.