Skip to content

v0.32.0

Compare
Choose a tag to compare
@grafanabot grafanabot released this 28 Feb 18:30
· 1750 commits to main since this release
v0.32.0
4cb0945

This is release v0.32.0 of the Grafana Agent.

Upgrading

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

Notable changes:

Breaking changes

  • Support for the embedded Flow UI for 32-bit ARMv6 builds is temporarily
    removed.

  • Node Exporter configuration options changed to align with new upstream version:

    • diskstats_ignored_devices is now diskstats_device_exclude in agent configuration.
    • ignored_devices is now device_exclude in flow configuration.
  • Some blocks in Flow components have been merged with their parent block to make the block hierarchy smaller:

    • discovery.docker > http_client_config is merged into the discovery.docker block.
    • discovery.kubernetes > http_client_config is merged into the discovery.kubernetes block.
    • loki.source.kubernetes > client > http_client_config is merged into the client block.
    • loki.source.podlogs > client > http_client_config is merged into the client block.
    • loki.write > endpoint > http_client_config is merged into the endpoint block.
    • mimir.rules.kubernetes > http_client_config is merged into the mimir.rules.kubernetes block.
    • otelcol.receiver.opencensus > grpc is merged into the otelcol.receiver.opencensus block.
    • otelcol.receiver.zipkin > http is merged into the otelcol.receiver.zipkin block.
    • phlare.scrape > http_client_config is merged into the phlare.scrape block.
    • phlare.write > endpoint > http_client_config is merged into the endpoint block.
    • prometheus.remote_write > endpoint > http_client_config is merged into the endpoint block.
    • prometheus.scrape > http_client_config is merged into the prometheus.scrape block.
  • The loki.process component now uses a combined name for stages, simplifying the block hierarchy. For example, the stage > json block hierarchy is now a single block called stage.json. All stage blocks in loki.process have been updated to use this simplified hierarchy.

  • remote.s3 client_options block has been renamed to client.

  • Renamed prometheus.integration.node_exporter to prometheus.exporter.unix.

  • As first announced in v0.30, support for the EXPERIMENTAL_ENABLE_FLOW environment variable has been removed in favor of AGENT_MODE=flow.

Features

  • New integrations:

    • oracledb
    • mssql
    • cloudwatch metrics
    • azure
    • gcp
  • New Grafana Agent Flow components:

    • loki.echo writes received logs to stdout.
    • loki.source.docker reads logs from Docker containers and forwards them to other loki components.
    • loki.source.kafka reads logs from Kafka events and forwards them to other loki components.
    • loki.source.kubernetes_events watches for Kubernetes Events and converts them into log lines to forward to other loki components. It is the equivalent of the eventhandler integration.
    • otelcol.processor.tail_sampling samples traces based on a set of defined policies from otelcol components before forwarding them to other otelcol components.
    • prometheus.exporter.apache collects metrics from an apache web server
    • prometheus.exporter.consul collects metrics from a consul installation
    • prometheus.exporter.github collects metrics from GitHub
    • prometheus.exporter.process aggregates and collects metrics by scraping /proc.
    • prometheus.exporter.redis collects metrics from a redis database

For a full list of changes, please refer to the CHANGELOG!

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 containers are published as grafana/agent:v0.32.0. For Windows Docker containers, use grafana/agent:v0.32.0-windows instead.

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.32.0/grafana-agent-linux-amd64.zip"

# extract the binary
unzip "grafana-agent-linux-amd64.zip"

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

agentctl

agentctl, a tool for helping you interact with the Agent, is available as a Docker image:

Docker containers are published as grafana/agentctl:v0.32.0. For Windows Docker containers, use grafana/agentctl:v0.32.0-windows instead.

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.32.0/grafana-agentctl-linux-amd64.zip"

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

# make sure it is executable
chmod a+x "grafana-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.32.0"