Grafana Agent

grafana/agent last check crawl paused · since 2026-09-25 99 releases
Notes

Grafana Agent has reached End-of-Life (EOL) on November 1, 2025. It is recommended migrating to the Grafana Alloy collector, which is built on the foundation of Grafana Agent Flow.

Release notes
view on github
0.33.0 · 1y+

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 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.

  • Remove deprecated symbolic links to to /bin/agent* in Docker containers, as planned in v0.31.

Deprecations

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. 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: