Releases: grafana/agent
v0.23.0
tpaschalis
Paschalis Tsilias
This is release v0.23.0 of the Grafana Agent.
Upgrading
Read the upgrade guide for specific instructions on upgrading from older versions.
Notable changes:
This release is mainly focused around some enhancements:
- The Agent will now deduplicate exemplars and propagate them over remote_write by default.
- If you're using the
integrations-nextfeature flag, the extra_labels key now allows you to add a custom set of labels to integration targets. - The new eventhandler integration allows users to watch for changes to Event objects in a Kubernetes cluster and ship them as log entries.
Additionally, some more bug fixes and enhancements are included in this release. Please check the CHANGELOG for the full list of details.
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:
docker pull "grafana/agent:v0.23.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. Example for the linux operating system on amd64:
# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.23.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.23.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.23.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.23.0"v0.22.0
This is release v0.22.0 of the Grafana Agent.
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
This release contains several notable changes including the following features:
- Added cAdvisor integration.
- Traces: Add
Agent Tracing Pipelinedashboard and alerts - Traces: Support jaeger/grpc exporter
- (beta) Enable an experimental integrations subsystem revamp. Pass
integrations-nextto-enable-featuresto turn this on. Reading the documentation for the revamp is recommended; enabling it causes breaking config changes. - (beta) Enable experimental config urls for fetching remote configs. Currently, only HTTP/S is supported. Pass the
-enable-features=remote-configsflag to turn this on.
This release has deprecations. Please read [DEPRECATION] entries and consult the upgrade guide for detailed information.
Additionally, several bug fixes and enhancements are included in this release. Please see the CHANGELOG for the full list of details.
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:
docker pull "grafana/agent:v0.22.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. Example for the linux operating system on amd64:
# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.22.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.22.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.22.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.22.0"v0.21.2
This is release v0.21.2 of the Grafana Agent.
Notable changes:
This patch release contains a fix for CVE-2021-41090. Please read the advisory in detail. We recommend patching your agents as soon as possible.
Once patched, the impacted /-/config and /agent/api/v1/configs/{name} endpoints will now be disabled by default. Pass the --config.enable-read-api flag at the command line to opt in to these endpoints.
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:
docker pull "grafana/agent:v0.21.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. Example for the linux operating system on amd64:
# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.21.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.21.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.21.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.21.2"v0.20.1
This is release v0.20.1 of the Grafana Agent.
Notable changes:
This patch release contains a fix for CVE-2021-41090. Please read the advisory in detail. We recommend patching your agents as soon as possible.
Once patched, the impacted /-/config and /agent/api/v1/configs/{name} endpoints will now be disabled by default. Pass the --config.enable-read-api flag at the command line to opt in to these endpoints.
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:
docker pull "grafana/agent:v0.20.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. Example for the linux operating system on amd64:
# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.20.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.20.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.20.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.20.1"v0.21.1
This is release v0.21.1 of the Grafana Agent.
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
This is a small release with a few bug fixes for integrations, metrics, and the operator. Please see the CHANGELOG for the full list of details.
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:
docker pull "grafana/agent:v0.21.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. Example for the linux operating system on amd64:
# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.21.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.21.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.21.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.21.1"v0.21.0
This is release v0.21.0 of the Grafana Agent.
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
This release contains several enhancements in the form of dependency updates, bug fixes, and documentation changes.
This release includes a notable change to integrations: self-scraped integrations will now derive the value of the instance label from the system the integration is connecting to. For example, the MySQL integration will use the address of the MySQL server, making it easier to identify the system being observed in dashboards. If an integration doesn't connect to an external system (such as statsd_exporter), it will continue to use the agent's HTTP address for the instance label.
Integrations also now support modifying an instance field to override the inferred value. Please see the documentation for each integration for more information.
Please refer to the CHANGELOG for a complete list of changes.
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:
docker pull "grafana/agent:v0.21.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. Example for the linux operating system on amd64:
# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.21.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.21.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.21.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.21.0"v0.20.0
Release v0.20.0 of Grafana Agent is here! This is a release focused mainly on enhancing existing features and fixing bugs.
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
The Grafana Agent Operator can now natively collect cAdvisor and Kubelet metrics! When the operator is spawned with a --kubelet-service flag set to <namespace>/<name>, it will maintain a Service with the provided name with one endpoint per node. This allows users to create a ServiceMonitor for getting access to the cAdvisor and Kubelet metrics. Check out our docs for a full guide.
Grafana Agent can now generate service graphs based on traces! This works by inspecting incoming spans and generating metrics. Our configuration docs for traces has more details on how you can configure and use this for yourself. Thanks to @mapno for implementing this!
Finally, thanks to @gaantunes, many of our integrations have been updated to the latest version of the upstream exporters.
As always, please read this release's CHANGELOG for the full list of features, enhancements, bugfixes, and changes.
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:
docker pull "grafana/agent:v0.20.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. Example for the linux operating system on amd64:
# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.20.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.20.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.20.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.20.0"
v0.19.0
It's been several months in the making, but version v0.19.0 of Grafana Agent is finally ready! I want to begin by thanking everyone who has contributed to this release; the full list of contributiors with the things they did for the project can be found in the CHANGELOG.
Now, I want to talk about why it took so long for us to get here. We made several large changes for v0.19.0 that were implemented across multiple PRs. While this made code review easier, it also prevented us from cutting a release since we didn't consider those changes "ready." Then, when we identified bugs in v0.18.0 that we wanted to fix, we had no choice but to backport fixes for a new v0.18.X release. This caused some confusion, as people who were waiting for something in main had to keep waiting until this release finally shipped.
We want to prevent a situation like this from happening again, and we're going to adopt a new branching strategy for dealing with large changes. We decided on the dev branch strategy that I noticed the Go team using for the upcoming fuzzing support. The dev.* branches will be used to implement significant changes that would block a release, and will help us keep main near releasable at all times. While a maintainer has to create a dev.* branch, we're more than happy to create one for anyone who is planning on contributing a significant chunk of work; please let us know if you are going to do this.
With that out of the way, let's see what's new!
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
This release contains an enormous amount of features, changes, and bug fixes.
One large item to note is how we've deprecated the prometheus/loki/tempo terminology in the config file in favor of logs/metrics/traces. This will hopefully disambiguate discussions when discussing both the Grafana Agent config and the config for one of those databases. The old keys will continue to work for a while, but we would recommend changing to the new terms when you can. Newer fields that reference prometheus/loki/tempo have been changed without support for aliasing; please check the migration guide for more information.
Grafana Agent Operator now has support for logging through a PodLogs CRD! This CRD is configured much like you would configure a PodMonitor. We've also changed the CRDs to include the same Prometheus -> Metrics name change. This is a breaking change (unlike the base Agent config file) and you will need to update your CRDs to accomodate for v0.19.0. To support zero-downtime upgrades, agentctl now has an operator-detach command that removes ownerReferences from all operator-owned resources.
There's a lot of other great contributions that I think are better served by just referencing the full list instead of transcribing them. For the full list of changes, as always, 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:
docker pull "grafana/agent:v0.19.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. Example for the linux operating system on amd64:
# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.19.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.19.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.19.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.19.0"v0.18.4
This is release v0.18.4 of the Grafana Agent.
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
This release fixes two issues:
- Info-level logs on Windows will now correctly appear in the Event Logger.
- Scraping service reshards will try to be scheduled every
reshard_interval. Previously, events from Consul or even running a reshard would reset the timer ofreshard_interval.
For the full list of changes, please refer to the CHANGELOG.
Installation:
Grafana Agent is currently distributed in plain binary form, Docker container images, and a Windows installer. Choose whichever fits your use-case best.
Docker container:
docker pull "grafana/agent:v0.18.4"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. Example for the linux operating system on amd64:
# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.18.4/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.18.4"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.18.4/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.18.4"v0.18.3
This is release v0.18.3 of the Grafana Agent.
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
This release is focused on bug fixes to the scraping service:
- In scraping service mode, the polling configuration refresh should honor timeout. (@mattdurham)
- In scraping service mode, the lifecycle reshard should happen using a goroutine. (@mattdurham)
- In scraping service mode, scraping service can deadlock when reloading during join. (@mattdurham)
- Scraping service: prevent more than one refresh from being queued at a time. (@rfratto)
These changes should help prevent a spike of failed reshards while nodes are joining and leaving the cluster.
For the full list of changes, please refer to the CHANGELOG.
Installation:
Grafana Agent is currently distributed in plain binary form, Docker container images, and a Windows installer. Choose whichever fits your use-case best.
Docker container:
docker pull "grafana/agent:v0.18.3"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. Example for the linux operating system on amd64:
# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.18.3/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.18.3"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.18.3/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.18.3"