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"

v0.30.0

This is release v0.30.0 of the Grafana Agent.

Upgrading

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

Notable changes:

Breaking changes

• The ebpf_exporter integration has been removed due to issues with static
  linking. It may be brought back once these are resolved. (@tpaschalis)

Deprecations

• The EXPERIMENTAL_ENABLE_FLOW environment variable is deprecated in favor of
  AGENT_MODE=flow. Support for EXPERIMENTAL_ENABLE_FLOW will be removed in
  v0.32. (@rfratto)

Features

• grafana-agent-operator supports oauth2 as an authentication method for
  remote_write. (@timo-42)

• Grafana Agent Flow: Add tracing instrumentation and a tracing block to
  forward traces to otelcol component. (@rfratto)

• Grafana Agent Flow: Add a discovery_target_decode function to decode a JSON
  array of discovery targets corresponding to Prometheus' HTTP and file service
  discovery formats. (@rfratto)

• New Grafana Agent Flow components:

  • remote.http polls an HTTP URL and exposes the response body as a string
    or secret to other components. (@rfratto)

  • discovery.docker discovers Docker containers from a Docker Engine host.
    (@rfratto)

  • loki.source.file reads and tails files for log entries and forwards them
    to other loki components. (@tpaschalis)

  • loki.write receives log entries from other loki components and sends
    them over to a Loki instance. (@tpaschalis)

  • loki.relabel receives log entries from other loki components and
    rewrites their label set. (@tpaschalis)

  • loki.process receives log entries from other loki components and runs
    one or more processing stages. (@tpaschalis)

  • discovery.file discovers files on the filesystem following glob
    patterns. (@mattdurham)

• Integrations: Introduce the snowflake integration. (@BinaryFissionGames)

Enhancements

• Integrations: Always use direct connection in mongodb_exporter integration. (@v-zhuravlev)

• Update OpenTelemetry Collector dependency to v0.63.1. (@tpaschalis)

• riverfmt: Permit empty blocks with both curly braces on the same line.
  (@rfratto)

• riverfmt: Allow function arguments to persist across different lines.
  (@rfratto)

• Flow: The HTTP server will now start before the Flow controller performs the
  initial load. This allows metrics and pprof data to be collected during the
  first load. (@rfratto)

• Add support for using a password map file in redis_exporter. (@spartan0x117)

• Flow: Add support for exemplars in Prometheus component pipelines. (@rfratto)

• Update Prometheus dependency to v2.40.5. (@rfratto)

• Update Promtail dependency to k127. (@rfratto)

• Native histograms are now supported in the static Grafana Agent and in
  prometheus.* Flow components. Native histograms will be automatically
  collected from supported targets. remote_write must be configured to forward
  native histograms from the WAL to the specified endpoints.

• Flow: metrics generated by upstream OpenTelemetry Collector components are
  now exposed at the /metrics endpoint of Grafana Agent Flow. (@rfratto)

Bugfixes

• Fix issue where whitespace was being sent as part of password when using a
  password file for redis_exporter. (@spartan0x117)

• Flow UI: Fix issue where a configuration block referencing a component would
  cause the graph page to fail to load. (@rfratto)

• Remove duplicate oauth2 key from metricsinstances CRD. (@daper)

• Fix issue where on checking whether to restart integrations the Integration Manager was comparing
  configs with secret values scrubbed, preventing reloads if only secrets were updated. (@spartan0x117)

Other changes

• Grafana Agent Flow has graduated from experimental to beta.

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

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.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 pull "grafana/agentctl:v0.30.0"

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

v0.30.0-rc.0

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

Upgrading

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

Notable changes:

Breaking changes

• The ebpf_exporter integration has been removed due to issues with static
  linking. It may be brought back once these are resolved. (@tpaschalis)

Deprecations

• The EXPERIMENTAL_ENABLE_FLOW environment variable is deprecated in favor of
  AGENT_MODE=flow. Support for EXPERIMENTAL_ENABLE_FLOW will be removed in
  v0.32. (@rfratto)

Features

• grafana-agent-operator supports oauth2 as an authentication method for
  remote_write. (@timo-42)

• Grafana Agent Flow: Add tracing instrumentation and a tracing block to
  forward traces to otelcol component. (@rfratto)

• Grafana Agent Flow: Add a discovery_target_decode function to decode a JSON
  array of discovery targets corresponding to Prometheus' HTTP and file service
  discovery formats. (@rfratto)

• New Grafana Agent Flow components:

  • remote.http polls an HTTP URL and exposes the response body as a string
    or secret to other components. (@rfratto)

  • discovery.docker discovers Docker containers from a Docker Engine host.
    (@rfratto)

  • loki.source.file reads and tails files for log entries and forwards them
    to other loki components. (@tpaschalis)

  • loki.write receives log entries from other loki components and sends
    them over to a Loki instance. (@tpaschalis)

  • loki.relabel receives log entries from other loki components and
    rewrites their label set. (@tpaschalis)

  • loki.process receives log entries from other loki components and runs
    one or more processing stages. (@tpaschalis)

  • discovery.file discovers files on the filesystem following glob
    patterns. (@mattdurham)

• Integrations: Introduce the snowflake integration. (@BinaryFissionGames)

Enhancements

• Integrations: Always use direct connection in mongodb_exporter integration. (@v-zhuravlev)

• Update OpenTelemetry Collector dependency to v0.63.1. (@tpaschalis)

• riverfmt: Permit empty blocks with both curly braces on the same line.
  (@rfratto)

• riverfmt: Allow function arguments to persist across different lines.
  (@rfratto)

• Flow: The HTTP server will now start before the Flow controller performs the
  initial load. This allows metrics and pprof data to be collected during the
  first load. (@rfratto)

• Add support for using a password map file in redis_exporter. (@spartan0x117)

• Flow: Add support for exemplars in Prometheus component pipelines. (@rfratto)

• Update Prometheus dependency to v2.40.5. (@rfratto)

• Update Promtail dependency to k127. (@rfratto)

• Native histograms are now supported in the static Grafana Agent and in
  prometheus.* Flow components. Native histograms will be automatically
  collected from supported targets. remote_write must be configured to forward
  native histograms from the WAL to the specified endpoints.

• Flow: metrics generated by upstream OpenTelemetry Collector components are
  now exposed at the /metrics endpoint of Grafana Agent Flow. (@rfratto)

Bugfixes

• Fix issue where whitespace was being sent as part of password when using a
  password file for redis_exporter. (@spartan0x117)

• Flow UI: Fix issue where a configuration block referencing a component would
  cause the graph page to fail to load. (@rfratto)

• Remove duplicate oauth2 key from metricsinstances CRD. (@daper)

• Fix issue where on checking whether to restart integrations the Integration Manager was comparing
  configs with secret values scrubbed, preventing reloads if only secrets were updated. (@spartan0x117)

Other changes

• Grafana Agent Flow has graduated from experimental to beta.

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.0-rc.0"

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.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 pull "grafana/agentctl:v0.30.0-rc.0"

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.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.30.0-rc.0"

v0.29.0

This is release v0.29.0 of the Grafana Agent.

Upgrading

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

Notable changes:

Breaking changes

• JSON-encoded traces from OTLP versions earlier than 0.16.0 are no longer
  supported. (@rfratto)

Deprecations

• The binary names agent, agentctl, and agent-operator have been
  deprecated and will be renamed to grafana-agent, grafana-agentctl, and
  grafana-agent-operator in the v0.31.0 release.

Features

• Add agentctl test-logs command to allow testing log configurations by redirecting
  collected logs to standard output. This can be useful for debugging. (@jcreixell)

• Added many new Grafana Agent Flow components for collecting OpenTelemetry data.

• Introduce /-/support endpoint for generating 'support bundles' in static
  agent mode. Support bundles are zip files of commonly-requested information
  that can be used to debug a running agent. (@tpaschalis)

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

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.29.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 pull "grafana/agentctl:v0.29.0"

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.29.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.29.0"

v0.29.0-rc.0

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

Upgrading

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

Notable changes:

Breaking changes

• JSON-encoded traces from OTLP versions earlier than 0.16.0 are no longer
  supported. (@rfratto)

Deprecations

• The binary names agent, agentctl, and agent-operator have been
  deprecated and will be renamed to grafana-agent, grafana-agentctl, and
  grafana-agent-operator in the v0.31.0 release.

Features

• Add agentctl test-logs command to allow testing log configurations by redirecting
  collected logs to standard output. This can be useful for debugging. (@jcreixell)

• Added many new Grafana Agent Flow components for collecting OpenTelemetry data.

• Introduce /-/support endpoint for generating 'support bundles' in static
  agent mode. Support bundles are zip files of commonly-requested information
  that can be used to debug a running agent. (@tpaschalis)

Other changes

• Update versions of embedded Prometheus exporters used for integrations

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.29.0-rc.0"

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.29.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 pull "grafana/agentctl:v0.29.0-rc.0"

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.29.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.29.0-rc.0"