Grafana Agent
Grafana Agent has reached End-of-Life (EOL) on November 1, 2025. It is recommended migrating to the Grafana Alloy collector, which is built on the foundation of Grafana Agent Flow.
This is release v0.40.0 of Grafana Agent.
Upgrading
Read the relevant upgrade guides for specific instructions on upgrading from older versions:
Notable changes:
Breaking changes
-
Prohibit the configuration of services within modules. (@wildum)
-
For
otelcol.exportercomponents, change the default value ofdisable_high_cardinality_metricstotrue. (@ptodev) -
Rename component
prometheus.exporter.agenttoprometheus.exporter.selfto clear up ambiguity. (@hainenber)
Deprecations
- Module components have been deprecated in favor of import and declare configuration blocks. These deprecated components will be removed in the next release. (@wildum)
Features
-
Modules have been redesigned to split the import logic from the instantiation. You can now define custom components via the
declareconfig block and import modules viaimport.git,import.http,import.string,import.file. (@wildum) -
A new
discovery.processcomponent for discovering Linux OS processes on the current host. (@korniltsev) -
A new
pyroscope.javacomponent for profiling Java processes using async-profiler. (@korniltsev) -
A new
otelcol.processor.resourcedetectioncomponent which inserts resource attributes to OTLP telemetry based on the host on which Grafana Agent is running. (@ptodev) -
Expose track_timestamps_staleness on Prometheus scraping, to fix the issue where container metrics live for 5 minutes after the container disappears. (@ptodev)
-
Introduce the
remotecfgservice that enables loading configuration from a remote endpoint. (@tpaschalis) -
Add
otelcol.connector.host_infocomponent to gather usage metrics for cloud users. (@rlankfo, @jcreixell)
For a full list of changes, please refer to the CHANGELOG!
Installation
Refer to our installation guides for how to install the variants of Grafana Agent: