v0.28.1

This is release v0.28.1 of the Grafana Agent.

This is a security release to update the base image of our Docker distributions to resolve the OpenSSL vulnerabilities CVE-2022-3602 and CVE-2022-3786. We do not believe Grafana Agent is impacted by these vulnerabilities, as it doesn't use OpenSSL in its code. However, we still updated the base image so it doesn't appear as an issue on image scanners.

Upgrading

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

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.28.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.28.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.28.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.28.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.28.1"

v0.28.0

This is release v0.28.0 of the Grafana Agent.

Upgrading

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

Notable changes:

• Introduce Grafana Agent Flow, an experimental "programmable pipeline" runtime
  mode which improves how to configure and debug Grafana Agent by using
  components. (@captncraig, @karengermond, @marctc, @mattdurham, @rfratto,
  @rlankfo, @tpaschalis)

To learn more, free to check out our latest blog post in Introducing programmable pipelines with Grafana Agent Flow.

Features

• Introduce Blackbox exporter integration. (@marctc)

Enhancements

• Update Loki dependency to v2.6.1. (@rfratto)

Other changes

• Fix relabel configs in sample agent-operator manifests (@hjet)
• Operator no longer sets the SecurityContext.Privileged flag in the config-reloader container. (@hsyed-dojo)

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.28.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.28.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.28.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.28.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.28.0"

v0.28.0-rc.0

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

Upgrading

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

Notable changes:

This is the first release of Grafana Agent Flow, an experimental feature designed to make the agent more flexible and easier to configure and debug. See the Flow documentation for information on how to use Grafana Agent Flow.

We are looking for feedback on Grafana Agent Flow to get a better understanding of how it is received so we can determine if we should invest more time into it. Please leave any feedback you have on our GitHub discussion for Flow feedback

Additionally, this release updates our Grafana Loki (and Promtail) dependency to v2.6.1.

For the full list of changes, refer to our 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 pull "grafana/agent:v0.28.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.28.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.28.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.28.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.28.0-rc.0"

v0.27.1

This is release v0.27.1 of the Grafana Agent. This is a minor release, that only updates the base image for the docker containers. We hope in doing so to have fewer reported vulnerabilities with some tooling. None of the formerly reported vulnerabilities are known or expected to be exploitable through the Grafana Agent.

Upgrading

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

Notable changes:

NOTE: ARMv6 Docker images are no longer being published.

We have stopped publishing Docker images for ARMv6 platforms.
This is due to the new Ubuntu base image we are using that does not support ARMv6.
The new Ubuntu base image has less reported CVEs, and allows us to provide more
secure Docker images. We will still continue to publish ARMv6 release binaries and
deb/rpm packages.

• Switch docker image base from debian to ubuntu (@captncraig)

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.27.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.27.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.27.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.27.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.27.1"

v0.27.0

This is release v0.27.0 of the Grafana Agent.

Upgrading

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

Notable changes:

Features

• Integrations: (beta) Add vmware_exporter integration (@rlankfo)

• App agent receiver: add Event kind to payload (@domasx2)

Enhancements

• Tracing: Introduce a periodic appender to the remotewriteexporter to control sample rate. (@mapno)

• Tracing: Update OpenTelemetry dependency to v0.55.0. (@rfratto, @mapno)

• Add base agent-operator jsonnet library and generated manifests (@hjet)

• Add full (metrics, logs, K8s events) sample agent-operator jsonnet library and gen manifests (@hjet)

• Introduce new configuration fields for disabling Keep-Alives and setting the
  IdleConnectionTimeout when scraping. (@tpaschalis)

Bugfixes

• Tracing: Fixed issue with the PromSD processor using the connection method to discover the IP
  address. It was failing to match because the port number was included in the address string. (@jphx)

• Register prometheus discovery metrics. (@mattdurham)

• Fix seg fault when no instance parameter is provided for apache_http integration, using integrations-next feature flag. (@rgeyer)

• Fix grafanacloud-install.ps1 web request internal server error when fetching config. (@rlankfo)

• Fix snmp integration not passing module or walk_params parameters when scraping. (@rgeyer)

• Fix unmarshal errors (key "<walk_param name>" already set in map) for snmp integration config when walk_params is defined, and the config is reloaded. (@rgeyer)

Other changes

• Update several go dependencies to resolve warnings from certain security scanning tools. None of the resolved vulnerabilities were known to be exploitable through the agent. (@captncraig)

• It is now possible to compile Grafana Agent using Go 1.19. (@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 pull "grafana/agent:v0.27.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.27.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.27.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.27.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.27.0"

v0.27.0-rc.1

This is release v0.27.0-rc.1 of the Grafana Agent. It is a very small update from rc.0 to add just a few small features and fixes.

Upgrading

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

Notable changes:

Features

• App agent receiver: add Event kind to payload (@domasx2)

Bugfixes

• Fix snmp integration not passing module or walk_params parameters when scraping. (@rgeyer)

• Fix unmarshal errors (key "<walk_param name>" already set in map) for snmp integration config when walk_params is defined, and the config is reloaded. (@rgeyer)

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.27.0-rc.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.27.0-rc.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.27.0-rc.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.27.0-rc.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.27.0-rc.1"

v0.27.0-rc.0

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

Upgrading

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

Notable changes:

Features

• Integrations: (beta) Add vmware_exporter integration (@rlankfo)

Enhancements

• Tracing: Introduce a periodic appender to the remotewriteexporter to control sample rate. (@mapno)

• Tracing: Update OpenTelemetry dependency to v0.55.0. (@rfratto, @mapno)

• Add base agent-operator jsonnet library and generated manifests (@hjet)

• Add full (metrics, logs, K8s events) sample agent-operator jsonnet library and gen manifests (@hjet)

• Introduce new configuration fields for disabling Keep-Alives and setting the
  IdleConnectionTimeout when scraping. (@tpaschalis)

Bugfixes

• Tracing: Fixed issue with the PromSD processor using the connection method to discover the IP
  address. It was failing to match because the port number was included in the address string. (@jphx)

• Register prometheus discovery metrics. (@mattdurham)

• Fix seg fault when no instance parameter is provided for apache_http integration, using integrations-next feature flag. (@rgeyer)

• Fix grafanacloud-install.ps1 web request internal server error when fetching config. (@rlankfo)

Other changes

• Update several go dependencies to resolve warnings from certain security scanning tools. None of the resolved vulnerabilities were known to be exploitable through the agent. (@captncraig)

• It is now possible to compile Grafana Agent using Go 1.19. (@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 pull "grafana/agent:v0.27.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.27.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.27.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.27.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.27.0-rc.0"

v0.26.1

This is release v0.26.1 of the Grafana Agent.

Upgrading

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

Notable changes:

• Change windows certificate store, so client certificate is no longer required in store. (@mattdurham)
• Operator: Fix issue where configured targetPort ServiceMonitors resulted in generating an incorrect scrape_config. (@rfratto)
• Build the Linux/AMD64 artifacts using the opt-out flag for the ebpf_exporter. (@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.26.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.26.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.26.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.26.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.26.1"

v0.26.0

This is release v0.26.0 of the Grafana Agent.

⚠️ ⚠️ This release has a known issue with linux/amd64 binaries requiring the libbpfcc package. ⚠️ ⚠️
Until a fix is in place, you can work around this issue by either installing the bcc toolkit on your system, using our v0.26.0 Docker images or building from source and providing the -tags=noebpf flag.

Upgrading

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

Notable changes:

Breaking changes

• Deprecated server YAML block fields have now been removed in favor of the
  command-line flags that replaced them. These fields were originally
  deprecated in v0.24.0. (@rfratto)
• Changed tail sampling policies to be configured as in the OpenTelemetry
  Collector. (@mapno)

Features

• Introduce Apache HTTP exporter integration. (@v-zhuravlev)

• Introduce eBPF exporter integration. (@tpaschalis)

Enhancements

• Truncate all records in WAL if repair attempt fails. (@rlankfo)

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.26.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.26.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.26.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.26.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.26.0"

v0.26.0-rc.0

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

Upgrading

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

Notable changes:

Breaking changes

• Deprecated server YAML block fields have now been removed in favor of the
  command-line flags that replaced them. These fields were originally
  deprecated in v0.24.0. (@rfratto)
• Changed tail sampling policies to be configured as in the OpenTelemetry
  Collector. (@mapno)

Features

• Introduce Apache HTTP exporter integration. (@v-zhuravlev)

• Introduce eBPF exporter integration. (@tpaschalis)

Enhancements

• Truncate all records in WAL if repair attempt fails. (@rlankfo)

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