Releases: grafana/alloy
v1.14.1
1.14.1 (2026-03-17)
Bug Fixes 🐛
- Correctly handle the deprecated topic field in otelcol.receiver.kafka configuration [backport] (#5730) (4393054)
(@thampiotr) - deps: Update module golang.org/x/net to v0.51.0 [SECURITY] [backport] (#5690) (9e8616c)
- loki.process: Protect against json that does not look like docker json format [backport] (#5773) (a0f1f8a)
(@kalleep) - loki.source.file: Keep positions for compressed files when reading is finished [backport] (#5741) (4f6d548)
(@kalleep) - otelcol.receiver.datadog: Expose intake proxy and trace_id_cache_size settings [backport] (#5785) (6d99ab5)
(@thampiotr) - prometheus.scrape: Update arguments and targets even if
scrape_native_histogramsandextra_metricsare updated [backport] (#5792) (76d398f) (@ptodev)
Upgrading
Read the release notes for specific instructions on upgrading from older versions:
Installation
Refer to our installation guide for how to install Grafana Alloy.
v1.14.0
1.14.0 (2026-03-06)
⚠ BREAKING CHANGES
- loki.secretfilter: Some config options are removed entirely:
partial_mask(replaced withredact_percent)allowlist(now controlled with custom gitleaks config)enable_entropyinclude_generic(now controlled with custom gitleaks config)types(now controlled with custom gitleaks config)
- otelcol.receiver.prometheus:
otelcol.receiver.prometheusno longer sets start times of OTLP metrics. Grafana Cloud and Mimir do not currently use OTLP metric start times. If you do want your metrics to have them, you can useotelcol.processor.metric_start_timewithstrategyset totrue_reset_pointto get the same behaviour.
Features 🌟
- Add automatic reconnection to database_observability components (#5444) (553f967)
(@gaantunes) - Add limited type checking for validate command (#5076) (045fb76)
(@kalleep) - database_observability.mysql: Collect client info for query samples (#5552) (257a699)
(@matthewnolf) - database_observability.postgres: Add exclude databases/users for
logscollector (#5569) (5dddd9b)
(@cristiangreco) - database_observability.postgres: Add logs collector (#5445) (46d79d4)
(@gaantunes, @cursoragent, @clayton-cornell, @cristiangreco) - database_observability.postgres: Allow excluding queries ran by specific users (#5544) (2d0ca15)
(@cristiangreco) - Deprecate prometheus.write.queue (#5509) (ee0f227)
(@kgeckhart, @clayton-cornell) - Introduce SeriesRefMappingStore (#5522) (33ee297)
(@x1unix, @kgeckhart) - local.file_match, loki.source.file: Match multiple files using doublestar
{...}expressions (#5470) (284e48f)
(@ptodev) - loki.process: Add debug metrics for CRI stage to track truncation of lines and partial line flushing (#5399) (a1728f6)
(@ptodev) - mixin: Add OTel Engine Overview dashboard (#5573) (df52116)
(@thampiotr, @cursoragent) - mixin: Add zipped dashboards as a release artifact (#5603) (4f7fe85)
(@thampiotr) - otel: Add receivers used in the otel k8s helm chart presets (#5466) (100f6ea)
(@kgeckhart, @blewis12) - otelcol.receiver.prometheus: Remove requirement to run Alloy with
--stability.level=experimentalin order to translate Prometheus native histograms into OTLP exponential histograms. (#5308) (237e985)
(@ptodev) - otelcol: Expose missing tail_sampling drop and bytes_limiting (6021154)
(@thampiotr) - prometheus.exporter.postgres: Update to version
0.19.0and expose new collectors settings (#4640) (aa01e45)
(@cristiangreco, @clayton-cornell) - prometheus.exporter.postgres: Update to version 0.19.1 (#5659) (9f4e88f)
(@cristiangreco) - Update github exporter with github app authentication (#5377) (ca741a6)
(@dehaansa, @clayton-cornell) - Update grafana cadvisor fork to v0.54.1 (#5447) (2a3aba0)
(@dehaansa, @blewis12) - Upgrade prometheus to version 0.309.1 (#5479) (633944b)
(@jharvey10)
Bug Fixes 🐛
- Add /FORCEREGISTRY flag to windows installer (#5517) (6b22d4e)
(@kalleep, @clayton-cornell) - Add missing otelcol alias to make OTel Engine work with OTel Collector helm chart (#5473) (90478cd)
(@thampiotr) - controller: Prevent duplicate loaders from being created (#5446) (31d5eea)
(@kgeckhart) - database_observability.mysql: Skip wait events with
NULLtimer_wait (#5478) (48750e5)
(@cristiangreco) - database_observability.postgres: Correctly handle table name casing when parsing postgres queries (#5440) (7cca2b9)
(@cristiangreco) - deps: Update module github.com/go-git/go-git/v5 to v5.16.5 [SECURITY] (#5485) (71a1b8b)
- Ensure Valid/Clear States in Alloy Engine Extension (#5551) (99ad024)
(@blewis12) - Expose missing
otelcol.processor.tail_samplingoptions (#5606) (6021154)
(@thampiotr) - loki.process: Registration of stage.metric when used inside stage.match (#5460) (81caf72)
(@kalleep) - loki.source.docker: Parse timestamp correctly when log line only contains newline (#5489) (162011d)
(@kalleep) - loki.source.file: Close file if we cannot find encoding (#5528) (56bcb26)
(@kalleep) - mixin: Support OTel exporter batching (#5618) (f2b7cb8)
(@thampiotr) - prometheus.echo: Return zero for SeriesRef (#5622) (31a8680)
(@kgeckhart) - prometheus.exporter.cloudwatch: Respect debug flag (#5469) (44ade00)
(@holgerjh) - prometheus.receive_http: Bump prometheus patch for bugfix (#5505) (b7a1d05)
(@kgeckhart) - prometheus.remote_write: Fix sent_batch_duration_seconds measuring before the request was sent [backport] (#5698) (150aecb)
(@kgeckhart) - Use read-write mutex locks to prevent concurrent tagsCache map reads and writes (#5534) (8efed2e)
(@bennettatoms)
Performance
- loki.secretfilter: Change secretfilter implementation to use Gitleaks (#5503) (08e265c) (@kleimkuhler)
Upgrading
Read the [release notes] for specific instructions on upgrading from older versions:...
v1.14.0-rc.1
Release Candidate 1 for v1.14.0
This is a release candidate and should be used for testing purposes only.
Changes
See the release PR #5662 for the full changelog.
Upgrading
Read the release notes for specific instructions on upgrading from older versions:
Installation
Refer to our installation guide for how to install Grafana Alloy.
v1.14.0-rc.0
Release Candidate 0 for v1.14.0
This is a release candidate and should be used for testing purposes only.
Changes
See the release PR #5662 for the full changelog.
Upgrading
Read the release notes for specific instructions on upgrading from older versions:
Installation
Refer to our installation guide for how to install Grafana Alloy.
v1.13.2
1.13.2 (2026-02-23)
Bug Fixes 🐛
- Expose missing
otelcol.processor.tail_samplingoptions [backport] (#5614) (3225ea3) (@thampiotr) - mixin: Add zipped dashboards as a release artifact [backport] (#5625) (37ff20f) (@thampiotr)
- profiler: Backport Go 1.26 gopclntab textStart fix (#5572) (5ca05c9) (@marcsanmi)
- prometheus.exporter.postgres: Update version of the exporter fork to fix pg_settings (#5574) (62a52f8) (@cristiangreco)
- pyroscope.ebpf: Backport dotnet nibble map fix (#5553) (6c62760) (@marcsanmi)
Upgrading
Read the release notes for specific instructions on upgrading from older versions:
Installation
Refer to our installation guide for how to install Grafana Alloy.
v1.13.1
1.13.1 (2026-02-13)
Bug Fixes 🐛
- database_observability.mysql: Make query sample text nullable in MySQL query details collector [backport] (#5519) (fc49bfe) (@fridgepoet)
- database_observability.mysql: Skip wait events with
NULLtimer_wait [backport] (#5521) (2f43c91) (@cristiangreco) - database_observability.postgres: Improvements to SET search_path for postgres explain plans [backport] (#5520) (ecbb577) (@rgeyer)
- loki.process: Registration of stage.metric when used inside stage.match [backport] (#5495) (2bbc37e)
- loki.source.docker: Parse timestamp correctly when log line only contains newline [backport] (#5496) (55a82f0) (@kalleep)
- loki.source.file: Close file if we cannot find encoding [backport] (#5531) (ccda4a5) (@kalleep)
- prometheus.receive_http: Bump prometheus patch for bugfix [backport] (#5516) (b3531fb) (@kgeckhart)
- scheduling: Shutdown runnables with a timeout before starting new ones [backport] (#5443) (d446610) (@kgeckhart)
Upgrading
Read the release notes for specific instructions on upgrading from older versions:
Installation
Refer to our installation guide for how to install Grafana Alloy.
v1.13.0
1.13.0 (2026-02-05)
⚠ BREAKING CHANGES
- otelcol: Upgrade to OTel Collector v0.142.0
- otelcol.receiver.kafka: The global
topicattribute has been deleted; use thetopicsattributes inside thelogs,metrics, andtracesblocks instead. otelcol.exporter>sending_queue>batch>min_sizechanged from8192to2000andmax_sizechanged from0to3000
Features 🌟
- Add a
virtual_node_peer_attributesandvirtual_node_extra_labelarguments tootelcol.connector.servicegraph(#5058) (20900c6) (@ptodev, @clayton-cornell) - Add an
otelcol.processor.metric_start_timecomponent (#5342) (3fb13ac) (@ptodev) - Add job level
period,length, andadd_cloudwatch_timestampoptions and labels_snake_case to CW exporter [backport] (#5355) (60d73b7) (@tmeijn, @clayton-cornell) - Add missing configuration parameter
deployment_name_from_replicasetto k8sattributes processor (#5183) (b54ca77) (@dehaansa) - Add parcas symbols upload to pyroscope.ebpf (#4948) (30f2242) (@korniltsev-grafanista, @claude)
- Add sharding for loki.write (#4882) (7570d65) (@kalleep, @thampiotr)
- Add unexposed otel engine and extension to codebase and change build structure (#5114) (6438176) (@blewis12)
- beyla.ebpf: Add meta_cache_address to beyla.ebpf.attributes.kubernetes (#4871) (b43864b) (@skl)
- beyla.ebpf: Upgrade Beyla to v2.8.5 (f1f457f) (@ptodev, @clayton-cornell)
- Change the defaults for
sending_queue>batchblock insideotelcol.exportercomponents (#5061) (714a2ed) (@ptodev) - cluster: Support DNS discovery mode prefixes in --cluster.join-addresses flag (#5034) (d2fda91) (@x1unix)
- converter: Update promtail converter to use file_match block for loki.source.file (#4791) (a42f386) (@kalleep)
- Database_observability: add health check collector for postgres component (#5222) (80917b1) (@matthewnolf)
- Database_observability: expose
exclude_schemasandexclude_databasessettings (#5334) (37656f8) (@cristiangreco) - Database_observability: support Azure cloud provider config data (#5245) (d7a469f) (@cristiangreco)
- Database_observability: support Azure privatelink db name (#5260) (22e4991) (@cristiangreco)
- Database_observability.mysql: support excluding schemas in all collectors [backport] (#5380) (d67268c) (@cristiangreco)
- Database_observability.postgres: support excluding DBs in all collectors [backport] (#5383) (165492c) (@cristiangreco)
- database_observability: Add health_check collector to validate configuration (#5115) (6d96740) (@matthewnolf)
- database_observability: Always send explain plan log for each query including status (#4969) (03a5a20) (@rgeyer)
- database_observability: Append cloud provider information labels to metrics (#4942) (166829e) (@matthewnolf)
- database_observability: Stop tracking own instrumentation queries (#4991) (0b55557) (@cristiangreco)
- deps: Update Prometheus to v3.8.0 and Loki to v3.6.2 (#5035) (01c4a62) (@thampiotr)
- Expose otel subcommand and add user-facing documentation (#5244) (93f20b8) (@blewis12, @thampiotr, @clayton-cornell)
- Improve faro.receiver.sourcemaps caching strategy (#4337) (41e655c) (@mateagluhak, @clayton-cornell)
- loki.process: Mark stage.windowsevent as GA (#4879) (22de0cf) (@kgeckhart)
- loki.source.file: Refactor tailer to reduce resource usage (#5003) (688da66) (@kalleep)
- loki.source.syslog: Implement livedebugging support (#5216) (e26badb) (@x1unix, @dehaansa)
- loki.source.syslog: Support cisco-specific syslog fields (#5165) (3230ba0) (@x1unix)
- loki.source.syslog: Support raw format (#5140) (923d127) (@x1unix, @clayton-cornell)
- mimir.alerts.kubernetes: Add
alertmanagerconfig_matcherblock to change the matcher strategy (f2b9671) (@timonegk, @ptodev, @clayton-cornell) - mimir.alerts.kubernetes: Add component to discover AlertmanagerConfig Kubernetes resources (#3448) (6f2396e) (@ptodev)
- mixin: Provide rendered mixin outputs (#5118) (738b9fb) (@thampiotr)
- otelcol.auth.basic: Add htpasswd file based authentication (#3916) (c564d09) (@pkarakal)
- otelcol.connector.count: Add component to count spans, metrics, and logs (#4913) (b1cb806) (@hhertout)
- otelcol.exporter.file: Add
otelcol.exporter.filecomponent to write metrics, logs, and traces to disk with optional rotation, compression, and grouping by resource attribute (#4475) (1aef0ac) (@madhub) - otelcol.exporter.prometheus: Add
honor_metadataconfig argument [backport] (#5439) (32cb175) - otelcol.receiver.awss3: Add experimental receiver for traces stored in S3 (#4928) (bc3885b) (@x1unix)
- otelcol.receiver.kafka: Deprecate the
topicattribute inside thelogs,metrics, andtracesblocks in favour of a newtopicsattribute. (f1f457f) (@ptodev, @clayton-cornell) - otelcol.receiver.kafka: Remove the global `top...
v1.13.0-rc.4
Release Candidate 4 for v1.13.0
This is a release candidate and should be used for testing purposes only.
Changes
feat(otelcol.exporter.prometheus): Add honor_metadata config argument #5439
fix(loki.source.file): Update tail_from_end to properly handle file encoding #5436
fix: Revert doublestar v4 update #5435
fix(loki.process): Implement encoding.TextMarshaler and encoding.TextUnmarshaler for TruncateSourceType #5428
See the release PR #5351 for the full changelog.
Upgrading
Read the release notes for specific instructions on upgrading from older versions:
Installation
Refer to our installation guide for how to install Grafana Alloy.
v1.13.0-rc.3
Release Candidate 3 for v1.13.0
This is a release candidate and should be used for testing purposes only.
Changes
This RC contains a few changes on top of the previous RC2:
fix: Add support for compressed files for tail package #5415
perf(loki.source.file): Reduce allocations during file reading #5416
fix(loki.source.file): Make sure position is recorded when component exit #5418
See the release PR #5351 for the full changelog.
Upgrading
Read the release notes for specific instructions on upgrading from older versions:
Installation
Refer to our installation guide for how to install Grafana Alloy.
v1.13.0-rc.2
Release Candidate 2 for v1.13.0
This is a release candidate and should be used for testing purposes only.
Changes
This RC contains a few changes on top of the previous RC1:
feat: Database_observability.postgres: support excluding DBs in all collectors #5383
fix: Database_observability: add Azure provider relabeling rules #5382
feat: Database_observability.mysql: support excluding schemas in all collectors #5380
fix: Database_observability: update BackendXID type to int64 to better map to PG xid #5373
See the release PR #5351 for the full changelog.
Upgrading
Read the release notes for specific instructions on upgrading from older versions:
Installation
Refer to our installation guide for how to install Grafana Alloy.