Releases: grafana/agent
v0.18.1
5520754This is release v0.18.1 of the Grafana Agent.
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
This release added better handling for consul connections when running in scraping service mode. More details can be found in 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.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.18.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.18.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.18.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.18.1"v0.18.0
c31550dThis is release v0.18.0 of the Grafana Agent.
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
This release added github_exporter integration, updated postgres_exporter integration, OTLP HTTP trace exporting, and a fix for honoring the enabled flag. More details can be found in 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.
Docker container:
docker pull "grafana/agent:v0.18.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.18.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.18.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.18.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.18.0"v0.17.0
This is release v0.17.0 of the Grafana Agent.
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
This release added kafka_exporter integration along with a fix for a race condition. More details can be found in 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 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.17.0/production/kubernetes/install.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.17.0/production/kubernetes/install-loki.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.17.0/production/kubernetes/install-tempo.sh)" | kubectl apply -f -
Docker container:
docker pull "grafana/agent:v0.17.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.17.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.17.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.17.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.17.0"v0.16.1
This is release v0.16.1 of the Grafana Agent. If you are using v0.16.0, this release is strongly recommended.
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
This release contains a bug fix for v0.16.0 where if the WALs were reloaded, there was a high chance of metrics being sent with the wrong labels, making the values appear incorrect.
The v0.16.0 release was pulled from Github to prevent people from running into this. The full v0.16.0 changelog, which includes a Grafana Agent Operator, can be found here.
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 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.16.1/production/kubernetes/install.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.16.1/production/kubernetes/install-loki.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.16.1/production/kubernetes/install-tempo.sh)" | kubectl apply -f -
Docker container:
docker pull "grafana/agent:v0.16.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.16.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.16.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.16.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.16.1"v0.15.0
This is release v0.15.0 of the Grafana Agent!
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
This release includes support for writing exemplars over remote_write. Note that the remote_write system must support receiving and querying exemplars for exemplars to work end-to-end. Thanks to @mapno for implementing this!
The full list of changes can be found in the CHANGELOG.
Installation:
Grafana 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.15.0/production/kubernetes/install.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.15.0/production/kubernetes/install-loki.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.15.0/production/kubernetes/install-tempo.sh)" | kubectl apply -f -
Docker container:
docker pull "grafana/agent:v0.15.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.15.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.15.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.15.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.14.0
This is release v0.14.0 of the Grafana Agent, and our biggest release to date! There's a lot to go over since the v0.13.1 release. One notable thing that doesn't get a changelog entry is the introduction of a governance team. Please welcome Matt Durham, Joe Elliott, Robert Fratto, Richard Hartmann, and Mario Rodriguez as the initial team members!
One more thing: we're also going to start marking features interchangeably as beta or experimental when we believe they are going to change. This is to help us continue iterating quickly while making it clear which things we believe are production-ready.
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
This is the first release where we have changed the name of the project from Grafana Cloud Agent to Grafana Agent. The new name is for a few reasons, but I (@rfratto) like to say "Grafana Agent" is less confusing, since it was never intended to only be used by Grafana Cloud users. The README has been updated to reflect who might find the Grafana Agent useful.
With that out of the way, let's get into the biggest changes of this release:
- Thanks to the work by @mattdurham, official Windows support is now in beta! The Grafana Agent now supports being run natively as a Windows service, logs to the Windows Event Log, has a Windows isntaller, and includes windows_exporter as an integration.
- Also in beta is /-/reload, where you can tell an Agent to dynamically reload its entire config file. Paired with this is a /-/config endpoint to return the current in-memory config being used.
- More things in beta! Courtesy of @yeya24, you can now generate metrics from your spans!
- Thanks to @mattdurham, we finally support a global remote_write block! No more duplicating remote_write across both integrations and scrape configs!
- The FreeBSD build returns, as well as official support for M1 Macs!
- @joe-elliott and @mapno have been hard at work on the tracing subsystem; the Agent now supposed tail-based sampling and automatic logs and metrics based on spans!
Way too much has changed this time, so please check out the full CHANGELOG for all the details. Thank you to everyone who contributed to this release!
Installation:
Grafana 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.14.0/production/kubernetes/install.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.14.0/production/kubernetes/install-loki.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.14.0/production/kubernetes/install-tempo.sh)" | kubectl apply -f -
Docker container:
docker pull "grafana/agent:v0.14.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.14.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.14.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.14.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.14.0-rc.4
Note v0.14.0-rc.4 changes the default directory for Grafana Agent on Windows from c:\Program Files (x86)\Grafana Agent to c:\Program Files\Grafana Agent.
This is our fourth release candidate release of the Grafana Agent! A lot has changed over the past month. In fact, this release is so big that we wanted to do a release candidate first to gain more confidence in the code. Please try this release out in non-production environments and let us know if you run into any problems!
We're also going to start marking features interchangeably as beta or experimental when we believe they are going to change. This is to help us continue iterating quickly while making it clear which things we believe are production-ready.
Upgrading
This release updates to Prometheus 2.26.0, which includes the SigV4 code we initially introduced here 🎉 However, the upstream SigV4 code introduced a breaking change from the initial Grafana Agent SigV4 configuration. Please read the migration guide for specific instructions on how to change your SigV4 config to work with the new release.
Notable changes:
This is the first release where we have changed the name of the project from Grafana Cloud Agent to Grafana Agent. The new name is for a few reasons, but I (@rfratto) like to say "Grafana Agent" is less confusing, since it was never intended to only be used by Grafana Cloud users. The README has been updated to reflect who might find the Grafana Agent useful.
With that out of the way, let's get into the biggest changes of this release:
- Thanks to the work by @mattdurham, official Windows support is now in beta! The Grafana Agent now supports being run natively as a Windows service, logs to the Windows Event Log, has a Windows isntaller, and includes windows_exporter as an integration.
- Also in beta is
/-/reload, where you can tell an Agent to dynamically reload its entire config file. Paired with this is a/-/configendpoint to return the current in-memory config being used. - More things in beta! Courtesy of @yeya24, you can now generate metrics from your spans!
- Thanks to @mattdurham, we finally support a global remote_write block! No more duplicating remote_write across both integrations and scrape configs!
- The FreeBSD build returns, as well as official support for M1 Macs!
There's a ton of changes this time around, so check out the full CHANGELOG for all the details. Thank you to everyone who contributed to this release!
Installation:
Grafana 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.14.0-rc.4/production/kubernetes/install.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.14.0-rc.4/production/kubernetes/install-loki.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.14.0-rc.4/production/kubernetes/install-tempo.sh)" | kubectl apply -f -
Docker container:
docker pull "grafana/agent:v0.14.0-rc.4"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.14.0-rc.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.14.0-rc.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.14.0-rc.4/agentctl-linux-amd64.zip"
# extract the binary
unzip "agentctl-linux-amd64.zip"
# make sure it is executable
chmod a+x "agentctl-linux-amd64"Contributors
Assets 27
v0.13.1
This is release v0.13.1 of the Grafana Cloud Agent.
Upgrading
Read the migration guide for specific instructions on upgrading from older versions.
Notable changes:
This is a minor patch release with one change to address issues with the Grafana Agent's Prometheus Remote Write compliance:
- Validate that incoming scraped metrics do not have an empty label set or a label set with duplicate labels, mirroring the behavior of Prometheus.
This patch release does not come with any other 0.14.0-rc features, enhancements, or bugfixes.
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.1/production/kubernetes/install.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.13.1/production/kubernetes/install-loki.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.13.1/production/kubernetes/install-tempo.sh)" | kubectl apply -f -
Docker container:
docker pull "grafana/agent:v0.13.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.13.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.13.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.13.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.14.0-rc.2
Note this is the same as v0.14.0-rc.0 but the windows installer executable has been included.
This is our second release candidate release of the Grafana Agent! A lot has changed over the past month. In fact, this release is so big that we wanted to do a release candidate first to gain more confidence in the code. Please try this release out in non-production environments and let us know if you run into any problems!
We're also going to start marking features interchangeably as beta or experimental when we believe they are going to change. This is to help us continue iterating quickly while making it clear which things we believe are production-ready.
Upgrading
This release updates to Prometheus 2.26.0, which includes the SigV4 code we initially introduced here 🎉 However, the upstream SigV4 code introduced a breaking change from the initial Grafana Agent SigV4 configuration. Please read the migration guide for specific instructions on how to change your SigV4 config to work with the new release.
Notable changes:
This is the first release where we have changed the name of the project from Grafana Cloud Agent to Grafana Agent. The new name is for a few reasons, but I (@rfratto) like to say "Grafana Agent" is less confusing, since it was never intended to only be used by Grafana Cloud users. The README has been updated to reflect who might find the Grafana Agent useful.
With that out of the way, let's get into the biggest changes of this release:
- Thanks to the work by @mattdurham, official Windows support is now in beta! The Grafana Agent now supports being run natively as a Windows service, logs to the Windows Event Log, has a Windows isntaller, and includes windows_exporter as an integration.
- Also in beta is
/-/reload, where you can tell an Agent to dynamically reload its entire config file. Paired with this is a/-/configendpoint to return the current in-memory config being used. - More things in beta! Courtesy of @yeya24, you can now generate metrics from your spans!
- Thanks to @mattdurham, we finally support a global remote_write block! No more duplicating remote_write across both integrations and scrape configs!
- The FreeBSD build returns, as well as official support for M1 Macs!
There's a ton of changes this time around, so check out the full CHANGELOG for all the details. Thank you to everyone who contributed to this release!
Installation:
Grafana 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.14.0-rc.2/production/kubernetes/install.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.14.0-rc.2/production/kubernetes/install-loki.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.14.0-rc.2/production/kubernetes/install-tempo.sh)" | kubectl apply -f -
Docker container:
docker pull "grafana/agent:v0.14.0-rc.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.14.0-rc.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.14.0-rc.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.14.0-rc.2/agentctl-linux-amd64.zip"
# extract the binary
unzip "agentctl-linux-amd64.zip"
# make sure it is executable
chmod a+x "agentctl-linux-amd64"Contributors
Assets 27
v0.14.0-rc.0
rfratto
Robert Fratto
This is our first release candidate release of the Grafana Agent! A lot has changed over the past month. In fact, this release is so big that we wanted to do a release candidate first to gain more confidence in the code. Please try this release out in non-production environments and let us know if you run into any problems!
We're also going to start marking features interchangeably as beta or experimental when we believe they are going to change. This is to help us continue iterating quickly while making it clear which things we believe are production-ready.
Upgrading
This release updates to Prometheus 2.26.0, which includes the SigV4 code we initially introduced here 🎉 However, the upstream SigV4 code introduced a breaking change from the initial Grafana Agent SigV4 configuration. Please read the migration guide for specific instructions on how to change your SigV4 config to work with the new release.
Notable changes:
This is the first release where we have changed the name of the project from Grafana Cloud Agent to Grafana Agent. The new name is for a few reasons, but I (@rfratto) like to say "Grafana Agent" is less confusing, since it was never intended to only be used by Grafana Cloud users. The README has been updated to reflect who might find the Grafana Agent useful.
With that out of the way, let's get into the biggest changes of this release:
- Thanks to the work by @mattdurham, official Windows support is now in beta! The Grafana Agent now supports being run natively as a Windows service, logs to the Windows Event Log, has a Windows isntaller, and includes windows_exporter as an integration.
- Also in beta is
/-/reload, where you can tell an Agent to dynamically reload its entire config file. Paired with this is a/-/configendpoint to return the current in-memory config being used. - More things in beta! Courtesy of @yeya24, you can now generate metrics from your spans!
- Thanks to @mattdurham, we finally support a global remote_write block! No more duplicating remote_write across both integrations and scrape configs!
- The FreeBSD build returns, as well as official support for M1 Macs!
There's a ton of changes this time around, so check out the full CHANGELOG for all the details. Thank you to everyone who contributed to this release!
Installation:
Grafana 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.14.0-rc.0/production/kubernetes/install.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.14.0-rc.0/production/kubernetes/install-loki.sh)" | kubectl apply -f -
NAMESPACE="default" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/grafana/agent/v0.14.0-rc.0/production/kubernetes/install-tempo.sh)" | kubectl apply -f -
Docker container:
docker pull "grafana/agent:v0.14.0-rc.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.14.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.14.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.14.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"