Documentation Grafana Cloud Instrument and send data Fleet Management Manage your fleet Collectors Troubleshoot Remote config errors

Troubleshoot remote configuration errors

When a configuration pipeline has an error, Grafana Fleet Management helps you identify the affected collectors in several ways:

• On the Inventory tab, collectors with pipeline errors have a red health status that indicates an error has occurred and they are unhealthy.
• You might also see error logs on the Logs tab in the collector details view. These logs report the collector’s failure to fetch the remote configuration.
• Finally, you can also use the Remote Configuration dashboard on the Health tab in the details view to monitor how successfully a collector loads its remote configuration over time. The dashboard includes panels for the last configuration load status, the load success rate, and configuration error logs. It’s useful for identifying intermittent remote configuration load failures or confirming that a fix has resolved an issue.

Troubleshoot with Grafana Assistant

When a collector has a configuration pipeline error, a Troubleshoot in Assistant icon appears beside its health status indicator on the Inventory tab. You can click this icon to open Grafana Assistant with the collector’s configuration and error details pre-loaded. The assistant automatically analyzes the errors, explains the root cause of each one, and suggests specific fixes with corrected configuration examples.

1. In your Grafana Cloud instance, click Connections > Collector > Fleet Management.
2. On the Inventory tab, find the collector with a red (Error) status.
3. Click the Troubleshoot in Assistant icon next to the status indicator. Grafana Assistant opens and automatically sends a prompt that analyzes the configuration errors.
4. Review the suggested fixes and apply them to the relevant pipeline(s) on the Remote configuration tab.

Manually troubleshoot configuration errors

You can also troubleshoot errors in the Fleet Management application manually. To learn more about a configuration error, go to the Remote configuration tab in the collector details view of an affected collector. When an error is present, you can see an expandable error panel that includes diagnostic details. Follow these steps to troubleshoot the configuration error without leaving the application.

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

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

3. Click on the collector ID to open the details view, which takes you directly to the Configuration tab.

4. If configuration errors are present, an error panel appears at the top of the tab.

5. Expand the Configuration Error(s) panel to see diagnostic details, including:

   • Error messages describing what went wrong.
   • Line and column numbers indicating where each error occurs in the remote configuration.

6. In the read-only remote configuration, find the line that corresponds to the error.

7. Scan backward in the configuration until you find the name of the erroring pipeline. Pipelines are named in a declare block. For example, the self-monitoring logs pipeline for Linux systems is named like this:

   Alloy Copy

   declare "self_monitoring_logs_linux" {

8. Once you know which pipeline caused the error and how to fix it, expand the Connected Pipelines section and click on the pipeline in the list. The link takes you straight to the pipeline editor, where you can make the necessary changes.