Documentation Grafana Cloud Instrument and send data Fleet Management Manage your fleet Pipelines Check pipeline operation

Check the operation of your configuration pipelines

Configuration pipelines are a cornerstone feature of Grafana Fleet Management. They not only allow you to remotely configure your collectors but also afford you greater control over how and when a collector is configured. In this section, learn to check how a pipeline is functioning.

Validate configuration syntax

Fleet Management has a built-in Grafana Alloy configuration syntax validator.

1. In your Grafana Cloud instance, click Connections > Collector > Fleet Management.
2. On the Remote configuration tab, click Add configuration pipeline.
3. Name your pipeline and type or paste your Alloy configuration. If Fleet Management detects a problem in the syntax, an error message displays immediately in the application window. You can also use Grafana Assistant to validate and optimize your configuration pipelines. Click the Assistant button to explain, validate, optimize, or visualize the pipeline. If you don’t see the Assistant button, it hasn’t been enabled on your stack. Contact your administrator for more details.
4. After clearing all errors, click Test configuration pipeline to verify a valid syntax.

See the remote configuration running on a collector

You can combine configuration pipelines in any way that suits your observability needs, which means collectors might receive multiple configuration pipelines. In the Fleet Management interface, you can see the entire remote configuration—including all configuration pipelines—assigned to a collector.

1. In your Grafana Cloud instance, click Connections > Collector > Fleet Management.

2. On the Inventory tab, search, filter, or sort to find the collector.

3. Click on the collector ID to open the details view.

4. Click on the Configuration tab. For Alloy v1.12.0 or later, this tab displays the read-only effective configuration assigned to and running on the collector. If you’ve recently made changes to one of the configuration pipelines matched to the collector, you see both the effective configuration and the server configuration until the collector polls for and successfully loads the updated configuration. A status banner at the top of the tab indicates whether the server configuration has been successfully applied, is pending rollout, or can’t be applied due to errors.

   If you are running a version of Alloy older than 1.12.0, the Configuration tab displays the server configuration only.

5. To see the configuration pipelines that make up the remote configuration, expand the Connected pipelines panel.

Monitor configuration load performance by collector

You can monitor the load performance of a remote configuration by viewing the corresponding dashboard in a matching collector’s details view Health tab.

1. On the Inventory tab, click on a collector ID to open the details view.
2. On the Health tab, choose Remote Configuration from the Alloy health dashboards dropdown menu. The panels tell you the configuration’s last load status and load status over time, and they report logs with remote configuration errors.

Check component performance

You can use Alloy internal telemetry to check the health status of running components. To see this telemetry, click on the collector in the Inventory tab to open its details view.

Fleet Management does not confirm data flows between components for application telemetry. The details view might provide some debugging information, for example, if a log is emitted when a component is unavailable. For a more comprehensive check of the performance of these components, refer to Debug Grafana Alloy.