Grafana Agent

This is release v0.29.0 of the Grafana Agent.

Upgrading

Read the upgrade guide for specific instructions on upgrading from older versions.

Notable changes:

Breaking changes

• JSON-encoded traces from OTLP versions earlier than 0.16.0 are no longer supported. (@rfratto)

Deprecations

• The binary names agent, agentctl, and agent-operator have been deprecated and will be renamed to grafana-agent, grafana-agentctl, and grafana-agent-operator in the v0.31.0 release.

Features

• Add agentctl test-logs command to allow testing log configurations by redirecting collected logs to standard output. This can be useful for debugging. (@jcreixell)

• Added many new Grafana Agent Flow components for collecting OpenTelemetry data.

• Introduce /-/support endpoint for generating 'support bundles' in static agent mode. Support bundles are zip files of commonly-requested information that can be used to debug a running agent. (@tpaschalis)

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:

• https://hub.docker.com/r/grafana/agent

docker pull "grafana/agent:v0.29.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.29.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.29.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.29.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.29.0"