Skip to content

Commit 21b47e5

Browse files
authored
Add minor clarification for data streams page (#2947)
I've slightly updated the intro sentence with a focus on the distinction/conceptual relationship between an index and a data stream. Also, mentioned that the ILM lifecycle for the data stream is defined in the index template. Fixes #1565
1 parent 75783a2 commit 21b47e5

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

manage-data/data-store/data-streams.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ products:
1313

1414
# Data streams [data-streams]
1515

16-
A data stream lets you store append-only time series data across multiple indices while giving you a single named resource for requests. Data streams are well-suited for logs, events, metrics, and other continuously generated data.
16+
A data stream acts as a layer of abstraction over a set of indices that are optimized for storing append-only time series data. It stores data across multiple backing indices while giving you a single named resource to use for requests. Data streams are well-suited for logs, events, metrics, and other continuously generated data.
1717

1818
You can submit indexing and search requests directly to a data stream. The stream automatically routes the request to backing indices that store the stream’s data. You can use [{{ilm}} ({{ilm-init}})](../lifecycle/index-lifecycle-management.md) to automate the management of these backing indices. For example, you can use {{ilm-init}} to automatically move older backing indices to less expensive hardware and delete unneeded indices. {{ilm-init}} can help you reduce costs and overhead as your data grows.
1919

@@ -39,7 +39,7 @@ A data stream consists of one or more [hidden](elasticsearch://reference/elastic
3939
:alt: data streams diagram
4040
:::
4141

42-
A data stream requires a matching [index template](templates.md). The template contains the mappings and settings used to configure the stream’s backing indices.
42+
A data stream requires a matching [index template](templates.md). The template contains the mappings and settings used to configure the stream’s backing indices and defines the {{ilm-init}} policy that the data stream uses.
4343

4444
Every document indexed to a data stream must contain a `@timestamp` field, mapped as a [`date`](elasticsearch://reference/elasticsearch/mapping-reference/date.md) or [`date_nanos`](elasticsearch://reference/elasticsearch/mapping-reference/date_nanos.md) field type. If the index template doesn’t specify a mapping for the `@timestamp` field, {{es}} maps `@timestamp` as a `date` field with default options.
4545

0 commit comments

Comments
 (0)