Documentation Grafana Cloud Instrument and send data Fleet Management Set up Configuration pipelines Create a custom pipeline

Create a custom configuration pipeline

With configuration pipelines, you can control collector behavior remotely and at scale. Configuration pipelines are made up of a unique name, a content body, and matching attributes. This page explains how to write your own Alloy configuration pipelines in the Grafana Fleet Management interface.

Before you begin

To create configuration pipelines in Fleet Management, you should:

• Have a Grafana Cloud account.
• Have administrator privileges and the ability to create and edit access policies.
• Update Grafana Alloy to the most current version. Fleet Management must be used with Alloy collectors.
• Understand the key terms and concepts of Fleet Management and how the service works.

Define the configuration pipeline

1. In your Grafana Cloud stack, click Connections > Collector > Fleet Management and then switch to the Remote configuration tab.
2. Click Create configuration pipeline.
3. Click Custom configuration and then Next.
4. Enter a unique name for the pipeline.
5. Insert one or more configuration snippets to create a pipeline. You can create your own using Alloy configuration syntax or select one of the snippets for Grafana Cloud integrations.
6. Make sure the pipeline is complete. Each pipeline must be self contained and have the necessary components to send telemetry over the network to persistent storage. Components cannot be reused across pipelines.
7. Click Test configuration pipeline to validate the configuration syntax. The pipeline editor provides real-time feedback on the syntactic validity of the configuration content.
8. Click Next to assign the configuration pipeline to collectors or click Save to save an incomplete pipeline.

Assign the configuration pipeline

Configuration pipelines are incomplete until you add matching attributes that assign them to collectors.

1. Click Next on the Define a configuration pipeline page.
2. Use the dropdown menus to create a matching attribute. The Collector list updates in real time to show you which collectors have been assigned the configuration pipeline.
3. Continue adding matching attributes as needed. GetConfig polling requests to the API can accept a maximum of 15 attributes.
4. Click Save to activate the configuration pipeline and return to the Configuration pipeline list.
5. Activate or deactivate a configuration pipeline with a click of the Active switch.