# fleet-management

> Claude/Codex skill by [@grafana](https://omgskills.com/library/grafana/index.md) · 286 stars · 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

```sh
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.

## Links

- HTML page: https://omgskills.com/library/grafana/skills/fleet-management/
- 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