●Change8

Migrating to Prometheus v3.7.0

Version v3.7.0 introduces 1 breaking change. This guide details how to update your code.

Released: 10/15/2025

1
Breaking Changes
1
Migration Steps
11
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

prometheus_remote_storage_samples_in_totalprometheus_wal_watcher_records_read_totalprometheus_remote_storage_samples_dropped_totalprometheus_remote_storage_histograms_in_totalprometheus_remote_storage_histograms_dropped_totalprometheus_remote_storage_exemplars_in_totalprometheus_remote_storage_exemplars_dropped_totalprometheus_remote_storage_highest_timestamp_in_secondsprometheus_remote_storage_queue_highest_timestamp_secondsALERTSALERTS_FOR_STATE

Breaking Changes

●Issue #1

OTLP endpoint: OpenTelemetry attribute names starting with underscore (e.g., `_attrib`) are no longer automatically translated to `key_attrib`. Users relying on this automatic translation must update attribute names or use version 3.7.1 for OTLP ingestion.

Migration Steps

  1. 1
    If you rely on automatic translation of OpenTelemetry attribute names starting with an underscore in the OTLP endpoint, update your attribute names or use version 3.7.1 for OTLP ingestion.

Release Summary

This release introduces significant performance improvements across PromQL and TSDB, adds support for new features like native histograms with custom buckets, and fixes numerous bugs, while also warning about a breaking change in OTLP attribute name handling.

Need More Details?

View the full release notes and all changes for Prometheus v3.7.0.

View Full Changelog