v0.33.0-rc.0

This is release v0.33.0-rc.0 of the Grafana Agent.

Upgrading

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

Notable changes:

Breaking changes

• Support for 32-bit ARM builds is removed for the foreseeable future due to Go
  compiler issues. We will consider bringing back 32-bit ARM support once our Go
  compiler issues are resolved and 32-bit ARM builds are stable.

• Agent Management: agent_management.api_url config field has been replaced by
  agent_management.host. The API path and version is now defined by the Agent.

• Agent Management: agent_management.protocol config field now allows defining "http" and "https" explicitly. Previously, "http" was previously used for both, with the actual protocol used inferred from the api url, which led to confusion. When upgrading, make sure to set to "https" when replacing api_url with host.

• Agent Management: agent_management.remote_config_cache_location config field has been replaced by
  agent_management.remote_configuration.cache_location.

Deprecations

• Dynamic Configuration will be removed in v0.34. Grafana Agent Flow supersedes this functionality.

Features

• New Grafana Agent Flow components:

  • discovery.dns DNS service discovery.
  • discovery.ec2 service discovery for aws ec2.
  • discovery.lightsail service discovery for aws lightsail.
  • module.file runs a Grafana Agent Flow module loaded from a file on disk.
  • module.git runs a Grafana Agent Flow module loaded from a file within a
    Git repository.
  • module.string runs a Grafana Agent Flow module passed to the component by
    an expression containing a string.
  • otelcol.auth.oauth2 performs OAuth 2.0 authentication for HTTP and gRPC
    based OpenTelemetry exporters.
  • otelcol.extension.jaeger_remote_sampling provides an endpoint from which to
    pull Jaeger remote sampling documents.
  • prometheus.exporter.blackbox collects metrics from Blackbox exporter.
  • prometheus.exporter.logging accepts OpenTelemetry data from other otelcol components and writes it to the console.
  • prometheus.exporter.mysql collects metrics from a MySQL database.
  • prometheus.exporter.postgres collects metrics from a PostgreSQL database.
  • prometheus.exporter.statsd collects metrics from a Statsd instance.
  • prometheus.exporter.snmp collects metrics from SNMP exporter.
  • prometheus.operator.podmonitors discovers PodMonitor resources in your Kubernetes cluster and scrape
    the targets they reference.
  • otelcol.auth.sigv4 performs AWS Signature Version 4 (SigV4) authentication
    for making requests to AWS services via otelcol components that support
    authentication extensions.
  • prometheus.exporter.memcached collects metrics from a Memcached server.
  • loki.source.azure_event_hubs reads messages from Azure Event Hub using Kafka and forwards them to other loki
    components.
  • discovery.gce discovers resources on Google Compute Engine (GCE).
  • discovery.digitalocean provides service discovery for DigitalOcean.
  • otelcol.processor.attributes accepts telemetry data from other otelcol
    components and modifies attributes of a span, log, or metric.
  • prometheus.exporter.windows collects metrics from a Windows instance.
  • discovery.consul service discovery for Consul.
  • discovery.azure provides service discovery for Azure.

• Add support for Flow-specific system packages:

  • Flow-specific DEB packages.
  • Flow-specific RPM packages.
  • Flow-specific macOS Homebrew Formula.
  • Flow-specific Windows installer.

  The Flow-specific packages allow users to install and run Grafana Agent Flow
  alongside an existing installation of Grafana Agent.

• Agent Management: Add support for integration snippets.

• Flow: Introduce a gossip-over-HTTP/2 clustered mode. prometheus.scrape
  component instances can opt-in to distributing scrape load between cluster
  peers.

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:

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

Docker containers are published as grafana/agent:v0.33.0-rc.0. For Windows Docker containers, use grafana/agent:v0.33.0-rc.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.33.0-rc.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.33.0-rc.0. For Windows Docker containers, use grafana/agentctl:v0.33.0-rc.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.33.0-rc.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.33.0-rc.0"