Skip to content
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
navigation_title: Configure a policy
navigation_title: Configure a lifecycle policy
mapped_pages:
- https://www.elastic.co/guide/en/elasticsearch/reference/current/set-up-lifecycle-policy.html
applies_to:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,14 @@ products:

# Manually apply a lifecycle policy to an index [apply-policy-manually]

When you create new {{es}} index you can use an index template to apply the lifecycle policy by which the index will be managed. This process is described in [Configure a lifecycle policy](/manage-data/lifecycle/index-lifecycle-management/configure-lifecycle-policy.md).
When you create a new {{es}} index, if the index name matches an index pattern configured in an [index template](/manage-data/data-store/templates.md#index-templates), the new index automatically inherits any settings, mappings, and aliases that are defined in the index template or in any component templates that the index template references. If the template specifies a lifecycle policy, that policy is applied automatically to the newly created index. This process is described in detail in [Configure a lifecycle policy](/manage-data/lifecycle/index-lifecycle-management/configure-lifecycle-policy.md).

You can also manually apply a lifecycle policy to an existing index, as described on this page. If an index is currently managed by an ILM policy you must first remove that policy before applying a new one. Refer to [Switch to a different lifecycle policy](/manage-data/lifecycle/index-lifecycle-management/policy-updates.md#switch-lifecycle-policies) for details.
You can also apply a lifecycle policy manually to existing indices, as described on this page. This is useful if you want to:
* Configure the indices to move through different [data tiers](/manage-data/lifecycle/data-tiers.md) as they age.
* Perform [lifecycle actions](elasticsearch://reference/elasticsearch/index-lifecycle-actions/index.md) such as downsampling or shrinking.
* Delete the indices when they reach a certain age.

If an index is currently managed by an ILM policy you must first remove that policy before applying a new one. Refer to [Switch to a different lifecycle policy](/manage-data/lifecycle/index-lifecycle-management/policy-updates.md#switch-lifecycle-policies) for details.

You can do this procedure in {{kib}} or using the {{es}} API.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,13 @@ products:

# View the lifecycle status of an index or data stream [view-lifecycle-status]

For any existing managed index or data stream in your cluster, you can access the ILM policy applied to it and its current status.
For any existing managed index or data stream in your cluster, you can access the {{ilm-init}} policy applied to it and its current status.

You can do this procedure in {{kib}} or using the {{es}} API.

:::{tip}
If you're investigating an {{ilm-init}}-related problem, you can also refer to [Troubleshoot index and snapshot lifecycle management](/troubleshoot/elasticsearch/start-ilm.md) and [Fix index lifecycle management errors](/troubleshoot/elasticsearch/index-lifecycle-management-errors.md) in the {{es}} chapter of the **Troubleshoot** section.
:::

:::::{tab-set}
:group: kibana-api
Expand Down
Loading