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
configsarray, 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
configsarray, 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 andrpms 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"