Menu
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.
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 hascontroller.type
set tostatefulset
.
Steps
To configure clustering:
Amend your existing
values.yaml
file to addclustering.enabled=true
inside theagent
block.yamlagent: clustering: enabled: true
Upgrade your installation to use the new
values.yaml
file:bashhelm upgrade <RELEASE_NAME> -f values.yaml
Replace the following:
<RELEASE_NAME>
: The name of the installation you chose when you installed the Helm chart.
Use the Grafana Agent Flow UI to verify the cluster status:
Click Clustering in the navigation bar.
Ensure that all expected nodes appear in the resulting table.
Was this page helpful?
Related resources from Grafana Labs
Additional helpful documentation, links, and articles:
Video
Getting started with Grafana dashboard design
In this webinar, you'll learn how to design stylish and easily accessible Grafana dashboards that tell a story.
Video
Building advanced Grafana dashboards
In this webinar, we’ll demo how to build and format Grafana dashboards.
Video
Intro to Alerting with Grafana
Master alerting with Grafana: Navigate the complexities, reduce false positives, and boost reliability for your systems.