Skip to content

Releases: grafana/agent

v0.13.0

25 Feb 19:17
v0.13.0
e9bd098
Compare
Choose a tag to compare

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

Upgrading

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

Notable changes:

This release comes with an important bugfix for #400. The Agent now comes with a higher tolerance (~20-80 minutes) of a server-side remote_write outage. This is done by increasing the wal_truncation_frequency to 60m, and has the trade-off of creating a larger WAL. If you want to revert to the old behavior, manually set the truncation frequency to 60s. The bugfix presented here isn't ideal (the tolerance is still variable) and work for a proper fix is ongoing.

This is also the first release where the primary branch of the repository has changed to main 🎉 This shouldn't affect users, but you may need to update any scripts you built that used the previous branch name. For example, non-release Docker images will now be tagged as main-SHA.

Other notable changes:

  • postgres_exporter: Support query_path and disable_default_metrics. (@rfratto)

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

  • Fixed a bug from v0.12.0 where the Loki installation script failed because positions_directory was not set. (@rfratto)

  • Add the ability to read and serve HTTPS integration metrics when given a set certificates (@mattdurham)

For the full list of changes, please check out our 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).

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

Docker container:

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

05 Feb 19:33
v0.12.0
585a36d
Compare
Choose a tag to compare

This is release v0.12.0 of the Grafana Cloud Agent. This is our first release that has BREAKING CHANGES, so please read the notable changes carefully before upgrading from a previous version. We will continue to try our best to keep breaking changes across releases to a minimum.

⚠️ BREAKING CHANGES ⚠️

  • Support for multiple distinct instances of log collection is now supported. This enables sending some of your logs to Loki A, while sending others to Loki B. This means Loki configs must now be placed inside of a configs array, similar to Prometheus configs.
  • Support for multiple distinct instances of trace collection is now supported. This enables sending some of your traces to Tempo A, while sending others to Tempo B. This means Tempo configs must now be placed inside of a configs array, similar to Prometheus configs.

For more information on migrating a config created before v0.12.0 to the new format, please read our migration guide.

No changes need to be made if you are not using logs or traces.

Notable changes:

  • An elasticsearch_exporter integration has been added.
  • debs and rpms are now generated for all currently supported architectures.
  • The number of metrics created by Kubernetes install script should now be significantly lower! 🎉
  • Scraping service: unhealthy nodes in the hash ring will no longer cause some job distribution to fail.

As always, please refer to the CHANGELOG for a full list of changes!

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

Docker container:

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

20 Jan 16:52
v0.11.0
48c0762
Compare
Choose a tag to compare

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:

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

13 Jan 16:09
v0.10.0
c1409a2
Compare
Choose a tag to compare

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:

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

04 Jan 21:26
v0.9.1
749904e
Compare
Choose a tag to compare

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:

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

10 Dec 19:21
v0.9.0
68dc220
Compare
Choose a tag to compare

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:

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

06 Nov 20:13
5c59f84
Compare
Choose a tag to compare

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:

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

29 Oct 15:32
v0.7.2
53bd829
Compare
Choose a tag to compare

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:

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

23 Oct 16:28
v0.7.1
c298962
Compare
Choose a tag to compare

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:

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

23 Oct 15:29
v0.7.0
6a85093
Compare
Choose a tag to compare

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:

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"