Skip to content

Commit d81a06a

Browse files
committed
Making some final revisions
1 parent 7722d3c commit d81a06a

File tree

9 files changed

+25
-30
lines changed

9 files changed

+25
-30
lines changed

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

Lines changed: 3 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -19,19 +19,13 @@ You can submit indexing and search requests directly to a data stream. The strea
1919

2020
You can also use a [data stream lifecycle](../lifecycle/data-stream.md) to automate lifecycle management according to your retention requirements.
2121

22-
:::{admonition} Streams
22+
:::{admonition} Managing data streams with Streams
2323
:applies_to: {"stack": "ga 9.2, preview 9.1", "serverless": "ga"}
2424

25-
Starting with {{stack}} version 9.2, **Streams** provides a centralized interface for managing your data in {{kib}}. It consolidates common data management tasks and eliminates the need for manual configuration of multiple applications and components. A stream directly corresponds to an {{es}} data stream, for example `logs-myapp-default`. Any changes that you make in Streams are automatically propagated to the associated data stream.
25+
Starting with {{stack}} version 9.2, [Streams](/solutions/observability/streams/streams.md) provides a centralized interface for managing your data in {{kib}}. It consolidates common data management tasks and eliminates the need for manual configuration of multiple applications and components. A stream maps directly to an {{es}} data stream, for example `logs-myapp-default`. Any changes that you make in Streams are automatically propagated to the associated data stream.
2626

27-
You can use Streams to perform the following data management tasks:
28-
* defining parsing and field extraction logic to structure incoming data {applies_to}`"stack": "ga 9.2, preview 9.1"`
29-
* configuring data retention policies {applies_to}`"stack": "ga 9.2, preview 9.1"`
30-
* manually adjusting index settings {applies_to}`"stack": "ga 9.2, preview 9.1"`
31-
* managing and updating field mappings {applies_to}`stack: ga 9.2`
32-
* identifying failed and degraded documents {applies_to}`stack: ga 9.2`
27+
For more information, refer to [Manage data streams with Streams](/manage-data/data-store/data-streams/manage-data-stream.md#manage-data-streams-with-streams).
3328

34-
For more information, refer to [Streams](/solutions/observability/streams/streams.md).
3529
:::
3630

3731
## Should you use a data stream? [should-you-use-a-data-stream]

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ PUT _data_stream/my-datastream-existing/_options
9393
:::{tip}
9494
:applies_to: {"stack": "ga 9.2, preview 9.1", "serverless": "ga"}
9595

96-
You can also enable the data stream failure store in {{kib}}. Locate the data stream on the **Streams** page, where a stream directly corresponds to a data stream. Select a stream to view its details and go to the **Retention** tab where you can find the **Enable failure store** button.
96+
You can also enable the data stream failure store in {{kib}}. Locate the data stream on the **Streams** page, where a stream maps directly to a data stream. Select a stream to view its details and go to the **Retention** tab where you can find the **Enable failure store** option.
9797
:::
9898

9999
### Enable failure store via cluster setting [set-up-failure-store-cluster-setting]

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

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -23,12 +23,12 @@ In {{es-serverless}}, indices matching the `logs-*-*` pattern use the logsDB ind
2323
* To view information about the stream’s backing indices, click the number in the **Indices** column.
2424
* To modify the data retention value, select a data stream, open the **Manage** menu, and click **Edit data retention**.
2525

26-
## Manage data streams in Streams
26+
## Manage data streams with Streams [manage-data-streams-with-streams]
2727
```{applies_to}
2828
serverless: ga
2929
stack: preview 9.1, ga 9.2
3030
```
31-
Starting with {{stack}} version 9.2, [**Streams**](/solutions/observability/streams/streams.md) provides a centralized interface for managing your data in {{kib}}. It consolidates common data management tasks and eliminates the need for manual configuration of multiple applications and components. A stream directly corresponds to an {{es}} data stream, for example `logs-myapp-default`. Any changes that you make in Streams are automatically propagated to the associated data stream.
31+
Starting with {{stack}} version 9.2, [Streams](/solutions/observability/streams/streams.md) provides a centralized interface for managing your data in {{kib}}. It consolidates common data management tasks and eliminates the need for manual configuration of multiple applications and components. A stream maps directly to an {{es}} data stream, for example `logs-myapp-default`. Any changes that you make in Streams are automatically propagated to the associated data stream.
3232

3333
:::{image} /manage-data/images/data-stream-management-streams.png
3434
:alt: Streams details
@@ -37,8 +37,9 @@ Starting with {{stack}} version 9.2, [**Streams**](/solutions/observability/stre
3737

3838

3939
You can perform the following data management tasks in Streams:
40-
* [define parsing and field extraction logic](ADD LINK to /solutions/observability/streams/management/extract.md) to structure incoming data {applies_to}`"stack": "ga 9.2, preview 9.1"`
41-
* [configure data retention policies](ADD LINK to /solutions/observability/streams/management/retention.md) {applies_to}`"stack": "ga 9.2, preview 9.1"`
42-
* [manually adjust index settings](ADD LINK to/solutions/observability/streams/management/advanced.md) {applies_to}`"stack": "ga 9.2, preview 9.1"`
43-
* [manage and update field mappings](ADD LINK to/solutions/observability/streams/management/schema.md) {applies_to}`stack: ga 9.2`
44-
* [identify failed and degraded documents](ADD LINK to/solutions/observability/streams/management/data-quality.md) {applies_to}`stack: ga 9.2`
40+
* [define parsing and field extraction logic](ADD LINK to /solutions/observability/streams/management/extract.md) to process and structure incoming data
41+
* [configure data retention policies](ADD LINK to /solutions/observability/streams/management/retention.md)
42+
* [manually adjust index settings](ADD LINK to /solutions/observability/streams/management/advanced.md)
43+
* [manage and update field mappings](ADD LINK to /solutions/observability/streams/management/schema.md) {applies_to}`stack: unavailable 9.1`
44+
* [identify failed and degraded documents](ADD LINK to /solutions/observability/streams/management/data-quality.md) {applies_to}`stack: unavailable 9.1`
45+
* [partition data into child streams](ADD LINK to /solutions/observability/streams/management/partitioning.md) {applies_to}`stack: preview 9.2` {applies_to}`serverless: preview`

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -234,7 +234,7 @@ To change the `index.lifecycle.name` setting, first use the [remove policy API](
234234

235235
You can also update certain dynamic index settings for a data stream in {{kib}}, such as the number of shards, replicas, and the refresh interval used.
236236

237-
Locate the data stream on the **Streams** page, where a stream directly corresponds to a data stream. Select the stream to view its details and go to the **Advanced** tab to make your adjustments. For more information, refer to [ADD LINK to /solutions/observability/streams/management/advanced.md#index-configuration when it's merged].
237+
Locate the data stream on the **Streams** page, where a stream maps directly to a data stream. Select the stream to view its details and go to the **Advanced** tab to make your adjustments. For more information, refer to [ADD LINK to /solutions/observability/streams/management/advanced.md#index-configuration when it's merged].
238238
:::
239239

240240
### Change a static index setting for a data stream [change-static-index-setting-for-a-data-stream]

manage-data/data-store/index-basics.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -156,8 +156,7 @@ In {{es-serverless}}, indices matching the `logs-*-*` pattern use the logsDB ind
156156
:::{admonition} Streams
157157
:applies_to: {"stack": "ga 9.2, preview 9.1", "serverless": "ga"}
158158

159-
Starting with {{stack}} version 9.2, **Streams** provides a centralized interface for common data management tasks in {{kib}}, including tasks such as [modifying data retention](/manage-data/lifecycle/data-stream/tutorial-update-existing-data-stream.md#data-retention-streams) values.
160-
For more information, refer to [Streams](/solutions/observability/streams/streams.md).
159+
Starting with {{stack}} version 9.2, [Streams](/solutions/observability/streams/streams.md) provides a centralized interface for common data management tasks in {{kib}}, including tasks such as [modifying data retention](/manage-data/lifecycle/data-stream/tutorial-update-existing-data-stream.md#data-retention-streams) values.
161160
:::
162161

163162
### Manage index templates [index-management-manage-index-templates]

manage-data/lifecycle/data-stream/tutorial-data-stream-retention.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,7 @@ Global default and max retention do not apply to data streams internal to elasti
107107
:::{tip}
108108
:applies_to: {"stack": "ga 9.2, preview 9.1", "serverless": "ga"}
109109

110-
To adjust the retention period of a data stream in {{kib}}, locate a data stream on the **Streams** page. A stream directly corresponds to a data stream. Next, select a stream to view its details and review the **Retention** tab to find out how it's managed before making your adjustments.
110+
To adjust the retention period of a data stream in {{kib}}, locate a data stream on the **Streams** page. A stream maps directly to a data stream. Next, select a stream to view its details and review the **Retention** tab to find out how it's managed before making your adjustments.
111111
:::
112112

113113
* By setting the global retention via the `data_streams.lifecycle.retention.default` and/or `data_streams.lifecycle.retention.max` that are set on a cluster level. You can set this via the [update cluster settings API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-put-settings). For example:

manage-data/lifecycle/data-stream/tutorial-migrate-ilm-managed-data-stream-to-data-stream-lifecycle.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ products:
1313
In this tutorial we’ll look at migrating an existing data stream from [Index Lifecycle Management ({{ilm-init}})](../index-lifecycle-management.md) to [data stream lifecycle](../data-stream.md). The existing {{ilm-init}} managed backing indices will continue to be managed by {{ilm-init}} until they age out and get deleted by {{ilm-init}}; however, the new backing indices will be managed by data stream lifecycle. This way, a data stream is gradually migrated away from being managed by {{ilm-init}} to being managed by data stream lifecycle. As we’ll see, {{ilm-init}} and data stream lifecycle can co-manage a data stream; however, an index can only be managed by one system at a time.
1414

1515

16-
:::{admonition} Configure data retention policies in Streams
16+
:::{admonition} Configure data retention policies for Streams
1717
:applies_to: {"stack": "ga 9.2, preview 9.1", "serverless": "ga"}
1818

1919
Starting with {{stack}} version 9.2, [Streams](/solutions/observability/streams/streams.md) provides a centralized interface for common data management tasks in {{kib}}, including tasks such as configuring data retention policies. You can choose to retain your data indefinitely, for a custom period, or by following an existing ILM policy. For more information, refer to [Manage data retention in Streams](/manage-data/lifecycle/data-stream/tutorial-update-existing-data-stream.md#data-retention-streams).

manage-data/lifecycle/data-stream/tutorial-update-existing-data-stream.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Follow these steps to configure or remove data stream lifecycle settings for an
1414

1515
- [Set a data stream’s lifecycle](#set-lifecycle)
1616
- [Remove the lifecycle for a data stream](#delete-lifecycle)
17-
- [Manage data retention in Streams](#data-retention-streams)
17+
- [Manage data retention for Streams](#data-retention-streams)
1818

1919
Note that these steps are for data stream lifecycle only. For the steps to configure {{ilm}}, refer to the [{{ilm-init}} documentation](/manage-data/lifecycle/index-lifecycle-management.md). For a comparison between the two, refer to [](/manage-data/lifecycle.md).
2020

@@ -215,17 +215,18 @@ GET .ds-my-data-stream-*/_lifecycle/explain
215215
:::
216216
:::::
217217

218-
## Manage data retention in Streams [data-retention-streams]
218+
## Manage data retention for Streams [data-retention-streams]
219219
```{applies_to}
220220
serverless: ga
221221
stack: preview 9.1, ga 9.2
222222
```
223223

224-
Starting with {{stack}} version 9.2, **Streams** provides a centralized interface for common data management tasks in {{kib}}.
224+
Starting with {{stack}} version 9.2, **Streams** provides a centralized interface for common data management tasks in {{kib}}, including getting insight into how your data streams retain data.
225225

226226
1. Go to the **Streams** page using the navigation menu or the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md).
227-
1. A stream directly corresponds to an {{es}} data stream. Select a stream to view its details.
227+
1. Each stream maps directly to an {{es}} data stream. Select a stream to view its details.
228228
1. Go to the **Retention** tab to set how long your stream retains data and to get insight into your stream's data ingestion and storage size.
229-
1. Select **Edit data retention** and choose to retain your data indefinitely, for a custom period, or by following an existing ILM policy.
229+
1. Select **Edit data retention** and choose to retain your data indefinitely, for a custom period, or by following an existing ILM policy. You can also use the data retention configuration that's set in the index template by enabling the **Inherit from index template** option. If you use this option, you don't need to specify a custom retention period or policy.
230+
231+
For more information about the retention configuration options, refer to [](ADD LINK to /solutions/observability/streams/management/retention.md).
230232

231-
Any changes you make in Streams are automatically propagated to the associated data stream.

manage-data/lifecycle/index-lifecycle-management/policy-view-status.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,8 +54,8 @@ To learn how to create a specialized ILM policy for any data stream, such as tho
5454
Starting with {{stack}} version 9.2, [Streams](/solutions/observability/streams/streams.md) provides a centralized interface for common data management tasks in {{kib}}.
5555

5656
1. Go to the **Streams** page using the navigation menu or the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md).
57-
1. A stream directly corresponds to an {{es}} data stream. Select a stream to view its details.
58-
1. Go to the **Retention** tab to see how long your stream retains data and to get insight into your stream's data ingestion and storage size. A stream can retain the data indefinitely, for a custom period, or by following an existing ILM policy.
57+
1. A stream maps directly to an {{es}} data stream. Select a stream to view its details.
58+
1. Go to the **Retention** tab to see how long your stream retains data and to get insight into your stream's data ingestion and storage size. A stream can retain the data indefinitely, for a custom period, or by following an existing ILM policy. For more information, refer to [](ADD LINK to /solutions/observability/streams/management/retention.md).
5959

6060
::::
6161

0 commit comments

Comments
 (0)