v0.34.0

This is release v0.34.0 of Grafana Agent.

Upgrading

Read the relevant upgrade guides for specific instructions on upgrading from older versions:

• Static mode upgrade guide
• Static mode Kubernetes operator upgrade guide
• Flow mode upgrade guide

Notable changes:

Breaking changes

• The experimental dynamic configuration feature has been removed in favor of Flow mode. (@mattdurham)

• The oracledb integration configuration has removed a redundant field metrics_scrape_interval. Use the scrape_interval parameter of the integration if a custom scrape interval is required. (@schmikei)

• Upgrade the embedded windows_exporter to commit 79781c6. (@jkroepke)

• Prometheus exporters in Flow mode now set the instance label to a value similar to the one they used to have in Static mode ( by default, customized by some integrations). (@jcreixell)

• phlare.scrape and phlare.write have been renamed to pyroscope.scrape and pyroscope.scrape. (@korniltsev)

Features

• New Grafana Agent Flow components:

  • loki.source.api - receive Loki log entries over HTTP (e.g. from other agents). (@thampiotr)
  • prometheus.operator.servicemonitors discovers ServiceMonitor resources in your Kubernetes cluster and scrape
    the targets they reference. (@captncraig, @marctc, @jcreixell)
  • prometheus.receive_http - receive Prometheus metrics over HTTP (e.g. from other agents). (@thampiotr)
  • remote.vault retrieves a secret from Vault. (@rfratto)
  • prometheus.exporter.snowflake collects metrics from a snowflake database (@JonathanWamsley)
  • prometheus.exporter.mssql collects metrics from Microsoft SQL Server (@JonathanWamsley)
  • prometheus.exporter.oracledb collects metrics from oracledb (@JonathanWamsley)
  • prometheus.exporter.dnsmasq collects metrics from a dnsmasq server. (@spartan0x117)
  • loki.source.awsfirehose - receive Loki log entries from AWS Firehose via HTTP (@thepalbi)

• Added new functions to the River standard library:

  • coalesce returns the first non-zero value from a list of arguments. (@jkroepke)
  • nonsensitive converts a River secret back into a string. (@rfratto)

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:

• Install static mode
• Install the static mode Kubernetes operator
• Install Flow mode

v0.34.0-rc.2

This is release v0.34.0-rc.2 of Grafana Agent.

Upgrading

Read the relevant upgrade guides for specific instructions on upgrading from older versions:

• Static mode upgrade guide
• Static mode Kubernetes operator upgrade guide
• Flow mode upgrade guide

Notable changes:

Enhancements

• prometheus.operator.podmonitors and prometheus.operator.servicemonitors can now access cluster secrets for authentication to targets. (@captncraig)

Bugfixes

• Add signing region to remote.s3 component for use with custom endpoints so that Authorization Headers work correctly when
  proxying requests. (@mattdurham)

• Fix missing instance key for prometheus.exporter.dnsmasq component. (@spartan0x117)

Installation

Refer to our installation guides for how to install the variants of Grafana Agent:

• Install static mode
• Install the static mode Kubernetes operator
• Install Flow mode

v0.34.0-rc.1

This is release v0.34.0-rc.1 of Grafana Agent.

Upgrading

Read the relevant upgrade guides for specific instructions on upgrading from older versions:

• Static mode upgrade guide
• Static mode Kubernetes operator upgrade guide
• Flow mode upgrade guide

Notable changes:

This release contains a single minor bugfix since rc.0.

Installation

Refer to our installation guides for how to install the variants of Grafana Agent:

• Install static mode
• Install the static mode Kubernetes operator
• Install Flow mode

v0.34.0-rc.0

This is release v0.34.0-rc.0 of Grafana Agent.

Upgrading

Read the relevant upgrade guides for specific instructions on upgrading from older versions:

• Static mode upgrade guide
• Static mode Kubernetes operator upgrade guide
• Flow mode upgrade guide

Notable changes:

Breaking changes

• The experimental dynamic configuration feature has been removed in favor of Flow mode. (@mattdurham)

• The oracledb integration configuration has removed a redundant field metrics_scrape_interval. Use the scrape_interval parameter of the integration if a custom scrape interval is required. (@schmikei)

• Upgrade the embedded windows_exporter to commit 79781c6. (@jkroepke)

• Prometheus exporters in Flow mode now set the instance label to a value similar to the one they used to have in Static mode ( by default, customized by some integrations). (@jcreixell)

• phlare.scrape and phlare.write have been renamed to pyroscope.scrape and pyroscope.scrape. (@korniltsev)

Features

• New Grafana Agent Flow components:

  • loki.source.api - receive Loki log entries over HTTP (e.g. from other agents). (@thampiotr)
  • prometheus.operator.servicemonitors discovers ServiceMonitor resources in your Kubernetes cluster and scrape
    the targets they reference. (@captncraig, @marctc, @jcreixell)
  • prometheus.receive_http - receive Prometheus metrics over HTTP (e.g. from other agents). (@thampiotr)
  • remote.vault retrieves a secret from Vault. (@rfratto)
  • prometheus.exporter.snowflake collects metrics from a snowflake database (@JonathanWamsley)
  • prometheus.exporter.mssql collects metrics from Microsoft SQL Server (@JonathanWamsley)
  • prometheus.exporter.oracledb collects metrics from oracledb (@JonathanWamsley)
  • prometheus.exporter.dnsmasq collects metrics from a dnsmasq server. (@spartan0x117)
  • loki.source.awsfirehose - receive Loki log entries from AWS Firehose via HTTP (@thepalbi)

• Added new functions to the River standard library:

  • coalesce returns the first non-zero value from a list of arguments. (@jkroepke)
  • nonsensitive converts a River secret back into a string. (@rfratto)

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:

• Install static mode
• Install the static mode Kubernetes operator
• Install Flow mode

v0.33.2

This is release v0.33.2 of Grafana Agent.

Upgrading

Read the relevant upgrade guides for specific instructions on upgrading from older versions:

• Static mode upgrade guide
• Static mode Kubernetes operator upgrade guide
• Flow mode upgrade guide

Bugfixes

• Fix issue where component evaluation time was overridden by a "default health" message.

• Honor timeout when trying to establish a connection to another agent in Flow clustering mode.

• Fix an issue with the grafana/agent windows docker image entrypoint not targeting the right location for the config.

• Fix issue where the the node_exporter integration and prometheus.exporter.unix diskstat_device_include component could not set the allowlist field for the diskstat collector.

• Flow: Fix an issue within S3 Module where the S3 path was not parsed correctly when the path consists of a parent directory.

• Flow: Fix an issue on Windows where prometheus.remote_write failed to read WAL checkpoints. This issue led to memory leaks once the initial checkpoint was created, and prevented a fresh process from being able to deliver metrics at all.

• Fix an issue where the loki.source.kubernetes component could lead to the Agent crashing due to a race condition.

Installation

Refer to our installation guides for how to install the variants of Grafana Agent:

• Install static mode
• Install the static mode Kubernetes operator
• Install Flow mode

v0.33.1

This is release v0.33.1 of Grafana Agent.

Upgrading

Read the relevant upgrade guides for specific instructions on upgrading from older versions:

• Static mode upgrade guide
• Static mode Kubernetes operator upgrade guide
• Flow mode upgrade guide

Notable changes:

Bugfixes

• Fix version information not displaying correctly when passing the --version
  flag or in the agent_build_info metric.

• Fix issue in loki.source.heroku and loki.source.gcplog where updating the
  component would cause Grafana Agent Flow's Prometheus metrics endpoint to
  return an error until the process is restarted.

• Fix issue in loki.source.file where updating the component caused
  goroutines to leak.

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:

• Install static mode
• Install the static mode Kubernetes operator
• Install Flow mode

v0.33.0

This is release v0.33.0 of Grafana Agent.

Upgrading

Read the relevant upgrade guides for specific instructions on upgrading from older versions:

• Static mode upgrade guide
• Static mode Kubernetes operator upgrade guide
• Flow mode upgrade guide

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

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

• Install static mode
• Install the static mode Kubernetes operator
• Install Flow mode

v0.33.0-rc.2

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

Upgrading

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

Notable changes:

Bugfixes

• Fix bug where loki.source.docker always failed to start.

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

v0.33.0-rc.1

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

Upgrading

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

Notable changes:

• Fixes a bug introduced to the operator when FilterRunning not specified in PodMonitors.
• Removes otelcol.processor.attributes.

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

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"