API Stability Guarantees

    • The query language and data model
    • Alerting and recording rules
    • The ingestion exposition format
    • v1 HTTP API (used by dashboards and UIs)
    • Configuration file format (minus the service discovery remote read/write, see below)
    • Console template syntax and semantics
    • Any feature listed as experimental or subject to change, including:
    • Server-side HTTPS and basic authentication
    • 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