IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Set up a time series data stream (TSDS) Downsampling a time series data stream »
Elastic Docs ›Elasticsearch Guide [8.12] ›Data streams ›Time series data stream (TSDS)

Time series index settings

edit
IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Time series index settings

edit

Backing indices in a time series data stream (TSDS) support the following index settings.

index.mode
(Static, string) Mode for the index. Valid values are time_series and null (no mode). Defaults to null.
index.time_series.start_time
(Static, string) Earliest @timestamp value (inclusive) accepted by the index. Only indices with an index.mode of time_series support this setting. For more information, refer to Time-bound indices.
index.time_series.end_time
(Dynamic, string) Latest @timestamp value (exclusive) accepted by the index. Only indices with an index.mode of time_series support this setting. For more information, refer to Time-bound indices.
index.look_ahead_time
(Static, time units) Interval used to calculate the index.time_series.end_time for a TSDS’s write index. Defaults to 2h (2 hours). Accepts 1m (one minute) to 7d (seven days). Only indices with an index.mode of time_series support this setting. For more information, refer to Look-ahead time. Additionally this setting can not be less than time_series.poll_interval cluster setting.

Increasing the look_ahead_time will also increase the amount of time Index lifecycle management waits before being able to proceed with executing the actions that expect the index to not receive any writes anymore. For more information, refer to Time-bound indices.

index.look_back_time
(Static, time units) Interval used to calculate the index.time_series.start_time for a TSDS’s first backing index when a tsdb data stream is created. Defaults to 2h (2 hours). Accepts 1m (one minute) to 7d (seven days). Only indices with an index.mode of time_series support this setting. For more information, refer to Look-back time.
index.routing_path
(Static, string or array of strings) Plain keyword fields used to route documents in a TSDS to index shards. Supports wildcards (*). Only indices with an index.mode of time_series support this setting. Defaults to an empty list, except for data streams then defaults to the list of dimension fields with a time_series_dimension value of true defined in your component and index templates. For more information, refer to Dimension-based routing.
index.mapping.dimension_fields.limit
(Dynamic, integer) Maximum number of time series dimensions for the index. Defaults to 21.
« Set up a time series data stream (TSDS) Downsampling a time series data stream »