diff --git a/docs/querying/api.md b/docs/querying/api.md index 67df15d0a7..1ff3beef17 100644 --- a/docs/querying/api.md +++ b/docs/querying/api.md @@ -85,6 +85,7 @@ URL query parameters: - `timeout=`: Evaluation timeout. Optional. Defaults to and is capped by the value of the `-query.timeout` flag. - `limit=`: Maximum number of returned series. Doesn’t affect scalars or strings but truncates the number of series for matrices and vectors. Optional. 0 means disabled. +- `lookback_delta=`: Override the the [lookback period](#staleness) just for this query. Optional. The current server time is used if the `time` parameter is omitted. @@ -157,6 +158,7 @@ URL query parameters: - `timeout=`: Evaluation timeout. Optional. Defaults to and is capped by the value of the `-query.timeout` flag. - `limit=`: Maximum number of returned series. Optional. 0 means disabled. +- `lookback_delta=`: Override the the [lookback period](#staleness) just for this query. Optional. You can URL-encode these parameters directly in the request body by using the `POST` method and `Content-Type: application/x-www-form-urlencoded` header. This is useful when specifying a large diff --git a/docs/querying/basics.md b/docs/querying/basics.md index 73f4c42549..4a4f9ada37 100644 --- a/docs/querying/basics.md +++ b/docs/querying/basics.md @@ -393,6 +393,7 @@ Prometheus needs to assign a value at those timestamps for each relevant time series. It does so by taking the newest sample that is less than the lookback period ago. The lookback period is 5 minutes by default, but can be [set with the `--query.lookback-delta` flag](../command-line/prometheus.md) +or overridden on an individual query via the `lookback_delta` parameter. If a target scrape or rule evaluation no longer returns a sample for a time series that was previously present, this time series will be marked as stale.