v0.11.0

This is release v0.11.0 of the Grafana Cloud Agent.

Notable changes:

• ARMv6 builds are now included in releases as well as supported in the docker containers
• config-check subcommand of agentctl can be used to validate Agent configuration files
• A new sigv4 install script for Prometheus has been added to make it easy to install the Agent for sending to Amazon Managed Service for Prometheus.

Full changelog: https://github.com/grafana/agent/blob/master/CHANGELOG.md#v0110-2021-01-20

Installation:

Grafana Cloud Agent is currently distributed in plain binary form, Docker
container images, and a Kubernetes install script. Choose whichever fits your
use-case best.

Kubernetes Install Script

The following scripts will download and install two Kubernetes manifests for the
Agent. The first manifest collects metrics, the second collects logs, and the
final collects traces. You will be prompted for input for each manifest. The
script requires curl and envsubst (GNU gettext).

NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.11.0/production/kubernetes/install.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.11.0/production/kubernetes/install-loki.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.11.0/production/kubernetes/install-tempo.sh)" | kubectl apply -f -

Docker container:

• https://hub.docker.com/r/grafana/agent

docker pull "grafana/agent:v0.11.0"

Binary

We provide precompiled binary executables for the most common operating systems.
Choose from the assets below for your matching operating system. Example for the
linux operating system on amd64:

# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.11.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.11.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.11.0/agentctl-linux-amd64.zip"

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

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

v0.10.0

This is release v0.10.0 of the Grafana Cloud Agent, and we're in the double-digit minor revisions now! A huge thanks is deserved for @mattdurham and @56quarters who have spent some of their time helping out with the Agent 🎉

Notable changes:

The most notable change for v0.10.0 is support for signing Prometheus remote_write requests with SigV4. This allows users to use the Grafana Cloud Agent to send data to Amazon Managed Service for Prometheus!

The other significant change is support for cleaning up old WALs that are no longer associated with a Prometheus instance. This can most likely be found when using the scraping service and deleting a config. By default, WALs that haven't received data for more than 12 hours will be deleted, and the check runs every 30 minutes.

For the full list of changes, as always, please see the CHANGELOG.

Installation:

Grafana Cloud Agent is currently distributed in plain binary form, Docker
container images, and a Kubernetes install script. Choose whichever fits your
use-case best.

Kubernetes Install Script

The following scripts will download and install two Kubernetes manifests for the
Agent. The first manifest collects metrics, the second collects logs, and the
final collects traces. You will be prompted for input for each manifest. The
script requires curl and envsubst (GNU gettext).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.10.0/production/kubernetes/install.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.10.0/production/kubernetes/install-loki.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.10.0/production/kubernetes/install-tempo.sh)" | kubectl -ndefault apply -f -

Docker container:

• https://hub.docker.com/r/grafana/agent

docker pull "grafana/agent:v0.10.0"

Binary

We provide precompiled binary executables for the most common operating systems.
Choose from the assets below for your matching operating system. Example for the
linux operating system on amd64:

# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.10.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.10.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.10.0/agentctl-linux-amd64.zip"

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

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

v0.9.1

This is release v0.9.1 of the Grafana Cloud Agent. This is a minor release that adds agentctl to the rpm and deb packages. Users on versions prior to v0.9.1 should not need to update.

Notable changes:

agentctl will now be installed by the rpm and deb packages as grafana-agentctl.

Installation:

Grafana Cloud Agent is currently distributed in plain binary form, Docker
container images, and a Kubernetes install script. Choose whichever fits your
use-case best.

Kubernetes Install Script

The following scripts will download and install two Kubernetes manifests for the
Agent. The first manifest collects metrics, the second collects logs, and the
final collects traces. You will be prompted for input for each manifest. The
script requires curl and envsubst (GNU gettext).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.9.1/production/kubernetes/install.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.9.1/production/kubernetes/install-loki.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.9.1/production/kubernetes/install-tempo.sh)" | kubectl -ndefault apply -f -

Docker container:

• https://hub.docker.com/r/grafana/agent

docker pull "grafana/agent:v0.9.1"

Binary

We provide precompiled binary executables for the most common operating systems.
Choose from the assets below for your matching operating system. Example for the
linux operating system on amd64:

# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.9.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.9.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.9.1/agentctl-linux-amd64.zip"

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

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

v0.9.0

This is release v0.9.0 of the Grafana Cloud Agent!

Notable changes:

• Three new integrations have been added: postgres_exporter, statsd_exporter, and consul_exporter.
• TLS verification can now be skipped in the Tempo config with insecure_skip_verify
• Environment variables can now be used in the Agent config file. This feature is disabled by default, pass -config.expand-env to enable it.
• agentctl now includes a sample-stats command to return samples for series matching a given label selector.

The full list of changes is documented in the CHANGELOG.

Installation:

Grafana Cloud Agent is currently distributed in plain binary form, Docker
container images, and a Kubernetes install script. Choose whichever fits your
use-case best.

Kubernetes Install Script

The following scripts will download and install two Kubernetes manifests for the
Agent. The first manifest collects metrics, the second collects logs, and the
final collects traces. You will be prompted for input for each manifest. The
script requires curl and envsubst (GNU gettext).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.9.0/production/kubernetes/install.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.9.0/production/kubernetes/install-loki.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.9.0/production/kubernetes/install-tempo.sh)" | kubectl -ndefault apply -f -

Docker container:

• https://hub.docker.com/r/grafana/agent

docker pull "grafana/agent:v0.9.0"

Binary

We provide precompiled binary executables for the most common operating systems.
Choose from the assets below for your matching operating system. Example for the
linux operating system on amd64:

# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.9.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.9.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.9.0/agentctl-linux-amd64.zip"

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

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

v0.8.0

This is release v0.8.0 of the Grafana Cloud Agent.

Notable changes:

• Added dnsmasq integration (@rfratto)
• Added memcached integration (@rfratto)
• Added _build_info metric to all integrations (@rfratto)
• Bump OpenTelemetry-collector dependency to 0.14.0 (@joe-elliott)
• Error messages when retrieving configs from KV store will now be logged! (@rfratto)

Installation:

Grafana Cloud Agent is currently distributed in plain binary form, Docker
container images, and a Kubernetes install script. Choose whichever fits your
use-case best.

Kubernetes Install Script

The following scripts will download and install two Kubernetes manifests for the
Agent. The first manifest collects metrics, the second collects logs, and the
final collects traces. You will be prompted for input for each manifest. The
script requires curl and envsubst (GNU gettext).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.8.0/production/kubernetes/install.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.8.0/production/kubernetes/install-loki.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.8.0/production/kubernetes/install-tempo.sh)" | kubectl -ndefault apply -f -

Docker container:

• https://hub.docker.com/r/grafana/agent

docker pull "grafana/agent:v0.8.0"

Binary

We provide precompiled binary executables for the most common operating systems.
Choose from the assets below for your matching operating system. Example for the
linux operating system on amd64:

# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.8.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.8.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.8.0/agentctl-linux-amd64.zip"

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

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

v0.7.2

This is release v0.7.2 of the Grafana Cloud Agent!

Notable changes:

Despite being a patch version bump, there are some important additions to this release!

The biggest change is the enhancements to host filtering mode: host_filtering mode now supports Docker Swarm and Consul targets out of the box. A meta-label __host__ can now be used for filtering targets. __host__ can be combined with the new host-filtering-specific relabeling rules configured by host_filter_relabel_configs. Relabeling rules used for host filtering are temporary and are just used for the filtering process, so only use it for creating the __host__ label. For detailed information, check out the documentation on host filtering in the Operation Guide.

v0.7.0 had a bug where the docs made note of a push_config field for configuring Tempo but the Agent actually expected a field called remote_write. This has now been fixed and push_config will work as expected.

Internal dependencies have had their versions bumped:

• The internal version of Prometheus used is now 2.21
• The internal version of opentelemetry-collector used for tempo is now 0.13.0
• The internal version of promtail used for Loki is now 2.0

Installation:

Grafana Cloud Agent is currently distributed in plain binary form, Docker
container images, and a Kubernetes install script. Choose whichever fits your
use-case best.

Kubernetes Install Script

The following scripts will download and install two Kubernetes manifests for the
Agent. The first manifest collects metrics, the second collects logs, and the
final collects traces. You will be prompted for input for each manifest. The
script requires curl and envsubst (GNU gettext).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.7.2/production/kubernetes/install.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.7.2/production/kubernetes/install-loki.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.7.2/production/kubernetes/install-tempo.sh)" | kubectl -ndefault apply -f -

Docker container:

• https://hub.docker.com/r/grafana/agent

docker pull "grafana/agent:v0.7.2"

Binary

We provide precompiled binary executables for the most common operating systems.
Choose from the assets below for your matching operating system. Example for the
linux operating system on amd64:

# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.7.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.7.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.7.2/agentctl-linux-amd64.zip"

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

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

v0.7.1

This is release v0.7.1 of the Grafana Cloud Agent. This is minor patch release over v0.7.0 to add ARM binaries to the GitHub releases page.

Installation:

Grafana Cloud Agent is currently distributed in plain binary form, Docker
container images, and a Kubernetes install script. Choose whichever fits your
use-case best.

Kubernetes Install Script

The following scripts will download and install two Kubernetes manifests for the
Agent. The first manifest collects metrics, the second collects logs, and the
final collects traces. You will be prompted for input for each manifest. The
script requires curl and envsubst (GNU gettext).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.7.1/production/kubernetes/install.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.7.1/production/kubernetes/install-loki.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.7.1/production/kubernetes/install-tempo.sh)" | kubectl -ndefault apply -f -

Docker container:

• https://hub.docker.com/r/grafana/agent

docker pull "grafana/agent:v0.7.1"

Binary

We provide precompiled binary executables for the most common operating systems.
Choose from the assets below for your matching operating system. Example for the
linux operating system on amd64:

# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.7.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.7.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.7.1/agentctl-linux-amd64.zip"

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

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

v0.7.0

This is release v0.7.0 of the Grafana Cloud Agent! 🎉

This is a huge release, with support for Tracing (thanks @joe-elliott), RPM/deb packages (thanks @jdbaldry and @simonc6372) and even two new integrations (thanks @dafydd-t)!

Notable changes:

• Added Tracing Support. (@joe-elliott)
• Added RPM and deb packaging. (@jdbaldry) (@simon6372)
• arm64 and arm/v7 Docker containers and release builds are now available for agent and agentctl. (@rfratto)
• Add wal-stats and target-stats tooling to agentctl to discover WAL and cardinality issues. (@rfratto)
• mysqld_exporter is now embedded and available as an integration. (@rfratto)
• redis_exporter is now embedded and available as an integration. (@dafydd-t)

As always, the full list of changes can be found in the CHANGELOG!

Installation:

Grafana Cloud Agent is currently distributed in plain binary form, Docker
container images, and a Kubernetes install script. Choose whichever fits your
use-case best.

Kubernetes Install Script

The following scripts will download and install two Kubernetes manifests for the
Agent. The first manifest collects metrics, the second collects logs, and the
final collects traces. You will be prompted for input for each manifest. The
script requires curl and envsubst (GNU gettext).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.7.0/production/kubernetes/install.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.7.0/production/kubernetes/install-loki.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.7.0/production/kubernetes/install-tempo.sh)" | kubectl -ndefault apply -f -

Docker container:

• https://hub.docker.com/r/grafana/agent

docker pull "grafana/agent:v0.7.0"

Binary

We provide precompiled binary executables for the most common operating systems.
Choose from the assets below for your matching operating system. Example for the
linux operating system on amd64:

# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.7.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.7.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.7.0/agentctl-linux-amd64.zip"

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

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

v0.6.1

This is release v0.6.1 of the Grafana Cloud Agent. This is a minor patch release recommended for all users.

Notable changes:

• [BUGFIX] Fix issue where updating a config in the scraping service may fail to pick up new targets. (@rfratto)
• [BUGFIX] Fix deadlock that slowly prevents the Agent from scraping targets at a high scrape volume. (@rfratto)
• [BUGFIX] Fix issue where v0.6.0 build information was empty when running the Agent with --version. (@rfratto)

Thanks to @amckinley for discovering the deadlock and reporting the missing build info!

Installation:

Grafana Cloud Agent is currently distributed in plain binary form, Docker
container images, and a Kubernetes install script. Choose whichever fits your
use-case best.

Kubernetes Install Script

The following scripts will download and install two Kubernetes manifests for the
Agent. The first manifest will collect metrics and the second will collect logs.
You will be prompted for input for each manifest. The script requires curl and
envsubst (GNU gettext).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.6.1/production/kubernetes/install.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.6.1/production/kubernetes/install-loki.sh)" | kubectl -ndefault apply -f -

Docker container:

• https://hub.docker.com/r/grafana/agent

docker pull "grafana/agent:v0.6.1"

Binary

We provide precompiled binary executables for the most common operating systems.
Choose from the assets below for your matching operating system. Example for the
linux operating system on amd64:

# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.6.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.6.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.6.1/agentctl-linux-amd64.zip"

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

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

v0.6.0

NOTE: Unfortunately, FreeBSD builds are not available for this release. There is a bug in an upstream library that prevents builds from working. FreeBSD builds will return in a future release.

The Agent is back with its biggest release ever! A lot of work was done in just three weeks and I want to extend a thanks to everyone who assisted in reviewing code: @mem, @electron0zero, @hoenn, @jeschkies, and a special thanks to @gotjosh who went above and beyond expectations in helping to move things along.

Notable changes:

• Support for Loki by embedding the official Loki client, Promtail.
• Support for a new process_exporter integration that uses the lovely process-exporter.
• The embedded Prometheus version has been updated to 2.20.1.

For once, the number of changes is too long to list here so check out the full CHANGELOG for a detailed list of what has changed.

Installation:

Grafana Cloud Agent is currently distributed in plain binary form, Docker
container images, and a Kubernetes install script. Choose whichever fits your
use-case best.

Kubernetes Install Script

The following scripts will download and install two Kubernetes manifests for the
Agent. The first manifest will collect metrics and the second will collect logs.
You will be prompted for input for each manifest. The script requires curl and
envsubst (GNU gettext).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.6.0/production/kubernetes/install.sh)" | kubectl -ndefault apply -f -
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.6.0/production/kubernetes/install-loki.sh)" | kubectl -ndefault apply -f -

Docker container:

• https://hub.docker.com/r/grafana/agent

docker pull "grafana/agent:v0.6.0"

Binary

We provide precompiled binary executables for the most common operating systems.
Choose from the assets below for your matching operating system. Example for the
linux operating system on amd64:

# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.6.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.6.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.6.0/agentctl-linux-amd64.zip"

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

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