You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: manage-data/lifecycle/data-stream/tutorial-update-existing-data-stream.md
+72-7Lines changed: 72 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,15 +10,37 @@ products:
10
10
11
11
# Tutorial: Update existing data stream [tutorial-manage-existing-data-stream]
12
12
13
-
To update the lifecycle of an existing data stream you do the following actions:
13
+
To update the lifecycle of an existing data stream you need to perform the following actions:
14
14
15
15
1.[Set a data stream’s lifecycle](#set-lifecycle)
16
16
2.[Remove lifecycle for a data stream](#delete-lifecycle)
17
17
18
18
19
19
## Set a data stream’s lifecycle [set-lifecycle]
20
20
21
-
To add or to change the retention period of your data stream you can use the [PUT lifecycle API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-data-lifecycle).
21
+
To add or to change the retention period of your data stream you can use **Index Management** in {{kib}} or the {{es}} [PUT lifecycle API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-data-lifecycle).
22
+
23
+
24
+
:::::{tab-set}
25
+
:group: kibana-api
26
+
:::{tab-item} {{kib}}
27
+
:sync: kibana
28
+
29
+
To change the data retention settings for a data stream:
30
+
31
+
1. Go to **Stack Management > Index Management** and open the **Data Streams** tab.
32
+
1. Use the search tool to find the data stream you're looking for.
33
+
1. Select the data stream to view details.
34
+
1. In the data stream details pane, select **Manage > Edit data retention** to adjust the settings. You can do any of the following:
35
+
. Select the duration that your data should be retained, in days, hours, minutes, or seconds.
36
+
. Choose to **Keep data indefinitely**, so that your data will not be deleted.
37
+
. Disable **Enable data retention** to turn off data stream lifecycle management for your data stream.
38
+
:::
39
+
40
+
:::{tab-item} API
41
+
:sync: api
42
+
43
+
To change the data retention settings for a data stream:
22
44
23
45
* You can set infinite retention period, meaning that your data should never be deleted. For example:
24
46
@@ -39,9 +61,31 @@ To add or to change the retention period of your data stream you can use the [PU
39
61
```
40
62
41
63
1. The retention period of this data stream is set to 30 days. This means that {{es}} is allowed to delete data that is older than 30 days at its own discretion.
64
+
:::
65
+
:::::
66
+
67
+
The changes in the lifecycle are applied on all backing indices of the data stream.
68
+
69
+
You can see the effect of the change in {{kib}} or using the {{es}} [explain API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-explain-data-lifecycle):
70
+
71
+
:::::{tab-set}
72
+
:group: kibana-api
73
+
:::{tab-item} {{kib}}
74
+
:sync: kibana
75
+
To check the data retention settings for a data stream:
76
+
77
+
1. Go to **Stack Management > Index Management** and open the **Data Streams** tab.
78
+
1. Use the search tool to find the data stream you're looking for.
79
+
1. Select the data stream to view details. The flyout shows the data retention settings for the data stream. Note that if the data stream is currently managed by an [{{ilm-init}} policy](/manage-data/lifecycle/index-lifecycle-management.md), the **Effective data retention** may differ from the retention value that you've set in the data stream, as indicated by the **Data retention**.
42
80
81
+

43
82
44
-
The changes in the lifecycle are applied on all backing indices of the data stream. You can see the effect of the change via the [explain API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-explain-data-lifecycle):
83
+
:::
84
+
85
+
:::{tab-item} API
86
+
:sync: api
87
+
88
+
To check the data retention settings for a data stream:
45
89
46
90
```console
47
91
GET .ds-my-data-stream-*/_lifecycle/explain
@@ -90,16 +134,37 @@ The response will look like:
90
134
9. The time that will be used to determine when it’s safe to delete this index and all its data.
91
135
10. The data retention for this index as well is at least 30 days, as it was recently updated.
92
136
93
-
137
+
:::
138
+
:::::
94
139
95
140
## Remove lifecycle for a data stream [delete-lifecycle]
96
141
97
-
To remove the lifecycle of a data stream you can use the [delete lifecycle API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-delete-data-lifecycle). As consequence, the maintenance operations that were applied by the lifecycle will no longer be applied to the data stream and all its backing indices. For example:
142
+
To remove the lifecycle of a data stream you can use in {{kib}} or the {{es}} [delete lifecycle API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-delete-data-lifecycle).
143
+
144
+
145
+
:::::{tab-set}
146
+
:group: kibana-api
147
+
:::{tab-item} {{kib}}
148
+
:sync: kibana
149
+
1. Go to **Stack Management > Index Management** and open the **Data Streams** tab.
150
+
1. Use the search tool to find the data stream you're looking for.
151
+
1. Select the data stream to view details.
152
+
1. In the data stream details pane, select **Manage > Edit data retention**.
153
+
1. Turn off the **Enable data retention** option and save your changes. The maintenance operations that were applied by the lifecycle will no longer be applied to the data stream and all of its backing indices.
154
+
You can confirm your changes by reopening the data stream pane. The **Effective data retention** will show a **Disabled** status.
98
155
156
+

157
+
158
+
:::
159
+
160
+
:::{tab-item} API
161
+
:sync: api
99
162
```console
100
163
DELETE _data_stream/my-data-stream/_lifecycle
101
164
```
102
165
166
+
After running the API request, the maintenance operations that were applied by the lifecycle will no longer be applied to the data stream and all of its backing indices.
167
+
103
168
You can then use the [explain API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-explain-data-lifecycle) again to see that the indices are no longer managed.
104
169
105
170
```console
@@ -125,5 +190,5 @@ GET .ds-my-data-stream-*/_lifecycle/explain
125
190
2. Indication that the index is not managed by the data stream lifecycle.
126
191
3. The name of another backing index.
127
192
4. Indication that the index is not managed by the data stream lifecycle.
0 commit comments