Skip to content

Commit 76f95e0

Browse files
Warn that cloned templates are not automatically updated (#2740)
Co-authored-by: Luca Belluccini <luca.belluccini@elastic.co>
1 parent c367798 commit 76f95e0

File tree

1 file changed

+11
-1
lines changed

1 file changed

+11
-1
lines changed

solutions/observability/apm/index-lifecycle-management.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -139,4 +139,14 @@ POST /traces-apm-default/_rollover/
139139

140140
## Namespace-level index lifecycle policies [apm-data-streams-custom-policy-namespace]
141141

142-
It is also possible to create more granular index lifecycle policies that apply to individual namespaces. This process is similar to the above tutorial, but includes cloning and modify the existing index template to use a new `*@custom` component template.
142+
It is also possible to create more granular index lifecycle policies that apply to individual namespaces. This process is similar to the tutorial, but includes cloning the original index template(s) and using the index lifecycle you've created in the cloned template(s).
143+
144+
**Use case:** Use cloned index templates only in situations where you need to add namespace-specific customizations to a data stream.
145+
146+
:::{important}
147+
- Cloning index templates is extremely risky because cloned templates are not automatically updated when you upgrade to a new product version. Users may find themselves in situations where their configurations are outdated because cloned templates are being used instead of the latest templates. <br><br>
148+
Any customization done using cloned index templates must be repeated _every time_ you upgrade to a new version.
149+
150+
- Do not edit built-in index templates, add extra component templates, or change template order. Interfering with templates can disrupt how APM data is processed.
151+
152+
:::

0 commit comments

Comments
 (0)