mirror of
https://github.com/prometheus/prometheus
synced 2026-04-21 07:00:27 +08:00
a48d348811
Some checks failed
buf.build / lint and publish (push) Has been cancelled
CI / Go tests (push) Has been cancelled
CI / More Go tests (push) Has been cancelled
CI / Go tests with previous Go version (push) Has been cancelled
CI / UI tests (push) Has been cancelled
CI / Go tests on Windows (push) Has been cancelled
CI / Mixins tests (push) Has been cancelled
CI / Build Prometheus for common architectures (0) (push) Has been cancelled
CI / Build Prometheus for common architectures (1) (push) Has been cancelled
CI / Build Prometheus for common architectures (2) (push) Has been cancelled
CI / Build Prometheus for all architectures (0) (push) Has been cancelled
CI / Build Prometheus for all architectures (1) (push) Has been cancelled
CI / Build Prometheus for all architectures (10) (push) Has been cancelled
CI / Build Prometheus for all architectures (11) (push) Has been cancelled
CI / Build Prometheus for all architectures (2) (push) Has been cancelled
CI / Build Prometheus for all architectures (3) (push) Has been cancelled
CI / Build Prometheus for all architectures (4) (push) Has been cancelled
CI / Build Prometheus for all architectures (5) (push) Has been cancelled
CI / Build Prometheus for all architectures (6) (push) Has been cancelled
CI / Build Prometheus for all architectures (7) (push) Has been cancelled
CI / Build Prometheus for all architectures (8) (push) Has been cancelled
CI / Build Prometheus for all architectures (9) (push) Has been cancelled
CI / Report status of build Prometheus for all architectures (push) Has been cancelled
CI / Check generated parser (push) Has been cancelled
CI / golangci-lint (push) Has been cancelled
CI / fuzzing (push) Has been cancelled
CI / codeql (push) Has been cancelled
CI / Publish main branch artifacts (push) Has been cancelled
CI / Publish release artefacts (push) Has been cancelled
CI / Publish UI on npm Registry (push) Has been cancelled
Scorecards supply-chain security / Scorecards analysis (push) Has been cancelled
Stale Check / stale (push) Has been cancelled
Lock Threads / action (push) Has been cancelled
Sync repo files / repo_sync (push) Has been cancelled
a bunch is marked as experimental in https://prometheus.io/docs/prometheus/latest/querying/api/ Signed-off-by: machine424 <ayoubmrini424@gmail.com>
44 lines
1.9 KiB
Markdown
44 lines
1.9 KiB
Markdown
---
|
|
title: API stability guarantees
|
|
nav_title: API stability
|
|
sort_rank: 11
|
|
---
|
|
|
|
Prometheus promises API stability within a major version, and strives to avoid
|
|
breaking changes for key features. Some features, which are cosmetic, still
|
|
under development, or depend on 3rd party services, are not covered by this.
|
|
|
|
Things considered stable for 3.x:
|
|
|
|
* The query language and data model
|
|
* Alerting and recording rules
|
|
* The ingestion exposition format
|
|
* v1 HTTP API (used by dashboards and UIs), excluding endpoints explicitly marked as experimental
|
|
* Configuration file format (minus the service discovery remote read/write, see below)
|
|
* Rule/alert file format
|
|
* Console template syntax and semantics
|
|
* Remote write sending, per the [1.0 specification](https://prometheus.io/docs/concepts/remote_write_spec/) and receiving
|
|
* Agent mode
|
|
* OTLP receiver endpoint
|
|
|
|
Things considered unstable for 3.x:
|
|
|
|
* Any feature listed as experimental or subject to change, including:
|
|
* The [`double_exponential_smoothing` PromQL function](https://github.com/prometheus/prometheus/issues/2458)
|
|
* Remote read and the remote read endpoint
|
|
* Server-side HTTPS and basic authentication
|
|
* Service discovery integrations, with the exception of `static_configs`, `file_sd_configs` and `http_sd_config`
|
|
* Go APIs of packages that are part of the server
|
|
* HTML generated by the web UI
|
|
* The metrics in the /metrics endpoint of Prometheus itself
|
|
* Exact on-disk format. Potential changes however, will be forward compatible and transparently handled by Prometheus
|
|
* The format of the logs
|
|
|
|
Prometheus 2.x stability guarantees can be found [in the 2.x documentation](https://prometheus.io/docs/prometheus/2.55/stability/).
|
|
|
|
As long as you are not using any features marked as experimental/unstable, an
|
|
upgrade within a major version can usually be performed without any operational
|
|
adjustments and very little risk that anything will break. Any breaking changes
|
|
will be marked as `CHANGE` in release notes.
|
|
|