Grafana Agent

This is release v0.30.0 of the Grafana Agent.

Upgrading

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

Notable changes:

Breaking changes

• The ebpf_exporter integration has been removed due to issues with static linking. It may be brought back once these are resolved. (@tpaschalis)

Deprecations

• The EXPERIMENTAL_ENABLE_FLOW environment variable is deprecated in favor of AGENT_MODE=flow. Support for EXPERIMENTAL_ENABLE_FLOW will be removed in v0.32. (@rfratto)

Features

• grafana-agent-operator supports oauth2 as an authentication method for remote_write. (@timo-42)

• Grafana Agent Flow: Add tracing instrumentation and a tracing block to forward traces to otelcol component. (@rfratto)

• Grafana Agent Flow: Add a discovery_target_decode function to decode a JSON array of discovery targets corresponding to Prometheus' HTTP and file service discovery formats. (@rfratto)

• New Grafana Agent Flow components:

  • remote.http polls an HTTP URL and exposes the response body as a string or secret to other components. (@rfratto)

  • discovery.docker discovers Docker containers from a Docker Engine host. (@rfratto)

  • loki.source.file reads and tails files for log entries and forwards them to other loki components. (@tpaschalis)

  • loki.write receives log entries from other loki components and sends them over to a Loki instance. (@tpaschalis)

  • loki.relabel receives log entries from other loki components and rewrites their label set. (@tpaschalis)

  • loki.process receives log entries from other loki components and runs one or more processing stages. (@tpaschalis)

  • discovery.file discovers files on the filesystem following glob patterns. (@mattdurham)

• Integrations: Introduce the snowflake integration. (@binaryfissiongames)

Enhancements

• Integrations: Always use direct connection in mongodb_exporter integration. (@v-zhuravlev)

• Update OpenTelemetry Collector dependency to v0.63.1. (@tpaschalis)

• riverfmt: Permit empty blocks with both curly braces on the same line. (@rfratto)

• riverfmt: Allow function arguments to persist across different lines. (@rfratto)

• Flow: The HTTP server will now start before the Flow controller performs the initial load. This allows metrics and pprof data to be collected during the first load. (@rfratto)

• Add support for using a password map file in redis_exporter. (@spartan0x117)

• Flow: Add support for exemplars in Prometheus component pipelines. (@rfratto)

• Update Prometheus dependency to v2.40.5. (@rfratto)

• Update Promtail dependency to k127. (@rfratto)

• Native histograms are now supported in the static Grafana Agent and in prometheus.* Flow components. Native histograms will be automatically collected from supported targets. remote_write must be configured to forward native histograms from the WAL to the specified endpoints.

• Flow: metrics generated by upstream OpenTelemetry Collector components are now exposed at the /metrics endpoint of Grafana Agent Flow. (@rfratto)

Bugfixes

• Fix issue where whitespace was being sent as part of password when using a password file for redis_exporter. (@spartan0x117)

• Flow UI: Fix issue where a configuration block referencing a component would cause the graph page to fail to load. (@rfratto)

• Remove duplicate oauth2 key from metricsinstances CRD. (@daper)

• Fix issue where on checking whether to restart integrations the Integration Manager was comparing configs with secret values scrubbed, preventing reloads if only secrets were updated. (@spartan0x117)

Other changes

• Grafana Agent Flow has graduated from experimental to beta.

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.30.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.30.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.30.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.30.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.30.0"