Catalog / Prometheus

Prometheus 2 to 3

Every Prometheus 3.x release the archive holds, 35 of them, starting at 3.0.0 and running to 3.14.0. The publisher writes these one at a time and its documentation describes the version you are on, so the run between two majors is not laid out anywhere as a list.

Releases
3535 carry notes
Opened
14 Nov 20241.8 years ago
Span
21 monthsto 18 Aug 2026
Breaking
4tagged by the publisher
Advisories closed
4security

The turn

The last 2.x release the archive holds before the turn is 2.55.1, on 6 Nov 2024. 3.0.0 followed 8 days later. 2.x did not stop there. 2 more 2.x releases shipped after 3.0.0 opened, the last of them on 30 Jun 2025, so both lines were being maintained at once.

Tagged breaking

4 of these releases carry the breaking label: 3.7.1, 3.7.0, 3.5.0, 3.0.0. The label is matched from words in the publisher’s own notes, so a release that changed an API without using the word does not carry it.

Every 3.x release

All Prometheus releases
3.14.0addedchangeddeprecated

[CHANGE] API: Deprecate the stats query parameter of /api/v1/query and /api/v1/query_range for values other than true and all. Other values still enable basic statistics but now return a deprecation warning; they will be rejected in the nex

3.13.2securitychanged

[SECURITY] Bump golang.org/x/text to v0.39.0 (CVE-2026-56852) and google.golang.org/grpc to v1.82.1 (GHSA-hrxh-6v49-42gf). #19290 by @krajorama [BUGFIX] PromQL: Preallocate the active query tracker file to avoid SIGBUS crashes when the data

3.13.1

This is a bugfix release for 3.13 LTS. [BUGFIX] TSDB: Fix the head-chunk cache returning samples from the wrong chunk, or spurious not-found errors, to range queries after head-chunk truncation. #19134

3.5.5securityfixed

This release is built with Go 1.25.12 and fixes a security issue in a UI dependency. [SECURITY] UI: Bump sanitize-html to v2.17.5 to fix CVE-2026-53606. #19060

3.13.0securityaddedchanged

This is a Long Term Support LTS release. [SECURITY] UI: Bump sanitize-html to fix a cross-site scripting vulnerability (CVE-2026-44990). #18697 [CHANGE] UI: Third-party npm dependency licenses are now embedded in the Prometheus binary and s

3.5.4securityfixed

This release fixes multiple security issues. [SECURITY] STACKIT SD: Fix secrets being exposed in plaintext via /-/config endpoint. Thanks to @August829 and @Phaxma for reporting. GHSA-39j6-789q-qxvh #18650 [SECURITY] Dependencies: Bump gola

3.12.0securityaddedfixed

This release contains security fixes, new features (especially around PromQL and Service Discovery), performance improvements in TSDB, Start Timestamp improvements and numerous bug fixes. Thanks to all contributors! Key Highlights Security:

3.11.3securityfixed

This release fixes mutiple security issues. We would like to thank the following people for the responsible disclosures: Shadowbyte (4c1dr3aper) - Charlie Lewis for the Remote-Read snappy decode vulnerability. Brett Gervasoni for the AzureA

3.5.3securityfixed

This release fixes mutiple security issues. We would like to thank the following people for the responsible disclosures: Shadowbyte (4c1dr3aper) - Charlie Lewis for the Remote-Read snappy decode vulnerability. Brett Gervasoni for the AzureA

3.11.2securityadded

This release has a fix for a Stored XSS vulnerability that can be triggered via crafted metric names and label values in Prometheus web UI tooltips and metrics explorer. Thanks to Duc Anh Nguyen from TinyxLab for reporting it. [SECURITY] UI

3.5.2security

This release has a fix for a Stored XSS vulnerability that can be triggered via crafted metric names and label values in Prometheus web UI tooltips and metrics explorer. Thanks to Duc Anh Nguyen from TinyxLab for reporting it. [SECURITY] UI

3.11.1

[BUGFIX] Tracing: Fix startup failure for OTLP HTTP tracing with insecure: true. #18469

3.11.0securityaddedchanged

[CHANGE] Hetzner SD: The __meta_hetzner_datacenter label is deprecated for the role robot but kept for backward compatibility, use the __meta_hetzner_robot_datacenter label instead. For the role hcloud, the label is deprecated and will stop

3.10.0securityaddedchanged

Prometheus now offers a distroless Docker image variant alongside the default busybox image. The distroless variant provides enhanced security with a minimal base image, uses UID/GID 65532 (nonroot) instead of nobody, and removes the VOLUME

3.5.1changed

This is the current "Long Term Support" release. No code changes since 3.5.0, just some dependency updates: Docker library updated from 28.2.2 to 28.5.2. #17821 Built with Go 1.24.11.

3.9.1

[BUGFIX] Agent: fix crash shortly after startup from invalid type of object. #17802 [BUGFIX] Scraping: fix relabel keep/drop not working. #17807

3.9.0addedfixed

Note for users of Native Histograms In version 3.9, Native Histograms is no longer experimental, and the feature flag native-histogram has no effect. You must now turn on the config setting scrape_native_histograms to collect Native Histogr

3.8.1

[BUGFIX] remote: Fix Remote Write receiver, so it does not send wrong response headers for v1 flow and cause Prometheus senders to emit false partial error log and metrics. #17683

3.8.0addedchanged

Note for users of Native Histograms This is the first release with Native Histograms as a stable feature. However, scraping Native Histograms has to be activated explicitly via the scrape_native_histograms config setting (newly introduced i

3.7.3changed

[BUGFIX] UI: Revert changed (and breaking) redirect behavior for -web.external-url if -web.route-prefix is configured, which was introduced in #17240. #17389 [BUGFIX] Fix federation of some native histograms. #17299 #17409 [BUGFIX] promtool

3.7.2

[BUGFIX] AWS SD: Fix AWS SDK v2 credentials handling for EC2 and Lightsail discovery. #17355 [BUGFIX] AWS SD: Load AWS region from IMDS when not set. #17376 [BUGFIX] Relabeling: Fix labelmap action validation with the legacy metric name val

3.7.1breaking

[BUGFIX] OTLP: Prefix key_ to label name when translating an OTel attribute name starting with a single underscore, and keep multiple consecutive underscores in label name when translating an OTel attribute name. This reverts the breaking c

3.7.0breakingaddedchanged

Warning We discovered a breaking change in the OTLP endpoint: OpenTelemetry attribute names starting with underscore, for example _attrib, are no longer automatically translated to key_attrib. Please use 3.7.1 instead for OTLP ingestion. Ch

3.6.0addedchanged

[FEATURE] PromQL: Add step(), and min() and max() on durations, behind feature flag promql-duration-expr. #16777 [FEATURE] API: Add a /v1/status/tsdb/blocks endpoint exposing metadata about loaded blocks. #16695 [FEATURE] Templates: Add toD

3.5.0breakingaddedchanged

is a Long Term Support (LTS) release; see release https://prometheus.io/docs/introduction/release-cycle/ There are a number of new features, and no known breaking changes in this release: [FEATURE] PromQL: Add experimental type and unit met

3.4.2

[BUGFIX] OTLP receiver: Fix default configuration not being respected if the otlp: block is unset in the config file. #16693

3.4.1added

[BUGFIX] Parser: Add reproducer for a dangling-reference issue in parsers. #16633

3.4.0added

[CHANGE] Config: Make setting out-of-order native histograms feature (--enable-feature=ooo-native-histograms) a no-op. Out-of-order native histograms are now always enabled when out_of_order_time_window is greater than zero and --enable-fea

3.3.1changed

[BUGFIX] Azure SD: Fix panic on malformed log message. #16434 #16210 [BUGFIX] Config: Update GOGC before loading TSDB. #16491

3.3.0addedchangedremoved

[FEATURE] PromQL: Implement idelta() and irate() for native histograms. #15853 [ENHANCEMENT] Scaleway SD: Add __meta_scaleway_instance_public_ipv4_addresses and __meta_scaleway_instance_public_ipv6_addresses labels. #14228 [ENHANCEMENT] TSD

3.2.1

[BUGFIX] Don't send Accept header escape=allow-utf-8 when metric_name_validation_scheme: legacy is configured. #16061

3.2.0added

Prometheus v3.2.0 Changelog [CHANGE] relabel: Replace actions can now use UTF-8 characters in targetLabel field. Note that $<chars> or ${<chars>} will be expanded. This also apply to replacement field for LabelMap action. #15851 [CHANGE] ru

3.1.0securityaddedfixed

[SECURITY] upgrade golang.org/x/crypto to address reported CVE-2024-45337. #15691 [CHANGE] Notifier: Increment prometheus_notifications_errors_total by the number of affected alerts rather than per batch. #15428 [CHANGE] API: list rules fie

3.0.1

The first bug fix release for Prometheus 3. [BUGFIX] Promql: Make subqueries left open. #15431 [BUGFIX] Fix memory leak when query log is enabled. #15434 [BUGFIX] Support utf8 names on /v1/label/:name/values endpoint. #15399

3.0.0breakingaddedfixed

This release includes new features such as a brand new UI and UTF-8 support enabled by default. As this marks the first new major version in seven years, several breaking changes are introduced. The breaking changes are mainly around the re