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 replacingapi_url
withhost
. -
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 otherotelcol
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 viaotelcol
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 otherloki
components.discovery.gce
discovers resources on Google Compute Engine (GCE).discovery.digitalocean
provides service discovery for DigitalOcean.otelcol.processor.attributes
accepts telemetry data from otherotelcol
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:
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"