●Change8

Migrating to Prometheus v3.13.0-rc.0

Version v3.13.0-rc.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 7/9/2026

2
Breaking Changes
1
Migration Steps
10
Affected Symbols

⚠️ Check Your Code

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

min() (PromQL function)max() (PromQL function)min_of() (PromQL function)max_of() (PromQL function)predict_linear() (PromQL function)fill_left() (PromQL function)fill_right() (PromQL function)resets() (PromQL function)changes() (PromQL function)prometheus_engine_query_samples_read_total (metric)

Breaking Changes

●Issue #1

HTTP clients: Credentials (Authorization header, basic auth, bearer token, OAuth2, configured headers) are no longer forwarded when following a redirect to a different host. This affects scraping, remote read/write, alerting, and service discovery. If you rely on credentials being forwarded across host redirects, you must update your configuration or ensure redirects stay on the same host.

●Issue #2

PromQL: The experimental duration-expression functions `min()` and `max()` have been renamed to `min_of()` and `max_of()`. Update any usage of these functions in PromQL queries.

Migration Steps

  1. 1
    If you were using the experimental duration-expression functions `min()` or `max()`, rename them to `min_of()` and `max_of()` respectively in your PromQL queries.

Release Summary

This release introduces new experimental PromQL search endpoints and scalar functions, alongside significant performance improvements in TSDB and label matching. It also fixes a critical XSS vulnerability and addresses several PromQL and TSDB stability issues.

Need More Details?

View the full release notes and all changes for Prometheus v3.13.0-rc.0.

View Full Changelog