Add a note about enabling time series index mode via a component temp…

…late (#110050) (#110119) Closes #109149 Co-authored-by: Elastic Machine <[email protected]>
elastic · Jan 17, 2025 · ad2a807 · ad2a807
1 parent d186cab
commit ad2a807
Showing 1 changed file with 14 additions and 0 deletions.
diff --git a/docs/reference/data-streams/set-up-tsds.asciidoc b/docs/reference/data-streams/set-up-tsds.asciidoc
@@ -279,6 +279,20 @@ POST metrics-weather_sensors-dev/_rollover
 // TEST[setup:tsds]
 // TEST[teardown:tsds_cleanup]
 
+[discrete]
+[[set-up-component-templates]]
+==== A note about component templates and index.mode setting
+
+Configuring a TSDS via an index template that uses component templates is a bit more complicated.
+Typically with component templates mappings and settings get scattered across multiple component templates.
+When configuring the `index.mode` setting in a component template, the `index.routing_path` setting needs to
+be defined in the same component template. Additionally the fields mentioned in the `index.routing_path`
+also need to be defined in the same component template with the `time_series_dimension` attribute enabled.
+
+The reasons for this is that each component template needs to be valid on its own and the time series index mode
+requires the `index.routing_path` setting. When configuring the  `index.mode` setting in an index template, the `index.routing_path` setting is configured automatically. It is derived  from
+the field mappings with `time_series_dimension` attribute enabled.
+
 [discrete]
 [[set-up-tsds-whats-next]]
 ==== What's next?