Commit f0bd055c authored by Kevin Azzam's avatar Kevin Azzam

Update section on interpolation (and update link to relevant issue)

parent 981f6515
...@@ -170,23 +170,20 @@ in detail in the [expression language functions](/docs/querying/functions/) page ...@@ -170,23 +170,20 @@ in detail in the [expression language functions](/docs/querying/functions/) page
### Interpolation and staleness ### Interpolation and 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
independent 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
cases like aggregation (`sum`, `avg`, and so on), where multiple aggregated cases like aggregation (`sum`, `avg`, and so on), where multiple aggregated
time series do not exactly align in time. At every one of these predetermined time series do not exactly align in time. Because of their independence,
sampling times, Prometheus searches for the closest surrounding samples and Prometheus needs to assign a value at those timestamps for each relevant time
linearly interpolates a timestamp-value pair between the actual stored samples. series. It does so by simply taking the newest sample before this timestamp.
That means that the generated sample has timestamp and sample values which are
somewhere in between the timestamp and sample values of the surrounding samples If no stored sample is found (by default) 5 minutes before a sampling timestamp,
(depending on how close the query timestamp is to either surrounding point). no value is assigned for this time series at this point in time. This
effectively means that time series "disappear" from graphs at times where their
If no stored sample is found either (by default) 5 minutes before or after a latest collected sample is older than 5 minutes.
sampling timestamp, no interpolated sample is generated for this time series at
this point in time. This effectively means that time series "disappear" from
graphs at times where their latest collected sample is 5 older than 5 minutes.
NOTE: <b>NOTE:</b> Staleness and interpolation handling might change. See NOTE: <b>NOTE:</b> Staleness and interpolation handling might change. See
https://github.com/prometheus/prometheus/issues/398 and https://github.com/prometheus/prometheus/issues/398 and
https://github.com/prometheus/prometheus/issues/386. https://github.com/prometheus/prometheus/issues/581.
### Avoiding slow queries and overloads ### Avoiding slow queries and overloads
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment