Menu
Grafana Cloud

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. For bug reports or questions, fill out our feedback form.

Use a Grafana Cloud integration template to create a configuration pipeline

Grafana Fleet Management supports several Grafana Cloud integrations. You can generate pre-configured templates from these integrations and use the templates to configure your fleet remotely and at scale.

Before you begin

To use integrations to create configuration pipelines in Fleet Management, you should:

  • Have a Grafana Cloud account.
  • Have administrator privileges and the ability to create and edit access policies.
  • Update Grafana Alloy to the most current version. Fleet Management must be used with Alloy collectors.
  • Understand the key terms and concepts of Fleet Management and how the service works.
  • Make sure that you’ve completed the Before you begin requirements for the integration you’re using. You can find these prerequisites in Integrations reference.

Select an integration template

  1. In your Grafana Cloud stack, click Connections > Collector > Fleet Management and then switch to the Remote configuration tab.
  2. Click Create configuration pipeline.
  3. Select the platform of the host where Alloy is running.
  4. Search or browse for an integration.
  5. Select the integration you want to add and click Next. The Fleet Management application prefills a name for the configuration pipeline by combining the name of the integration and the platform.
  6. Review the content of the new configuration pipeline and make any changes you might require.
    • You must replace any variables used in the pipeline with your own details. These variables are usually enclosed in angle brackets, for example <your-cluster-name> or <your-instance-name>.
    • Make sure that any environment variables used in the pipeline are set wherever Alloy is running, for example GCLOUD_RW_API_KEY.
    • The Fleet Management application automatically appends a remote_write component to the integration configuration, so you do not need to add one to complete the pipeline.
  7. Click Test configuration pipeline to validate the configuration syntax. The pipeline editor provides real-time feedback on the syntactic validity of the configuration content.
  8. Click Next to assign the configuration pipeline to collectors or click Save to save an incomplete pipeline.

Assign the configuration pipeline

Configuration pipelines are incomplete until you add matching attributes that assign them to collectors.

Note

If you saved an incomplete configuration, click the Edit icon from the Configuration pipeline list to return to the Define a configuration pipeline page.

  1. Click Next on the Define a configuration pipeline page.
  2. Use the dropdown menus to create a matching attribute. The Collector list updates in real time to show you which collectors have been assigned the configuration pipeline.
  3. Continue adding matching attributes as needed. GetConfig polling requests to the API can accept a maximum of 15 attributes.
  4. Click Save to activate the configuration pipeline and return to the Configuration pipeline list.
  5. Activate or deactivate a configuration pipeline with a click of the Active switch.