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"

v0.31.2

This is release v0.31.2 of the Grafana Agent.

Upgrading

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

Notable changes:

• In the Agent Operator, upgrade the prometheus-config-reloader dependency
  from version 0.47.0 to version 0.62.0. (@ptodev)

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

v0.31.1

This is release v0.31.1 of the Grafana Agent.

Upgrading

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

Notable changes:

Breaking changes

• All release Windows .exe files are now published as a zip archive.
  Previously, grafana-agent-installer.exe was unzipped. (@rfratto)

Other changes

• Support Go 1.20 for builds. (@rfratto)

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

v0.31.0

This is release v0.31.0 of the Grafana Agent.

Upgrading

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

Notable changes:

Breaking changes

• Release binaries (including inside Docker containers) have been renamed to be
  prefixed with grafana- (@rfratto):

  • agent is now grafana-agent.
  • agentctl is now grafana-agentctl.
  • agent-operator is now grafana-agent-operator.

Deprecations

• A symbolic link in Docker containers from the old binary name to the new
  binary name has been added. These symbolic links will be removed in v0.33. (@rfratto)

Features

• New Grafana Agent Flow components:

  • loki.source.cloudflare reads logs from Cloudflare's Logpull API and
    forwards them to other loki components. (@tpaschalis)
  • loki.source.gcplog reads logs from GCP cloud resources using Pub/Sub
    subscriptions and forwards them to other loki components. (@tpaschalis)
  • loki.source.gelf listens for Graylog logs. (@mattdurham)
  • loki.source.heroku listens for Heroku messages over TCP a connection and
    forwards them to other loki components. (@erikbaranowski)
  • loki.source.journal read messages from systemd journal. (@mattdurham)
  • loki.source.kubernetes collects logs from Kubernetes pods using the
    Kubernetes API. (@rfratto)
  • loki.source.podlogs discovers PodLogs resources on Kubernetes and
    uses the Kubernetes API to collect logs from the pods specified by the
    PodLogs resource. (@rfratto)
  • loki.source.syslog listens for Syslog messages over TCP and UDP
    connections and forwards them to other loki components. (@tpaschalis)
  • loki.source.windowsevent reads logs from Windows Event Log. (@mattdurham)
  • otelcol.exporter.jaeger forwards OpenTelemetry data to a Jaeger server.
    (@erikbaranowski)
  • otelcol.exporter.loki forwards OTLP-formatted data to compatible loki
    receivers. (@tpaschalis)
  • otelcol.receiver.kafka receives telemetry data from Kafka. (@rfratto)
  • otelcol.receiver.loki receives Loki logs, converts them to the OTLP log
    format and forwards them to other otelcol components. (@tpaschalis)
  • otelcol.receiver.opencensus receives OpenConsensus-formatted traces or
    metrics. (@ptodev)
  • otelcol.receiver.zipkin receives Zipkin-formatted traces. (@rfratto)
  • phlare.scrape collects application performance profiles. (@cyriltovena)
  • phlare.write sends application performance profiles to Grafana Phlare.
    (@cyriltovena)
  • mimir.rules.kubernetes discovers PrometheusRule Kubernetes resources and
    loads them into a Mimir instance. (@Logiraptor)

• Flow components which work with relabeling rules (discovery.relabel,
  prometheus.relabel and loki.relabel) now export a new value named Rules.
  This value returns a copy of the currently configured rules. (@tpaschalis)

• New experimental feature: agent-management. Polls configured remote API to fetch new configs. (@spartan0x117)

• Introduce global configuration for logs. (@jcreixell)

Enhancements

• Handle faro-web-sdk View meta in app_agent_receiver. (@rlankfo)

• Grafana Agent Operator: add promtail limit stage to the operator. (@spartan0x117)

Bugfixes

• Flow UI: Fix the issue with messy layout on the component list page while browser window resize. (@xiyu95)

• Flow UI: Display the values of all attributes unless they are nil. (@ptodev)

• Flow: Fix issue where negative numbers would convert to floating-point values
  incorrectly, treating the sign flag as part of the number. (@rfratto)

• Flow: fix a goroutine leak when loki.source.file is passed more than one
  target with identical set of public labels. (@rfratto)

• Fix issue where removing and re-adding log instance configurations causes an
  error due to double registration of metrics (@spartan0x117, @jcreixell)

Other changes

• New windows containers for agent and agentctl. These can be found moving forward with the ${Version}-windows tags for grafana/agent and grafana/agentctl docker images (@erikbaranowski)

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

v0.31.0-rc.0

This is release v0.31.0-rc.0 of the Grafana Agent.

Upgrading

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

BREAKING CHANGES: This release has breaking changes. Please read entries
carefully and consult the upgrade guide for specific instructions.

Notable changes:

• A Grafana Agent Helm chart is now available!
• Windows Docker containers are now available! Windows images are published with a -windows suffix.
• Several new Grafana Agent Flow components have been added:
  • phlare.scrape and phlare.write let you collect and send continuous profiles to Phlare.
  • mimir.rules.kubernetes lets you discover PrometheusRule CRDs on Kubernetes to automatically configure Mimir alerting and recording rules.
  • Many new loki.* components have been added, including the ability to translate between otelcol and loki pipelines.
• The Promtail limit stage is now supported in the PodLogs resource for Grafana Agent Operator.

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.31.0-rc.0. For Windows Docker containers, use grafana/agent:v0.31.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.31.0-rc.0/agent-linux-amd64.zip"

# extract the binary
unzip "agent-linux-amd64.zip"

# make sure it is executable
chmod a+x "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.0-rc.0. For Windows Docker containers, use grafana/agentctl:v0.31.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.31.0-rc.0/agentctl-linux-amd64.zip"

# extract the binary
unzip "agentctl-linux-amd64.zip"

# make sure it is executable
chmod a+x "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.0-rc.0"

v0.30.2

This is release v0.30.2 of the Grafana Agent.

Upgrading

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

Notable changes:

This release includes bug fixes to Grafana Agent Operator and Grafana Agent Flow:

• Operator: Fix the handling of the enableHttp2 field as a boolean in pod_monitor and service_monitor templates.

• Flow: prometheus.relabel will no longer modify the labels of the original metrics, which could lead to the incorrect application of relabel rules on subsequent relabels.

• Flow: loki.source.file will no longer deadlock other components if log lines cannot be sent to Loki. loki.source.file will wait for 5 seconds per file to finish flushing read logs to the client, after which it will drop them, resulting in lost logs.

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 pull "grafana/agent:v0.30.2"

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.30.2/agent-linux-amd64.zip"

# extract the binary
unzip "agent-linux-amd64.zip"

# make sure it is executable
chmod a+x "agent-linux-amd64"

agentctl

agentctl, a tool for helping you interact with the Agent, is available as a Docker image:

docker pull "grafana/agentctl:v0.30.2"

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.30.2/agentctl-linux-amd64.zip"

# extract the binary
unzip "agentctl-linux-amd64.zip"

# make sure it is executable
chmod a+x "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.30.2"

v0.30.1

This is release v0.30.1 of the Grafana Agent.

Upgrading

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

Notable changes:

Bugfixes

• Fix issue where journald support was accidentally removed. (@tpaschalis)

• Fix issue where some traces' metrics where not collected. (@marctc)

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 pull "grafana/agent:v0.30.1"

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.30.1/agent-linux-amd64.zip"

# extract the binary
unzip "agent-linux-amd64.zip"

# make sure it is executable
chmod a+x "agent-linux-amd64"

agentctl

agentctl, a tool for helping you interact with the Agent, is available as a Docker image:

docker pull "grafana/agentctl:v0.30.1"

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.30.1/agentctl-linux-amd64.zip"

# extract the binary
unzip "agentctl-linux-amd64.zip"

# make sure it is executable
chmod a+x "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.30.1"