This is release v0.30.0
of the Grafana Agent.
Upgrading
Read the upgrade guide for specific instructions on upgrading from older versions.
Notable changes:
Breaking changes
- The
ebpf_exporter
integration has been removed due to issues with static
linking. It may be brought back once these are resolved. (@tpaschalis)
Deprecations
- The
EXPERIMENTAL_ENABLE_FLOW
environment variable is deprecated in favor of
AGENT_MODE=flow
. Support forEXPERIMENTAL_ENABLE_FLOW
will be removed in
v0.32. (@rfratto)
Features
-
grafana-agent-operator
supports oauth2 as an authentication method for
remote_write. (@timo-42) -
Grafana Agent Flow: Add tracing instrumentation and a
tracing
block to
forward traces tootelcol
component. (@rfratto) -
Grafana Agent Flow: Add a
discovery_target_decode
function to decode a JSON
array of discovery targets corresponding to Prometheus' HTTP and file service
discovery formats. (@rfratto) -
New Grafana Agent Flow components:
-
remote.http
polls an HTTP URL and exposes the response body as a string
or secret to other components. (@rfratto) -
discovery.docker
discovers Docker containers from a Docker Engine host.
(@rfratto) -
loki.source.file
reads and tails files for log entries and forwards them
to otherloki
components. (@tpaschalis) -
loki.write
receives log entries from otherloki
components and sends
them over to a Loki instance. (@tpaschalis) -
loki.relabel
receives log entries from otherloki
components and
rewrites their label set. (@tpaschalis) -
loki.process
receives log entries from otherloki
components and runs
one or more processing stages. (@tpaschalis) -
discovery.file
discovers files on the filesystem following glob
patterns. (@mattdurham)
-
-
Integrations: Introduce the
snowflake
integration. (@BinaryFissionGames)
Enhancements
-
Integrations: Always use direct connection in mongodb_exporter integration. (@v-zhuravlev)
-
Update OpenTelemetry Collector dependency to v0.63.1. (@tpaschalis)
-
riverfmt: Permit empty blocks with both curly braces on the same line.
(@rfratto) -
riverfmt: Allow function arguments to persist across different lines.
(@rfratto) -
Flow: The HTTP server will now start before the Flow controller performs the
initial load. This allows metrics and pprof data to be collected during the
first load. (@rfratto) -
Add support for using a password map file in
redis_exporter
. (@spartan0x117) -
Flow: Add support for exemplars in Prometheus component pipelines. (@rfratto)
-
Update Prometheus dependency to v2.40.5. (@rfratto)
-
Update Promtail dependency to k127. (@rfratto)
-
Native histograms are now supported in the static Grafana Agent and in
prometheus.*
Flow components. Native histograms will be automatically
collected from supported targets. remote_write must be configured to forward
native histograms from the WAL to the specified endpoints. -
Flow: metrics generated by upstream OpenTelemetry Collector components are
now exposed at the/metrics
endpoint of Grafana Agent Flow. (@rfratto)
Bugfixes
-
Fix issue where whitespace was being sent as part of password when using a
password file forredis_exporter
. (@spartan0x117) -
Flow UI: Fix issue where a configuration block referencing a component would
cause the graph page to fail to load. (@rfratto) -
Remove duplicate
oauth2
key frommetricsinstances
CRD. (@daper) -
Fix issue where on checking whether to restart integrations the Integration Manager was comparing
configs with secret values scrubbed, preventing reloads if only secrets were updated. (@spartan0x117)
Other changes
- Grafana Agent Flow has graduated from experimental to beta.
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.30.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.
Note: ppc64le builds are currently considered secondary release targets and do not have the same level of support and testing as other platforms.
Example for the linux
operating system on amd64
:
# download the binary
curl -O -L "https://github.com/grafana/agent/releases/download/v0.30.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.30.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.30.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.30.0"