Skip to content

Commit c0ccae9

Browse files
romseygeekleemthompowajihaparvez
authored
Mention use of docvalue skippers in TSDS documentation (#4412)
## Summary Update TSDS docs to mention the use of doc values skippers, and cross-link to the internal ES docs. ## Generative AI disclosure 1. Did you use a generative AI (GenAI) tool to assist in creating this contribution? - [ ] Yes - [x] No --------- Co-authored-by: Liam Thompson <[email protected]> Co-authored-by: wajihaparvez <[email protected]>
1 parent 2dadeda commit c0ccae9

File tree

1 file changed

+2
-1
lines changed

1 file changed

+2
-1
lines changed

manage-data/data-store/data-streams/time-series-data-stream-tsds.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -100,6 +100,7 @@ A time series data stream works like a regular data stream, with some key differ
100100
* **Dimension-based routing:** The routing logic uses dimension fields to map all data points of a time series to the same shard, improving storage efficiency and query performance. Duplicate data points are rejected.
101101
* **Sorting:** A TSDS uses internal [index sorting](elasticsearch://reference/elasticsearch/index-settings/sorting.md) to order shard segments by `_tsid` and `@timestamp`, for better compression. Time series data streams do not use `index.sort.*` settings.
102102
* **Source field:** A TSDS uses [synthetic `_source`](elasticsearch://reference/elasticsearch/mapping-reference/mapping-source-field.md#synthetic-source), and as a result is subject to some [restrictions](elasticsearch://reference/elasticsearch/mapping-reference/mapping-source-field.md#synthetic-source-restrictions) and [modifications](elasticsearch://reference/elasticsearch/mapping-reference/mapping-source-field.md#synthetic-source-modifications) applied to the `_source` field.
103+
* {applies_to}`stack: ga 9.3` **Doc value Skippers:** A TSDS enables [docvalue skippers](elasticsearch://reference/elasticsearch/mapping-reference/doc-values.md#doc-values-skippers) on its `_tsid`, `@timestamp`, [dimension](#time-series-dimension), and [metric](#time-series-metric) fields. Because `tsid` and `@timestamp` are part of the index sort, the skippers allow {{es}} to avoid building backing indexes for these fields, meaning lower disk usage and faster ingest speed.
103104

104105
## Query time series data
105106
```{applies_to}
@@ -114,4 +115,4 @@ You can use the {{esql}} [`TS` command](elasticsearch://reference/query-language
114115
* Try the [quickstart](/manage-data/data-store/data-streams/quickstart-tsds.md) for a hands-on introduction
115116
* [Set up a time series data stream](/manage-data/data-store/data-streams/set-up-tsds.md)
116117
* [Ingest data using the OpenTelemetry Protocol (OTLP)](/manage-data/data-store/data-streams/tsds-ingest-otlp.md)
117-
* Learn about [downsampling](/manage-data/data-store/data-streams/downsampling-time-series-data-stream.md) to reduce storage footprint
118+
* Learn about [downsampling](/manage-data/data-store/data-streams/downsampling-time-series-data-stream.md) to reduce storage footprint

0 commit comments

Comments
 (0)