Skip to content

Commit 2113ff3

Browse files
stefnestordakrone
andauthored
[+DOC][ILM] age calculation resets post rollover (#103662)
* [+DOC][ILM] age calculation 👋 howdy, team! I have the internal belief/understanding that [ILM Explain](https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-explain-lifecycle.html)'s `age` calculates based off rollover time fall back index creation time (or ILM creation time override settings). However, I'm not able to find that currently in existing docs, so adding it to [ILM > Phase Transitions](https://www.elastic.co/guide/en/elasticsearch/reference/8.11/ilm-index-lifecycle.html#ilm-phase-transitions) Background: This relates to > ([doc](https://www.elastic.co/guide/en/elasticsearch/reference/current/getting-started-index-lifecycle-management.html#ilm-gs-check-progress)) The `age` of the indexed used to transition to the next phase (in this case it is the same with the age of the index). Uh... I'm not actually(/currently) finding an official Elastic doc confirming `age` works off index creation time override to rollover time, but I know that's correspondingly true from the blog I wrote that LeeH had signed-off > ([blog](https://www.elastic.co/blog/troubleshooting-elasticsearch-ilm-common-issues-and-fixes)) **Common issue 3: min_age calculation clarification** > When working with customers, I have seen confusion about how `min_age` works. The min_age [must increase](https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-index-lifecycle.html#ilm-phase-transitions) between subsequent phases. If rollover is used, min_age is calculated off the rollover date. This is because rollover generates a new index and the new index’s creation date is used in the calculation. Otherwise, min_age is calculated off the original index’s creation date. We're working to tighten-ship on docs+api for users to self-service understanding > (internal link) The `age` of an index is calculated based on: > - The `index_creation_date_millis` of the index IF it did not go through `hot.rollover` > - The rollover time of the index (TODO: `time_since_index_rollover`) IF it went through `hot.rollover` (noting rollover resets `age`) > - Index ILM Setting overrides `index.lifecycle.origination_date` or `index.lifecycle.parse_origination_date` (related [blog](https://www.elastic.co/blog/control-ilm-phase-transition-timings-using-origination-date)) * Apply suggestions from code review Co-authored-by: Lee Hinman <[email protected]> --------- Co-authored-by: Lee Hinman <[email protected]>
1 parent ce190e7 commit 2113ff3

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

docs/reference/ilm/ilm-index-lifecycle.asciidoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,8 +33,8 @@ update.
3333
[[ilm-phase-transitions]]
3434
=== Phase transitions
3535

36-
{ilm-init} moves indices through the lifecycle according to their age.
37-
To control the timing of these transitions, you set a _minimum age_ for each phase. For an index to
36+
{ilm-init} moves indices through the lifecycle according to their `age` (time since rollover, falling back to index creation if it has not yet rolled over).
37+
To control the timing of these transitions, you set a _minimum age_ `min_age` for each phase. For an index to
3838
move to the next phase, all actions in the current phase must be complete and the index must be
3939
older than the minimum age of the next phase. Configured minimum ages must increase between
4040
subsequent phases, for example, a "warm" phase with a minimum age of 10 days can only be followed by

0 commit comments

Comments
 (0)