Grafana Agent
Grafana Agent has reached End-of-Life (EOL) on November 1, 2025. It is recommended migrating to the Grafana Alloy collector, which is built on the foundation of Grafana Agent Flow.
This is release v0.28.0 of the Grafana Agent.
Upgrading
Read the upgrade guide for specific instructions on upgrading from older versions.
Notable changes:
- Introduce Grafana Agent Flow, an experimental "programmable pipeline" runtime mode which improves how to configure and debug Grafana Agent by using components. (@captncraig, @karengermond, @marctc, @mattdurham, @rfratto, @rlankfo, @tpaschalis)
To learn more, free to check out our latest blog post in Introducing programmable pipelines with Grafana Agent Flow.
Features
- Introduce Blackbox exporter integration. (@marctc)
Enhancements
- Update Loki dependency to v2.6.1. (@rfratto)
Other changes
- Fix relabel configs in sample agent-operator manifests (@hjet)
- Operator no longer sets the
SecurityContext.Privilegedflag in theconfig-reloadercontainer. (@hsyed-dojo)
Installation:
Grafana Agent is currently distributed in plain binary form, Docker container images, a Windows installer, and a Kubernetes install script. Choose whichever fits your use-case best.
Kubernetes
Install directions here.
Docker container:
docker pull "grafana/agent:v0.28.0"
Windows installer
The Windows installer is provided as a release asset for x64 machines.
Binary
We provide precompiled binary executables for the most common operating systems. Choose from the assets below for your matching operating system.
Note: ppc64le builds are currently considered secondary release targets and do not have the same level of support and testing as other platforms.
Example for the linux operating system on amd64:
# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.28.0/agent-linux-amd64.zip"
# extract the binary
unzip "agent-linux-amd64.zip"
# make sure it is executable
chmod a+x "agent-linux-amd64"
agentctl
agentctl, a tool for helping you interact with the Agent, is available as a Docker image:
docker pull "grafana/agentctl:v0.28.0"
Or as a binary. Like before, choose the assets below that matches your operating system. For example, with linux on amd64:
# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.28.0/agentctl-linux-amd64.zip"
# extract the binary
unzip "agentctl-linux-amd64.zip"
# make sure it is executable
chmod a+x "agentctl-linux-amd64"
agent-operator
agent-operator, a Kubernetes Operator for the Grafana Agent, is available only as a Docker image:
docker pull "grafana/agent-operator:v0.28.0"