Skip to content

Commit d4fe9bc

Browse files
committed
Document index.dimensions-based routing
1 parent 9bbda53 commit d4fe9bc

File tree

1 file changed

+11
-1
lines changed

1 file changed

+11
-1
lines changed

manage-data/data-store/data-streams/time-bound-tsds.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,17 @@ These {{ilm-init}} actions mark the source index as read-only or prevent writes
5858

5959
### Dimension-based routing [dimension-based-routing]
6060

61-
In addition to time-based routing, time series data streams use dimension-based routing to determine which shard to route data to. Documents with the same dimensions are routed to the same shards.
61+
In addition to time-based routing, time series data streams use dimension-based routing to determine which shard to route data to. Documents with the same dimensions are routed to the same shards using one of two strategies:
62+
63+
1. Based on the internally managed `index.dimensions` index setting (preferred). Available as of stack version 9.2.
64+
2. Based on the [`index.routing_path`](elasticsearch://reference/elasticsearch/index-settings/time-series.md#index-routing-path) index setting (as a fallback).
65+
66+
The `index.dimensions`-based strategy offers a better ingest performance.
67+
It uses a list of dimension paths that's automatically kept up-to-date and is not user-configurable.
68+
This strategy is not available for time series data streams with dynamic templates that set `time_series_dimension: true`.
69+
70+
It can be disabled by setting [`index.index_dimensions_tsid_strategy_enabled`](elasticsearch://reference/elasticsearch/index-settings/time-series.md#index-dimensions-tsid-strategy-enabled) to `false`,
71+
or by manually setting `index.routing_path`.
6272

6373
The [`index.routing_path`](elasticsearch://reference/elasticsearch/index-settings/time-series.md#index-routing-path) setting specifies the dimension fields to use for routing, for example:
6474

0 commit comments

Comments
 (0)