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
[OnWeek] Fix Vale rule violations in manage-data (#3869)
This PR is part of the OnWeek project about fixing Vale rule violations
in docs-content.
It fixes warnings and suggestions in the top-level `manage-data` files
and the `manage-data/_snippets` subfolder.
Assisted by Cursor.
Copy file name to clipboardExpand all lines: manage-data/_snippets/ilm-status.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
To see the current status of the {{ilm-init}} service, use the [{{ilm-init}} status API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ilm-get-status):
1
+
To view the current status of the {{ilm-init}} service, use the [{{ilm-init}} status API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ilm-get-status):
Copy file name to clipboardExpand all lines: manage-data/_snippets/ilm-stop.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ By default, the {{ilm}} service is in the `RUNNING` state and manages all indice
3
3
You can stop {{ilm-init}} to suspend management operations for all indices. For example, you might stop {{ilm}} when performing scheduled maintenance or making changes to the cluster that could impact the execution of {{ilm-init}} actions.
4
4
5
5
::::{important}
6
-
When you stop {{ilm-init}}, [{{slm-init}}](/deploy-manage/tools/snapshot-and-restore/create-snapshots.md#automate-snapshots-slm) operations are also suspended. No snapshots will be taken as scheduled until you restart {{ilm-init}}. In-progress snapshots are not affected.
6
+
When you stop {{ilm-init}}, [{{slm-init}}](/deploy-manage/tools/snapshot-and-restore/create-snapshots.md#automate-snapshots-slm) operations are also suspended. {{slm-init}} will not take snapshots as scheduled until you restart {{ilm-init}}. In-progress snapshots are not affected.
7
7
::::
8
8
9
9
To stop the {{ilm-init}} service and pause execution of all lifecycle policies, use the [{{ilm-init}} stop API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ilm-stop):
@@ -12,7 +12,7 @@ To stop the {{ilm-init}} service and pause execution of all lifecycle policies,
12
12
POST _ilm/stop
13
13
```
14
14
15
-
The response will look like this:
15
+
The response looks like this:
16
16
17
17
```console-result
18
18
{
@@ -28,7 +28,7 @@ While the {{ilm-init}} service is shutting down, run the status API to verify th
Copy file name to clipboardExpand all lines: manage-data/data-store.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,6 +16,6 @@ The documentation in this section details how {{es}} works as a _data store_ sta
16
16
17
17
Then, learn how these documents and the fields they contain are stored and indexed in [Mapping](/manage-data/data-store/mapping.md), and how unstructured text is converted into a structured format that’s optimized for search in [Text analysis](/manage-data/data-store/text-analysis.md).
18
18
19
-
You can also read more about working with {{es}} as a data store including how to use [index templates](/manage-data/data-store/templates.md) to tell {{es}} how to configure an index when it is created, how to use [aliases](/manage-data/data-store/aliases.md) to point to multiple indices, and how to use the [command line to manage data](/manage-data/data-store/manage-data-from-the-command-line.md) stored in {{es}}.
19
+
You can also read more about working with {{es}} as a data store including how to use [index templates](/manage-data/data-store/templates.md) to tell {{es}} how to configure an index when you create it, how to use [aliases](/manage-data/data-store/aliases.md) to point to multiple indices, and how to use the [command line to manage data](/manage-data/data-store/manage-data-from-the-command-line.md) stored in {{es}}.
20
20
21
-
If your use case involves working with continuous streams of time series data, you may consider using a [data stream](./data-store/data-streams.md). These are optimally suited for storing append-only data. The data can be accessed through a single, named resource, while it is stored in a series of hidden, auto-generated backing indices.
21
+
If your use case involves working with continuous streams of time series data, you can consider using a [data stream](./data-store/data-streams.md). These are optimally suited for storing append-only data. You can access the data through a single, named resource, while {{es}} stores it in a series of hidden, auto-generated backing indices.
Copy file name to clipboardExpand all lines: manage-data/index.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,31 +9,31 @@ description: Learn how to ingest, store, and manage data in Elasticsearch. Under
9
9
10
10
# Manage data
11
11
12
-
Whether you're looking to build a fast and relevant search solution, monitor business-critical applications and infrastructure, monitor endpoint security data, or one of the [many other use cases Elastic supports](/get-started/introduction.md), you'll need to understand how to ingest and manage data stored in {{es}}.
12
+
Whether you're looking to build a fast and relevant search solution, monitor business-critical applications and infrastructure, monitor endpoint security data, or one of the [many other use cases Elastic supports](/get-started/introduction.md), you need to understand how to ingest and manage data stored in {{es}}.
13
13
14
14
## Learn how data is stored
15
15
16
16
% Topic: Learning about Elastic data store primitives
17
17
18
-
The fundamental unit of storage in {{es}}, the index, is a collection of documents uniquely identified by a name or an alias. These documents go through a process called mapping, which defines how a document and the fields it contains are stored and indexed, and a process called text analysis in which unstructured text is converted into a structured format that’s optimized for search.
18
+
The fundamental unit of storage in {{es}}, the index, is a collection of documents uniquely identified by a name or an alias. These documents go through a process called mapping, which defines how {{es}} stores and indexes a document and the fields it contains, and a process called text analysis in which {{es}} converts unstructured text into a structured format that's optimized for search.
19
19
20
20
**Learn more in [The Elasticsearch data store](/manage-data/data-store.md)**.
21
21
22
22
## Get data into {{es}}
23
23
24
24
% Topic: Evaluating and implementing ingestion and data enrichment technologies
25
25
26
-
Before you can start searching, visualizing, and pulling actionable insights from Elastic, you have to get your data into {{es}}. Elastic offers a wide range of tools and methods for getting data into {{es}}. The best approach will depend on the kind of data you're ingesting and your specific use case.
26
+
Before you can start searching, visualizing, and pulling actionable insights from Elastic, you have to get your data into {{es}}. Elastic offers a wide range of tools and methods for getting data into {{es}}. The best approach depends on the kind of data you're ingesting and your specific use case.
27
27
28
28
**Learn more in [Ingestion](/manage-data/ingest.md).**
29
29
30
30
## Manage data over time
31
31
32
32
% Topic: Managing your data volume (lifecycle)
33
33
34
-
After you've added data to {{es}}, you'll need to manage it over time. For example, you may specify that data be deleted after a retention period or store data in multiple tiers with different performance characteristics.
34
+
After you've added data to {{es}}, you need to manage it over time. For example, you can specify that data be deleted after a retention period or store data in multiple tiers with different performance characteristics.
35
35
36
-
Strategies for managing data depend on the type of data and how it's being used. For example, with a collection of items you want to search, like a catalog of products, the value of the content remains relatively constant over time so you want to be able to retrieve items quickly regardless of how old they are. Whereas with a stream of continuously-generated timestamped data, such as log entries, the data keeps accumulating over time, so you need strategies for balancing the value of the data against the cost of storing it.
36
+
Strategies for managing data depend on the type of data and how you're using it. For example, with a collection of items you want to search, like a catalog of products, the value of the content remains relatively constant over time so you want to be able to retrieve items quickly regardless of how old they are. Whereas with a stream of continuously-generated timestamped data, such as log entries, the data keeps accumulating over time, so you need strategies for balancing the value of the data against the cost of storing it.
37
37
38
38
**Learn more in [Data lifecycle](/manage-data/lifecycle.md).**
Copy file name to clipboardExpand all lines: manage-data/ingest.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,7 +19,7 @@ products:
19
19
20
20
Whether you call it *adding*, *indexing*, or *ingesting* data, you have to get the data into {{es}} before you can search it, visualize it, and use it for insights.
21
21
22
-
Our ingest tools are flexible, and support a wide range of scenarios. We can help you with everything from popular and straightforward use cases, all the way to advanced use cases that require additional processing in order to modify or reshape your data before it goes to {{es}}.
22
+
Our ingest tools are flexible, and support a wide range of scenarios. We can help you with everything from popular and straightforward use cases, all the way to advanced use cases that require additional processing to modify or reshape your data before it goes to {{es}}.
23
23
24
24
You can ingest:
25
25
@@ -42,10 +42,10 @@ If you would like to try things out before you add your own data, try using our
42
42
43
43
## Ingesting time series data [ingest-time-series]
44
44
45
-
::::{admonition} What’s the best approach for ingesting time series data?
45
+
::::{admonition} What's the best approach for ingesting time series data?
46
46
The best approach for ingesting data is the *simplest option* that *meets your needs* and *satisfies your use case*.
47
47
48
-
In most cases, the *simplest option* for ingesting time series data is using {{agent}} paired with an Elastic integration.
48
+
Usually, the *simplest option* for ingesting time series data is using {{agent}} paired with an Elastic integration.
49
49
50
50
* Install [Elastic Agent](/reference/fleet/index.md) on the computer(s) from which you want to collect data.
51
51
* Add the [Elastic integration](https://docs.elastic.co/en/integrations) for the data source to your deployment.
Copy file name to clipboardExpand all lines: manage-data/lifecycle.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ The data you store in {{es}} generally falls into one of two categories:
22
22
To help you manage your data, {{es}} offers you the following options: {{ilm-cap}}, Data stream lifecycle, and Elastic Curator.
23
23
24
24
::::{note}
25
-
[Data rollup](/manage-data/lifecycle/rollup.md) is a deprecated {{es}} feature that allows you to manage the amount of data that is stored in your cluster, similar to the downsampling functionality of{{ilm-init}} and data stream lifecycle. This feature should not be used for new deployments.
25
+
[Data rollup](/manage-data/lifecycle/rollup.md) is a deprecated {{es}} feature that allows you to manage the amount of data that your cluster stores, similar to the downsampling functionality of{{ilm-init}} and data stream lifecycle. Do not use this feature for new deployments.
26
26
::::
27
27
28
28
## {{ilm-init}} [ilm]
@@ -40,9 +40,9 @@ In an {{ecloud}} or self-managed environment, ILM lets you automatically transit
40
40
:::
41
41
::::
42
42
43
-
**{{ilm-init}}** can be used to manage both indices and data streams. It allows you to do the following:
43
+
**{{ilm-init}}** can manage both indices and data streams. It allows you to do the following:
44
44
45
-
* Define the retention period of your data. The retention period is the minimum time your data will be stored in {{es}}. Data older than this period can be deleted by {{es}}.
45
+
* Define the retention period of your data. The retention period is the minimum time {{es}} stores your data. {{es}} can delete data older than this period.
46
46
* Define [multiple tiers](/manage-data/lifecycle/data-tiers.md) of data nodes with different performance characteristics.
47
47
* Automatically transition indices through the data tiers according to your performance needs and retention policies.
48
48
* Leverage [searchable snapshots](/deploy-manage/tools/snapshot-and-restore/searchable-snapshots.md) stored in a remote repository to provide resiliency for your older indices while reducing operating costs and maintaining search performance.
@@ -52,10 +52,10 @@ In an {{ecloud}} or self-managed environment, ILM lets you automatically transit
52
52
53
53
## Data stream lifecycle [data-stream-lifecycle]
54
54
55
-
**Data stream lifecycle** is less feature rich but is focused on simplicity. It allows you to do the following:
55
+
**Data stream lifecycle** is less feature rich but focuses on simplicity. It allows you to do the following:
56
56
57
-
* Define the retention period of your data. The retention period is the minimum time your data will be stored in {{es}}. Data older than this period can be deleted by {{es}} at a later time.
58
-
* Improve the performance of your data stream by performing background operations that will optimize the way your data stream is stored.
57
+
* Define the retention period of your data. The retention period is the minimum time {{es}} stores your data. {{es}} can delete data older than this period at a later time.
58
+
* Improve the performance of your data stream by performing background operations that optimize how {{es}} stores your data stream.
59
59
60
60
**[Read more in Data stream lifecycle ->](/manage-data/lifecycle/data-stream.md)**
61
61
@@ -64,6 +64,6 @@ In an {{ecloud}} or self-managed environment, ILM lets you automatically transit
64
64
serverless: unavailable
65
65
```
66
66
67
-
**Elastic Curator** is a tool that allows you to manage your indices and snapshots using user-defined filters and predefined actions. If ILM provides the functionality to manage your index lifecycle, and you have at least a Basic license, consider using ILM in place of Curator. Many stack components make use of ILM by default.
67
+
**Elastic Curator** is a tool that allows you to manage your indices and snapshots using user-defined filters and predefined actions. If ILM provides the functionality to manage your index lifecycle, and you have at least a Basic license, consider using ILM in place of Curator. Many stack components use ILM by default.
68
68
69
69
**[Read more in Elastic Curator ->](/manage-data/lifecycle/curator.md)**
0 commit comments