Grafana Agent

grafana/agent last check crawl paused · since 2026-09-25 99 releases
Notes

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.

Release notes
view on github
0.6.0 · 1y+

NOTE: Unfortunately, FreeBSD builds are not available for this release. There is a bug in an upstream library that prevents builds from working. FreeBSD builds will return in a future release.

The Agent is back with its biggest release ever! A lot of work was done in just three weeks and I want to extend a thanks to everyone who assisted in reviewing code: @mem, @electron0zero, @hoenn, @jeschkies, and a special thanks to @gotjosh who went above and beyond expectations in helping to move things along.

Notable changes:

  • Support for Loki by embedding the official Loki client, Promtail.
  • Support for a new process_exporter integration that uses the lovely process-exporter.
  • The embedded Prometheus version has been updated to 2.20.1.

For once, the number of changes is too long to list here so check out the full CHANGELOG for a detailed list of what has changed.

Installation:

Grafana Cloud Agent is currently distributed in plain binary form, Docker container images, and a Kubernetes install script. Choose whichever fits your use-case best.

Kubernetes Install Script

The following scripts will download and install two Kubernetes manifests for the Agent. The first manifest will collect metrics and the second will collect logs. You will be prompted for input for each manifest. The script requires curl and envsubst (GNU gettext).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.6.0/production/kubernetes/install.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.6.0/production/kubernetes/install-loki.sh)" | kubectl -ndefault apply -f -

Docker container:

docker pull "grafana/agent:v0.6.0"

Binary

We provide precompiled binary executables for the most common operating systems. Choose from the assets below for your matching operating system. Example for the linux operating system on amd64:

# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.6.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.6.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.6.0/agentctl-linux-amd64.zip"

# extract the binary
unzip "agentctl-linux-amd64.zip"

# make sure it is executable
chmod a+x "agentctl-linux-amd64"