Menu
Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Instrument and send databreadcrumb arrow Fleet Managementbreadcrumb arrow Get started
Grafana Cloud RSS

Note

Fleet Management is currently in public preview. Grafana Labs offers limited support, and breaking changes might occur prior to the feature being made generally available.

Get started with Fleet Management

Grafana Fleet Management is a Grafana Cloud tool for managing collector instances at scale. You can use it to streamline the configuration and monitoring of your collectors, saving you time and effort.

We’ll guide you through getting started with Fleet Management. You’ll install a new instance of Grafana Alloy that is enabled with Fleet Management, and once it’s up and running, you’ll see your new collector in Fleet Management’s inventory, where you can monitor and remotely configure it. If you’d like to try Fleet Management with existing collectors, refer to Onboard existing collectors.

Before you begin

Fleet Management is available as a Grafana Cloud add-on that must be used with Alloy collectors. Before you get started, make sure you have:

  • A Grafana Cloud account.
  • Administrator privileges and the ability to create and edit access policies.
  • Deactivated any configuration pipelines previously created in Fleet Management that might match to your new collector’s attributes. Make sure to set any environment variables that a configuration pipeline requires before reactivating it.

Install Alloy

Install a new Alloy instance and make it discoverable in Fleet Management.

  1. In your Grafana Cloud stack, click Connections > Collector > Install Grafana Alloy in the left-side menu.
  2. On the Installation tab, choose your platform.
  3. Follow the on-screen instructions to complete your installation. Make sure the Enable Remote Configuration switch is on. The installation scripts install and start Alloy and create an Alloy configuration file with a remotecfg block.

Your new collector is up and running, and it’s registered with Fleet Management.

View your collector in Fleet Management

Go to the Fleet Management interface to see your collector at work.

  1. In your Grafana Cloud stack, click Connections > Collector > Fleet Management in the left-side menu.
  2. On the Inventory tab, find your collector in the Collector list.
  3. Check the operational status of your collector by looking in the Status column. A green checkmark means your collector is working properly.
  4. Click anywhere in your collector’s row to bring up the details view. The screen defaults to the Health tab. Within a few minutes, you can see your collector’s health statistics as its configured components begin to process telemetry.
  5. Switch to the Logs tab in the details view to see your collector’s internal logs.
  6. Close the details view and switch to the Remote configuration tab in Fleet Management. Here you can see the autogenerated configuration pipelines, beginning with self_monitoring_, that are assigned to your collector.
  7. Click the Edit icon for one of these configurations to see its contents and the matching attributes it uses.

Next steps

You installed a new collector, registered it with Fleet Management, and explored the Fleet Management interface. If you’d like to learn more, refer to the documentation for onboarding existing collectors, creating configuration pipelines, and monitoring your collectors’ health.