This is release v0.33.0
of Grafana Agent.
Upgrading
Read the relevant upgrade guides 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
. -
Remove deprecated symbolic links to to
/bin/agent*
in Docker containers,
as planned in v0.31.
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.
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
Refer to our installation guides for how to install the variants of Grafana Agent: