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"

v0.32.1

This is release v0.32.1 of the Grafana Agent.

Upgrading

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

Notable changes:

Bugfixes

• Flow: Fixes slow reloading of targets in phlare.scrape component. (@cyriltovena)

• Flow: add a maximum connection lifetime of one hour when tailing logs from
  loki.source.kubernetes and loki.source.podlogs to recover from an issue
  where the Kubernetes API server stops responding with logs without closing
  the TCP connection. (@rfratto)

• Flow: fix issue in loki.source.kubernetes where __pod__uid__ meta label
  defaulted incorrectly to the container name, causing tailers to never
  restart. (@rfratto)

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

v0.32.0

This is release v0.32.0 of the Grafana Agent.

Upgrading

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

Notable changes:

Breaking changes

• Support for the embedded Flow UI for 32-bit ARMv6 builds is temporarily
  removed.

• Node Exporter configuration options changed to align with new upstream version:

  • diskstats_ignored_devices is now diskstats_device_exclude in agent configuration.
  • ignored_devices is now device_exclude in flow configuration.

• Some blocks in Flow components have been merged with their parent block to make the block hierarchy smaller:

  • discovery.docker > http_client_config is merged into the discovery.docker block.
  • discovery.kubernetes > http_client_config is merged into the discovery.kubernetes block.
  • loki.source.kubernetes > client > http_client_config is merged into the client block.
  • loki.source.podlogs > client > http_client_config is merged into the client block.
  • loki.write > endpoint > http_client_config is merged into the endpoint block.
  • mimir.rules.kubernetes > http_client_config is merged into the mimir.rules.kubernetes block.
  • otelcol.receiver.opencensus > grpc is merged into the otelcol.receiver.opencensus block.
  • otelcol.receiver.zipkin > http is merged into the otelcol.receiver.zipkin block.
  • phlare.scrape > http_client_config is merged into the phlare.scrape block.
  • phlare.write > endpoint > http_client_config is merged into the endpoint block.
  • prometheus.remote_write > endpoint > http_client_config is merged into the endpoint block.
  • prometheus.scrape > http_client_config is merged into the prometheus.scrape block.

• The loki.process component now uses a combined name for stages, simplifying the block hierarchy. For example, the stage > json block hierarchy is now a single block called stage.json. All stage blocks in loki.process have been updated to use this simplified hierarchy.

• remote.s3 client_options block has been renamed to client.

• Renamed prometheus.integration.node_exporter to prometheus.exporter.unix.

• As first announced in v0.30, support for the EXPERIMENTAL_ENABLE_FLOW environment variable has been removed in favor of AGENT_MODE=flow.

Features

• New integrations:

  • oracledb
  • mssql
  • cloudwatch metrics
  • azure
  • gcp

• New Grafana Agent Flow components:

  • loki.echo writes received logs to stdout.
  • loki.source.docker reads logs from Docker containers and forwards them to other loki components.
  • loki.source.kafka reads logs from Kafka events and forwards them to other loki components.
  • loki.source.kubernetes_events watches for Kubernetes Events and converts them into log lines to forward to other loki components. It is the equivalent of the eventhandler integration.
  • otelcol.processor.tail_sampling samples traces based on a set of defined policies from otelcol components before forwarding them to other otelcol components.
  • prometheus.exporter.apache collects metrics from an apache web server
  • prometheus.exporter.consul collects metrics from a consul installation
  • prometheus.exporter.github collects metrics from GitHub
  • prometheus.exporter.process aggregates and collects metrics by scraping /proc.
  • prometheus.exporter.redis collects metrics from a redis database

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

v0.32.0-rc.0

This is release v0.32.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 the embedded Flow UI for 32-bit ARMv6 builds is temporarily
  removed.

• Node Exporter configuration options changed to align with new upstream version:

  • diskstats_ignored_devices is now diskstats_device_exclude in agent configuration.
  • ignored_devices is now device_exclude in flow configuration.

• Some blocks in Flow components have been merged with their parent block to make the block hierarchy smaller:

  • discovery.docker > http_client_config is merged into the discovery.docker block.
  • discovery.kubernetes > http_client_config is merged into the discovery.kubernetes block.
  • loki.source.kubernetes > client > http_client_config is merged into the client block.
  • loki.source.podlogs > client > http_client_config is merged into the client block.
  • loki.write > endpoint > http_client_config is merged into the endpoint block.
  • mimir.rules.kubernetes > http_client_config is merged into the mimir.rules.kubernetes block.
  • otelcol.receiver.opencensus > grpc is merged into the otelcol.receiver.opencensus block.
  • otelcol.receiver.zipkin > http is merged into the otelcol.receiver.zipkin block.
  • phlare.scrape > http_client_config is merged into the phlare.scrape block.
  • phlare.write > endpoint > http_client_config is merged into the endpoint block.
  • prometheus.remote_write > endpoint > http_client_config is merged into the endpoint block.
  • prometheus.scrape > http_client_config is merged into the prometheus.scrape block.

• The loki.process component now uses a combined name for stages, simplifying the block hierarchy. For example, the stage > json block hierarchy is now a single block called stage.json. All stage blocks in loki.process have been updated to use this simplified hierarchy.

• remote.s3 client_options block has been renamed to client.

• Renamed prometheus.integration.node_exporter to prometheus.exporter.unix.

• As first announced in v0.30, support for the EXPERIMENTAL_ENABLE_FLOW environment variable has been removed in favor of AGENT_MODE=flow.

Features

• New integrations:

  • oracledb
  • mssql
  • cloudwatch metrics
  • azure
  • gcp

• New Grafana Agent Flow components:

  • loki.echo writes received logs to stdout.
  • loki.source.docker reads logs from Docker containers and forwards them to other loki components.
  • loki.source.kafka reads logs from Kafka events and forwards them to other loki components.
  • loki.source.kubernetes_events watches for Kubernetes Events and converts them into log lines to forward to other loki components. It is the equivalent of the eventhandler integration.
  • otelcol.processor.tail_sampling samples traces based on a set of defined policies from otelcol components before forwarding them to other otelcol components.
  • prometheus.exporter.apache collects metrics from an apache web server
  • prometheus.exporter.consul collects metrics from a consul installation
  • prometheus.exporter.github collects metrics from GitHub
  • prometheus.exporter.process aggregates and collects metrics by scraping /proc.
  • prometheus.exporter.redis collects metrics from a redis database

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

v0.31.3

This is release v0.31.3 of the Grafana Agent.

Upgrading

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

Notable changes:

This patch release contains two bug fixes for Grafana Agent Flow components:

• loki.source.cloudflare: fix issue where the zone_id argument was being ignored, and the api_token argument was being used for the zone instead.
• loki.source.cloudflare: fix issue where api_token argument was not marked as a sensitive field.

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