@@ -33,6 +33,7 @@ according to your performance, resiliency and data retention requirements.
3333[[content-tier]]
3434=== Content tier
3535
36+ // tag::content-tier[]
3637Data stored in the content tier is generally a collection of items such as a product catalog or article archive.
3738Unlike time series data, the value of the content remains relatively constant over time,
3839so it doesn't make sense to move it to a tier with different performance characteristics as it ages.
@@ -47,11 +48,13 @@ tier should be configured to use one or more replicas.
4748
4849The content tier is required. System indices and other indices that aren't part
4950of a data stream are automatically allocated to the content tier.
51+ // end::content-tier[]
5052
5153[discrete]
5254[[hot-tier]]
5355=== Hot tier
5456
57+ // tag::hot-tier[]
5558The hot tier is the {es} entry point for time series data and holds your most-recent,
5659most-frequently-searched time series data.
5760Nodes in the hot tier need to be fast for both reads and writes,
@@ -60,22 +63,26 @@ For resiliency, indices in the hot tier should be configured to use one or more
6063
6164The hot tier is required. New indices that are part of a <<data-streams,
6265data stream>> are automatically allocated to the hot tier.
66+ // end::hot-tier[]
6367
6468[discrete]
6569[[warm-tier]]
6670=== Warm tier
6771
72+ // tag::warm-tier[]
6873Time series data can move to the warm tier once it is being queried less frequently
6974than the recently-indexed data in the hot tier.
7075The warm tier typically holds data from recent weeks.
7176Updates are still allowed, but likely infrequent.
7277Nodes in the warm tier generally don't need to be as fast as those in the hot tier.
7378For resiliency, indices in the warm tier should be configured to use one or more replicas.
79+ // end::warm-tier[]
7480
7581[discrete]
7682[[cold-tier]]
7783=== Cold tier
7884
85+ // tag::cold-tier[]
7986When you no longer need to search time series data regularly, it can move from
8087the warm tier to the cold tier. While still searchable, this tier is typically
8188optimized for lower storage costs rather than search speed.
@@ -91,11 +98,13 @@ Fully mounted indices are read-only.
9198Alternatively, you can use the cold tier to store regular indices with replicas instead
9299of using {search-snaps}. This lets you store older data on less expensive hardware
93100but doesn't reduce required disk space compared to the warm tier.
101+ // end::cold-tier[]
94102
95103[discrete]
96104[[frozen-tier]]
97105=== Frozen tier
98106
107+ // tag::frozen-tier[]
99108Once data is no longer being queried, or being queried rarely, it may move from
100109the cold tier to the frozen tier where it stays for the rest of its life.
101110
@@ -105,6 +114,7 @@ and load data from a snapshot repository. This reduces local storage and
105114operating costs while still letting you search frozen data. Because {es} must
106115sometimes fetch frozen data from the snapshot repository, searches on the frozen
107116tier are typically slower than on the cold tier.
117+ // end::frozen-tier[]
108118
109119[discrete]
110120[[configure-data-tiers-cloud]]
0 commit comments