fleet-management

Manage and deploy Alloy pipeline configurations to Fleet Management collectors.

213|18|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/grafana/skills --skill fleet-management-grafana
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fleet-management
Source: https://github.com/grafana/skills/tree/main/skills/grafana-cloud/fleet-management
Command: npx skills add https://github.com/grafana/skills --skill fleet-management-grafana

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Fleet Management and Alloy configuration are complex at scale because teams must distribute, update, and validate collector pipeline configurations across many hosts without restarting agents, and they need a safe way to target, roll out, and troubleshoot remote configs.

Core Features & Use Cases

  • Remote pipeline distribution: Create and update named Alloy pipeline configurations and deliver them to matching collectors via Fleet Management.
  • Targeting and staged rollouts: Use matchers and collector attributes to target pipelines to specific environments, teams, or canary hosts for safe rollouts.
  • Troubleshooting and validation: Inspect collector remoteConfig status, interpret error messages, validate Alloy River syntax, and roll back revisions when needed.
  • Use Case: Deploy a new Prometheus scrape pipeline to production nodes, validate in a canary collector, and then expand to the fleet while monitoring remoteConfigStatus and logs.

Quick Start

List all collectors with REMOTE_CONFIG_STATUS_FAILED and summarize each remoteConfigStatusMessage so I can prioritize fixes.

Frequently Asked Questions about fleet-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy Alloy pipeline configurations to collectors remotely at scale?

You can deploy Alloy pipeline configurations remotely at scale by creating named pipelines and delivering them to matching collectors via Grafana Cloud Fleet Management, avoiding the need to restart agents on individual hosts.

How do I target Alloy collector pipelines to specific environments or canary hosts?

You can target Alloy collector pipelines to specific environments or canary hosts by assigning matchers and updating collector attributes, enabling safe staged rollouts across your fleet.

How do I troubleshoot remote configuration errors for Alloy collectors?

You can troubleshoot remote configuration errors for Alloy collectors by inspecting the remoteConfig status, interpreting remoteConfigStatusMessage errors, and filtering for collectors with a REMOTE_CONFIG_STATUS_FAILED state to prioritize fixes.

Can I validate Alloy River syntax before rolling out pipeline configurations to the fleet?

Yes, you can validate Alloy River syntax before rolling out pipeline configurations to the fleet, ensuring remote configs are syntactically correct and preventing deployment failures across matching collectors.

How do I roll back a failed pipeline configuration revision for Alloy collectors?

You can roll back a failed pipeline configuration revision for Alloy collectors by reverting to a previous revision through Fleet Management, which safely restores the prior valid remote configuration state.