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.
Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
Configure Grafana Agent clustering in an existing installation
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 hascontroller.type
set tostatefulset
.
Steps
To configure clustering:
Amend your existing values.yaml file to add
clustering.enabled=true
inside of theagent
block:agent: clustering: enabled: true
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.Use UI to verify the cluster status:
Click Clustering in the navigation bar.
Ensure that all expected nodes appear in the resulting table.