diff --git a/docs/reference/data-streams/downsampling-ilm.asciidoc b/docs/reference/data-streams/downsampling-ilm.asciidoc index 58fa15a56aca9..94990040d79f1 100644 --- a/docs/reference/data-streams/downsampling-ilm.asciidoc +++ b/docs/reference/data-streams/downsampling-ilm.asciidoc @@ -37,8 +37,17 @@ To enable downsampling, add a <> and set which you want to aggregate the original time series data. In this example, an ILM policy is configured for the `hot` phase. The downsample -takes place after the initial index rollover, which for demonstration -purposes is set to run after five minutes. +takes place after the index is rolled over and the <> +has lapsed as the source index is still expected to receive major writes until then. +{ilm-cap} will not proceed with any action that expects the index to not receive +writes anymore until the <> has +passed. The {ilm-cap} actions that wait on the end time before proceeding are: +- <> +- <> +- <> +- <> +- <> +- <> [source,console] ---- diff --git a/docs/reference/data-streams/tsds-index-settings.asciidoc b/docs/reference/data-streams/tsds-index-settings.asciidoc index fa5c9b8cd821f..e31f294d31788 100644 --- a/docs/reference/data-streams/tsds-index-settings.asciidoc +++ b/docs/reference/data-streams/tsds-index-settings.asciidoc @@ -33,6 +33,10 @@ days). Only indices with an `index.mode` of `time_series` support this setting. For more information, refer to <>. Additionally this setting can not be less than `time_series.poll_interval` cluster setting. +NOTE: Increasing the `look_ahead_time` will also increase the amount of time {ilm-cap} +waits before being able to proceed with executing the actions that expect the +index to not receive any writes anymore. For more information, refer to <>. + [[index-routing-path]] `index.routing_path`:: (<<_static_index_settings,Static>>, string or array of strings) Plain `keyword` fields used to route documents in a TSDS to index shards. Supports wildcards diff --git a/docs/reference/data-streams/tsds.asciidoc b/docs/reference/data-streams/tsds.asciidoc index ae3387f3d2daf..f8829558af14e 100644 --- a/docs/reference/data-streams/tsds.asciidoc +++ b/docs/reference/data-streams/tsds.asciidoc @@ -218,10 +218,17 @@ if the index isn't the most recent backing index. image::images/data-streams/time-bound-indices.svg[align="center"] -TIP: Some {ilm-init} actions, such as <>, -<>, and <>, -make a backing index read-only. You cannot add documents to read-only indices. -Keep this in mind when defining the index lifecycle policy for your TSDS. +TIP: Some {ilm-init} actions mark the source index as read-only, or expect the index +to not be actively written anymore in order to provide good performance. These actions are: +- <> +- <> +- <> +- <> +- <> +- <> +{ilm-cap} will **not** proceed with executing these actions until the upper time-bound +for accepting writes, represented by the <> +index setting, has lapsed. If no backing index can accept a document's `@timestamp` value, {es} rejects the document.