mudhorn/prometheus
1
0
Fork 0
mirror of https://github.com/prometheus/prometheus.git synced 2024-12-26 14:09:41 -08:00
Code Issues Actions 3 Packages Projects Releases Wiki Activity

Document new staleness (#3380)

Browse source 
Remove "interpolation" for this heading, that hasn't
been in these docs for a long time.
This commit is contained in:
Brian Brazil 2017-11-01 12:40:47 +00:00 committed by GitHub
parent e86d82ad2d
commit 7187771f20
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 16 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
docs/querying/basics.md
View file

@ -177,7 +177,7 @@ in detail in the [expression language functions](functions.md) page.
## Gotchas ## Gotchas
### Interpolation and staleness ### Staleness
When queries are run, timestamps at which to sample data are selected When queries are run, timestamps at which to sample data are selected
independently of the actual present time series data. This is mainly to support independently of the actual present time series data. This is mainly to support
@ -186,14 +186,22 @@ time series do not exactly align in time. Because of their independence,
Prometheus needs to assign a value at those timestamps for each relevant time Prometheus needs to assign a value at those timestamps for each relevant time
series. It does so by simply taking the newest sample before this timestamp. series. It does so by simply taking the newest sample before this timestamp.
If no stored sample is found (by default) 5 minutes before a sampling timestamp, If a target scrape or rule evaluation no longer returns a sample for a time
no value is assigned for this time series at this point in time. This series that was previously present, that time series will be marked as stale.
effectively means that time series "disappear" from graphs at times where their If a target is removed, its previously returned time series will be marked as
latest collected sample is older than 5 minutes. stale soon afterwards.
NOTE: <b>NOTE:</b> Staleness and interpolation handling might change. See If a query is evaluated at a sampling timestamp after a time series is marked
https://github.com/prometheus/prometheus/issues/398 and stale, then no value is returned for that time series. If new samples are
https://github.com/prometheus/prometheus/issues/581. subsequently ingested for that time series, they will be returned as normal.
If no sample is found (by default) 5 minutes before a sampling timestamp,
no value is returned for that time series at this point in time. This
effectively means that time series "disappear" from graphs at times where their
latest collected sample is older than 5 minutes or after they are marked stale.
Staleness will not be marked for time series that have timestamps included in
their scrapes. Only the 5 minute threshold will be applied in that case.
### Avoiding slow queries and overloads ### Avoiding slow queries and overloads