Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Instrument and send databreadcrumb arrow Fleet Managementbreadcrumb arrow Set upbreadcrumb arrow Configuration pipelinesbreadcrumb arrow Configuration deployment strategies
Grafana Cloud

Configuration deployment strategies

Configuration in Grafana Fleet Management is a powerful and flexible tool for managing collectors at scale. Learn how to optimize your configuration deployments for your unique observability setup.

Remote configuration only

If you want to configure your collectors fully remotely, you can move the contents of local configuration files to configuration pipelines in Fleet Management and add the remotecfg block to the empty local configuration files.

This method gives you maximum control over which configuration pipelines are in use. Turn pipelines off with a click of the switch. Combine them using matching attributes to build complete remote configurations based on each collector’s characteristics and your observability needs.

Hybrid configuration

If you want to continue configuring some parts of your collectors locally, add the remotecfg block to the end of each local configuration file. You can create supplemental configuration pipelines in Fleet Management that run in parallel with the local configuration.

Local configuration only

Although configuration pipelines are a central feature of Fleet Management, they are optional. You can choose to configure your collectors locally and use Fleet Management only to monitor their status.

Disable remote configuration

Turn off autogenerated self-monitoring pipelines to disable remote configuration.

Caution

Disabling the autogenerated pipelines limits your ability to monitor your collector fleet. Without these pipelines, collectors don’t send their internal telemetry to Fleet Management, and the application interface can’t display any data in the health dashboards and logs panel of the collector details view. If you want to see health monitoring data in Fleet Management, you must adjust your local configuration as described in the following task.

  1. Add the remotecfg block to your local configurations to register your collectors with the Fleet Management service.
  2. In your Grafana Cloud stack, click Connections > Collector > Fleet Management.
  3. Confirm that your registered collectors appear in the Inventory tab.
  4. Switch to the Remote configuration tab.
  5. Disable the autogenerated self-monitoring configuration pipelines by turning the Active switch off.
  6. To see health and status information in Fleet Management, make sure to add the collector_id label to your local configurations. Without this label, Fleet Management cannot correlate health data with a collector. You can add collector_id as an external label on all remote_write components, or you can create more targeted configuration pipelines to collect internal logs and metrics, adding the collector_id label only to those pipelines. The value of the collector_id label must match the id set in the remotecfg block.