Caution

Grafana Alloy is the new name for our distribution of the OTel collector. Grafana Agent has been deprecated and is in Long-Term Support (LTS) through October 31, 2025. Grafana Agent will reach an End-of-Life (EOL) on November 1, 2025. Read more about why we recommend migrating to Grafana Alloy.

Documentationbreadcrumb arrow Grafana Agentbreadcrumb arrow Flow modebreadcrumb arrow Tasksbreadcrumb arrow Configure Grafana Agent clustering
Open source

Configure Grafana Agent Flow clustering in an existing installation

You can configure Grafana Agent Flow to run with clustering so that individual Grafana Agents can work together for workload distribution and high availability.

This topic describes how to add clustering to an existing installation.

Configure Grafana Agent Flow clustering with Helm Chart

This section guides you through enabling clustering when Grafana Agent Flow is installed on Kubernetes using the Grafana Agent Helm chart.

Before you begin

  • Ensure that your values.yaml file has controller.type set to statefulset.

Steps

To configure clustering:

  1. Amend your existing values.yaml file to add clustering.enabled=true inside the agent block.

    YAML 
    agent:
  clustering:
    enabled: true

  2. Upgrade your installation to use the new values.yaml file:

    Bash 
    helm upgrade <RELEASE_NAME> -f values.yaml

    Replace the following:

    • <RELEASE_NAME>: The name of the installation you chose when you installed the Helm chart.

  3. Use the Grafana Agent Flow UI to verify the cluster status:

    1. Click Clustering in the navigation bar.

    2. Ensure that all expected nodes appear in the resulting table.