Skip to content

Commit 415ff6a

Browse files
jrodewigabdonpijpelinkstefnestor
authored
[8.9] [DOC+] ILM min_age interpretation (#98245) (#98853)
Co-authored-by: Abdon Pijpelink <[email protected]> Co-authored-by: Stef Nestor <[email protected]> fixes) in 2021 and we later ported errors to [this doc](https://www.elastic.co/guide/en/elasticsearch/reference/master/index-lifecycle-error-handling.html) via #75849, the remaining top-gotcha user's raise is "Common issue 3" that ILM's `min_age` calculates off rollover time fallback index creation time.
1 parent f092b42 commit 415ff6a

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

docs/reference/ilm/error-handling.asciidoc

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -149,6 +149,20 @@ POST /my-index-000001/_ilm/retry
149149
{ilm-init} subsequently attempts to re-run the step that failed.
150150
You can use the <<ilm-explain-lifecycle,{ilm-init} Explain API>> to monitor the progress.
151151

152+
153+
[discrete]
154+
=== Common {ilm-init} setting issues
155+
156+
[discrete]
157+
==== How `min_age` is calculated
158+
159+
When setting up an <<set-up-lifecycle-policy,{ilm-init} policy>> or <<getting-started-index-lifecycle-management,automating rollover with {ilm-init}>>, be aware that`min_age` can be relative to either the rollover time or the index creation time.
160+
161+
If you use <<ilm-rollover,{ilm-init} rollover>>, `min_age` is calculated relative to the time the index was rolled over. This is because the <<indices-rollover-index,rollover API>> generates a new index. The `creation_date` of the new index (retrievable via <<indices-get-settings>>) is used in the calculation. If you do not use rollover in the {ilm-init} policy, `min_age` is calculated relative to the `creation_date` of the original index.
162+
163+
You can override how `min_age` is calculated using the `index.lifecycle.origination_date` and `index.lifecycle.parse_origination_date` <<ilm-settings,{ilm-init} settings>>.
164+
165+
152166
[discrete]
153167
=== Common {ilm-init} errors
154168

0 commit comments

Comments
 (0)