diff --git a/docs/reference/ilm/actions/ilm-rollover.asciidoc b/docs/reference/ilm/actions/ilm-rollover.asciidoc index acfdb362fc4e8..c3cda2f84e143 100644 --- a/docs/reference/ilm/actions/ilm-rollover.asciidoc +++ b/docs/reference/ilm/actions/ilm-rollover.asciidoc @@ -49,7 +49,9 @@ Triggers roll over after the specified maximum primary shard index storage size `max_docs`:: (Optional, integer) -Triggers roll over after the specified maximum number of documents in the index is reached. +Triggers roll over after the specified maximum number of documents is reached. +Documents added since the last refresh are not included in the document count. +The document count does *not* include documents in replica shards. `max_age`:: (Optional, <>) diff --git a/docs/reference/ilm/ilm-index-lifecycle.asciidoc b/docs/reference/ilm/ilm-index-lifecycle.asciidoc index 1369418a54ea8..c03fbdb7bee32 100644 --- a/docs/reference/ilm/ilm-index-lifecycle.asciidoc +++ b/docs/reference/ilm/ilm-index-lifecycle.asciidoc @@ -48,6 +48,17 @@ This ensures that policy updates don't put the index into a state where it can n If changes can be safely applied, {ilm-init} updates the cached phase definition. If they cannot, phase execution continues using the cached definition. +{ilm-init} runs periodically, checks to see if an index meets policy criteria, +and executes whatever steps are needed. +To avoid race conditions, {ilm-init} might need to run more than once to execute all of the steps +required to complete an action. +For example, if {ilm-init} determines that an index has met the rollover criteria, +it begins executing the steps required to complete the rollover action. +If it reaches a point where it is not safe to advance to the next step, execution stops. +The next time {ilm-init} runs, {ilm-init} picks up execution where it left off. +This means that even if `indices.lifecycle.poll_interval` is set to 10 minutes and an index meets +the rollover criteria, it could be 20 minutes before the rollover is complete. + [discrete] [[ilm-phase-actions]] === Phase actions diff --git a/docs/reference/indices/rollover-index.asciidoc b/docs/reference/indices/rollover-index.asciidoc index 7e5da9bb40bbc..368d93ae085f6 100644 --- a/docs/reference/indices/rollover-index.asciidoc +++ b/docs/reference/indices/rollover-index.asciidoc @@ -140,7 +140,8 @@ Maximum age of the index. `max_docs`:: (Optional, integer) Maximum number of documents in the index. -This number does *not* include documents in replica shards. +Documents added since the last refresh are not included in the document count. +The document count does *not* include documents in replica shards. `max_size`:: (Optional, <>)