Documentation Grafana Cloud Instrument and send data Grafana Alloy Configure Clustering

Configure Alloy clustering in an existing installation

You can configure Alloy to run with clustering so that individual Alloys can work together for workload distribution and high availability.

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

Configure Alloy clustering with Helm Chart

This section guides you through enabling clustering when Alloy is installed on Kubernetes using the Alloy 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 alloy block.

   yaml Copy

   alloy:
     clustering:
       enabled: true

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

   bash Copy

   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 Alloy UI to verify the cluster status:

   1. Click Clustering in the navigation bar.

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