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 and is recommended for use with Alloy v1.7.2 or later. If you’re using an earlier version, make sure to include the --stability.level=public-preview flag when running Alloy.
• 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.

   Note

   Components can be reused across pipelines with an advanced Fleet Management feature: pipeline export injection.

7. If you want to label the telemetry you collect, inject collector attributes into the pipeline.

8. Scroll down to click Test configuration pipeline to validate the configuration syntax. The pipeline editor provides real-time feedback on the syntactic validity of the configuration content. If an error is reported, you can make the fix yourself or click the Assistant button and select Fix errors in Assistant.

   Note

   If you don’t see the Grafana Assistant button or the button is disabled, Assistant has not been enabled on your stack. Contact your stack administrator for more details.

9. To understand how your pipeline works, the different components in use, and potential areas for optimization, click the Assistant button. You can choose to have Grafana Assistant explain the pipeline, validate the syntax or fix errors if there are any, optimize the configuration, or create a diagram of the pipeline.

10. 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.

Next steps

Now that you’ve started remotely configuring your fleet, learn how to streamline your workflows and track historical changes to your configuration pipelines.