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

Create a custom OpenTelemetry Collector 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 create a custom pipeline for OpenTelemetry Collector in the Grafana Fleet Management interface. Type or paste an OpenTelemetry Collector YAML configuration in the configuration editor and then add matching attributes to assign it to specific collectors.

You can also create pipelines from a template. Refer to the integration template setup guide to use a pre-built pipeline.

Before you begin

To create configuration pipelines in Fleet Management, you should:

• Have a Grafana Cloud account.
• Have administrator privileges or the ability to create and edit configuration pipelines. Refer to Roles and permissions in Fleet Management for more information.
• Have at least one OpenTelemetry Collector onboarded to Fleet Management using the OpAMP Supervisor.
• Understand the key terms and concepts of Fleet Management and how the service works.

Define the configuration pipeline

Write a complete OpenTelemetry Collector configuration in YAML and save it as a pipeline.

1. In your Grafana Cloud stack, click Connections > Fleet Management and then switch to the Remote configuration tab.
2. Click Create configuration pipeline.
3. Select the OpenTelemetry collector type.
4. Click Custom configuration and then Next.
5. Enter a unique name for the pipeline.
6. In the configuration editor, write your OpenTelemetry Collector YAML configuration. The configuration must be valid. Refer to OpenTelemetry Collector configuration for more details.
7. Click Test configuration pipeline to verify the syntax is valid.
8. Click Next to assign the configuration pipeline to collectors or click Save draft to save an incomplete pipeline.

Assign the configuration pipeline

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.