Data stream lifecycle settings in Elasticsearchedit
This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.
These are the settings available for configuring data stream lifecycle.
Cluster level settingsedit
-
data_streams.lifecycle.poll_interval -
(Dynamic, time unit value)
How often Elasticsearch checks what is the next action for all data streams with a built-in lifecycle. Defaults to
5m.
-
cluster.lifecycle.default.rollover -
(Dynamic, string) This property accepts a key value pair formatted string and configures the conditions that would trigger a data stream to rollover when it has
lifecycleconfigured. This property is an implementation detail and subject to change. Currently, it defaults tomax_age=auto,max_primary_shard_size=50gb,min_docs=1,max_primary_shard_docs=200000000, this means that your data stream will rollover if any of the following conditions are met:- Either any primary shard reaches the size of 50GB,
- or any primary shard contains 200.000.000 documents
- or the index reaches a certain age which depends on the retention time of your data stream,
- and has at least one document.
-
data_streams.lifecycle.target.merge.policy.merge_factor -
(Dynamic, integer)
Data stream lifecycle implements tail merging by
updating the lucene merge policy factor for the target backing index. The merge factor
is both the number of segments that should be merged together, and the maximum number
of segments that we expect to find on a given tier.
This setting controls what value does Data stream lifecycle
configures on the target index. It defaults to
16. The value will be visible under theindex.merge.policy.merge_factorindex setting on the target index.
-
data_streams.lifecycle.target.merge.policy.floor_segment -
(Dynamic)
Data stream lifecycle implements tail merging by
updating the lucene merge policy floor segment for the target backing index. This floor
segment size is a way to prevent indices from having a long tail of very small segments.
This setting controls what value does data stream lifecycle
configures on the target index. It defaults to
100MB.
-
data_streams.lifecycle.signalling.error_retry_interval -
(Dynamic, integer)
Represents the number of retries data stream lifecycle has to perform for an index
in an error step in order to signal that the index is not progressing (i.e. it’s
stuck in an error step).
The current signalling mechanism is a log statement at the
errorlevel however, the signalling mechanism can be extended in the future. Defaults to 10 retries.
Index level settingsedit
The following index-level settings are typically configured on the backing indices of a data stream.
-
index.lifecycle.prefer_ilm -
(Dynamic, boolean)
This setting determines which feature is managing the backing index of a data stream if, and only if, the backing index
has an index lifecycle management (ILM) policy and the data stream has also a built-in lifecycle. When
truethis index is managed by ILM, whenfalsethe backing index is managed by the data stream lifecycle. Defaults totrue.
-
index.lifecycle.origination_date - (Dynamic, long) If specified, this is the timestamp used to calculate the backing index generation age after this backing index has been rolled over. The generation age is used to determine data retention, consequently, you can use this setting if you create a backing index that contains older data and want to ensure that the retention period or other parts of the lifecycle will be applied based on the data’s original timestamp and not the timestamp they got indexed. Specified as a Unix epoch value in milliseconds.