Grafana Agent Flow mode Get started Configure Grafana Agent clustering
Open source

Configure Grafana Agent clustering

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

Note: Clustering is a beta feature. Beta features are subject to breaking changes and may be replaced with equivalent functionality that covers the same use case.

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

Configure Grafana Agent clustering with Helm Chart

This section will guide you through enabling clustering when Grafana Agent 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.


To configure clustering:

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

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

    helm upgrade RELEASE_NAME -f values.yaml

    Replace RELEASE_NAME with the name of the installation you chose when you installed the Helm chart.

  3. Use UI to verify the cluster status:

    1. Click Clustering in the navigation bar.

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