mirrors/prometheus
1
0
Fork 0
mirror of https://github.com/prometheus/prometheus.git synced 2026-05-04 20:06:12 +02:00
Code Issues Projects Releases Wiki Activity

Update duration expr documentation

Browse Source 
Signed-off-by: Julien Pivotto <291750+roidelapluie@users.noreply.github.com>
This commit is contained in:
Julien Pivotto 2025-03-24 14:41:48 +01:00
parent 9cfd6f7df8
commit 2e0a4ef096
1 changed files with 20 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
docs/feature_flags.md
View File

@ -187,7 +187,19 @@ state is mutex guarded. Cumulative-only OTLP requests are not affected.
`--enable-feature=promql-duration-expr`
With this flag, arithmetic expressions can also be used in time durations. The following operators are supported:
With this flag, arithmetic expressions can be used in time durations in range queries and offset durations. For example:
In range queries:
rate(http_requests_total[5m * 2]) # 10 minute range
rate(http_requests_total[(5+2) * 1m]) # 7 minute range
In offset durations:
http_requests_total offset (1h / 2) # 30 minute offset
http_requests_total offset ((2 ^ 3) * 1m) # 8 minute offset
Note: Duration expressions are not supported in the @ timestamp operator.
The following operators are supported:
* `+` - addition
* `-` - subtraction
@ -196,13 +208,13 @@ With this flag, arithmetic expressions can also be used in time durations. The f
* `%` - modulo
* `^` - exponentiation
Examples:
Examples of equivalent durations:
5m * 2 # Equivalent to 10m or 600s
10m - 1m # Equivalent to 9m or 540s
(5+2) * 1m # Equivalent to 7m or 420s
1h / 2 # Equivalent to 30m or 1800s
4h % 3h # Equivalent to 1h or 3600s
(2 ^ 3) * 1m # Equivalent to 8m or 480s
* `5m * 2` is the equivalent to `10m` or `600s`
* `10m - 1m` is the equivalent to `9m` or `540s`
* `(5+2) * 1m` is the equivalent to `7m` or `420s`
* `1h / 2` is the equivalent to `30m` or `1800s`
* `4h % 3h` is the equivalent to `1h` or `3600s`
* `(2 ^ 3) * 1m` is the equivalent to `8m` or `480s`
[d2c]: https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/processor/deltatocumulativeprocessor