Skip to content

v0.30.0

Compare
Choose a tag to compare
@grafanabot grafanabot released this 20 Dec 14:48
· 1880 commits to main since this release
v0.30.0
4862821

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:

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"