mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-04-25 07:37:19 -04:00
64 lines
3 KiB
Text
64 lines
3 KiB
Text
[[tsds-index-settings]]
|
|
=== Time series index settings
|
|
|
|
Backing indices in a <<tsds,time series data stream (TSDS)>> support the
|
|
following index settings.
|
|
|
|
[[index-mode]]
|
|
`index.mode`::
|
|
(<<_static_index_settings,Static>>, string) Mode for the index.
|
|
Valid values are <<time-series-mode,`time_series`>> and `null` (no mode).
|
|
Defaults to `null`.
|
|
|
|
[[index-time-series-start-time]]
|
|
`index.time_series.start_time`::
|
|
(<<_static_index_settings,Static>>, string) Earliest `@timestamp`
|
|
value (inclusive) accepted by the index. Only indices with an `index.mode` of
|
|
<<time-series-mode,`time_series`>> support this setting. For more information,
|
|
refer to <<time-bound-indices>>.
|
|
|
|
[[index-time-series-end-time]]
|
|
`index.time_series.end_time`::
|
|
(<<dynamic-index-settings,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]]
|
|
`index.look_ahead_time`::
|
|
(<<_static_index_settings,Static>>, <<time-units,time units>>)
|
|
Interval used to calculate the `index.time_series.end_time` for a TSDS's write
|
|
index. Defaults to `30m` (30 minutes). Accepts `1m` (one minute) to `2h` (two
|
|
hours). Only indices with an `index.mode` of `time_series` support this setting.
|
|
For more information, refer to <<tsds-look-ahead-time>>. Additionally this setting
|
|
can not be less than `time_series.poll_interval` cluster setting.
|
|
|
|
NOTE: Increasing the `look_ahead_time` will also increase the amount of time {ilm-cap}
|
|
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]]
|
|
`index.look_back_time`::
|
|
(<<_static_index_settings,Static>>, <<time-units,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 <<tsds-look-back-time>>.
|
|
|
|
[[index-routing-path]] `index.routing_path`::
|
|
(<<_static_index_settings,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 <<time-series-dimension,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]]
|
|
// tag::dimensions-limit[]
|
|
`index.mapping.dimension_fields.limit`::
|
|
(<<dynamic-index-settings,Dynamic>>, integer)
|
|
Maximum number of <<time-series-dimension,time series dimensions>> for the
|
|
index. Defaults to `21`.
|
|
// end::dimensions-limit[]
|