Skip to content

Conversation

karenzone
Copy link
Contributor

@karenzone karenzone commented Aug 27, 2025

@karenzone karenzone self-assigned this Aug 27, 2025
@karenzone
Copy link
Contributor Author

@lucabelluccini, we can definitely add a note to the docs.
Is there a compelling use case for cloning templates? This seems risky, and asking users to remember to repeat this process on every upgrade seems like a lot.

Is there a product enhancement request to make upgrading cloned templates easier? Or at least to check and warn?

Copy link

github-actions bot commented Aug 27, 2025

🔍 Preview links for changed docs

@karenzone karenzone marked this pull request as ready for review August 27, 2025 22:19
@karenzone karenzone requested a review from a team as a code owner August 27, 2025 22:19
Copy link
Contributor

@mdbirnstiehl mdbirnstiehl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

Copy link
Contributor

@lucabelluccini lucabelluccini left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've left some suggestions.
I would like to "reinforce" the message that cloning index template is really necessary only when a user wants a customization per namespace.

The other info we might share here is that this @custom component template technique can be used also for other customizations (not just ILM).

I would also warn users explicitly to never edit the built-in/provided index templates nor to add extra component templates on top of the existing ones, or change the order of the component templates as it might break the correct behavior of the Observability applications relying on the APM data.

@karenzone karenzone merged commit 76f95e0 into elastic:main Aug 29, 2025
7 checks passed
@karenzone karenzone deleted the 1851-cloning branch August 29, 2025 23:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[DOCS] Warn APM Index Template cloning is dangerous

3 participants