upstream/prometheus
1
0
Fork 0
mirror of https://github.com/prometheus/prometheus.git synced 2026-03-21 18:10:42 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions 3

Update feature flag description

Browse source 
Signed-off-by: Carrie Edwards <edwrdscarrie@gmail.com>
This commit is contained in:
Carrie Edwards 2026-03-12 13:24:59 -07:00
parent b575f5e28b
commit b49ad5fc4b
1 changed files with 2 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
docs/feature_flags.md
View file

@ -317,12 +317,12 @@ disk compression than the default XOR encoding for typical Prometheus workloads.
1. **Staleness marker optimization**: When a scrape target disappears, Prometheus writes a special "staleness marker" to indicate the series has ended. Standard XOR encoding uses ~110 bits per marker; XOR2 uses only 13 bits—a **90% reduction**. For deployments with dynamic infrastructure (Kubernetes pods, auto-scaling, short-lived jobs), staleness markers can represent 10-40% of all samples.
2. **Adaptive timestamp encoding**: XOR2 automatically optimizes for both regular and irregular scrape intervals. Regular data gets the same compression as standard XOR (zero overhead), while irregular data benefits from improved encoding that handles larger timestamp variations more efficiently.
This feature also introduces the fields needed for encoding start timestamps. `xor2-encoding` is automatically enabled when `st-storage` is enabled.
Chunks encoded with XOR2 **cannot be read by older Prometheus versions** that do not support
the encoding. Once enabled and data is written, downgrading requires waiting for
all XOR2 chunks to be compacted out of retention.
This feature is automatically enabled when `st-storage` is enabled.
## Extended Range Selectors
`--enable-feature=promql-extended-range-selectors`