Skip to content

[DOCS] Update ESQL limitations to remove TSDB metrics #137390

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kkrik-es merged 7 commits into from
Oct 31, 2025
Merged

[DOCS] Update ESQL limitations to remove TSDB metrics #137390

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
b097823
Update ESQL limitations to remove TSDB metrics
kkrik-es Oct 30, 2025
be9947d
Revise TSDB metrics support in ESQL limitations
leemthompo Oct 30, 2025
079ba23
Update limitations.md
kkrik-es Oct 30, 2025
fcac25c
Update TSDB metrics preview version in limitations.md
kkrik-es Oct 30, 2025
bf4a5b7
Replace 'position' with 'gauge' in TSDB metrics
kkrik-es Oct 30, 2025
ee2fe4a
Update limitations.md with time series data streams info
kkrik-es Oct 30, 2025
aa709ac
Revise heading for time series data streams
kkrik-es Oct 30, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 22 additions & 8 deletions docs/reference/query-languages/esql/limitations.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,19 +46,28 @@ By default, an {{esql}} query returns up to 1,000 rows. You can increase the num
* `geo_shape`
* `point`
* `shape`
* TSDB metrics {preview}`9.2`
* `counter`
* `gauge`
* `aggregate_metric_double`



### Unsupported types [_unsupported_types]

{{esql}} does not yet support the following field types:

::::{tab-set}
:::{tab-item} 9.0-9.1
* TSDB metrics

* `counter`
* `position`
* `aggregate_metric_double`

* `counter`
* `gauge`
* `aggregate_metric_double`
:::
:::{tab-item} 9.2+
This limitation no longer exists and TSDB metrics are now supported (preview).
:::
::::
* Date/time

* `date_range`
Expand Down Expand Up @@ -188,11 +197,16 @@ As discussed in more detail in [Using {{esql}} to query multiple indices](/refer
* All underlying indexes and shards must be active. Using admin commands or UI, it is possible to pause an index or shard, for example by disabling a frozen tier instance, but then any {{esql}} query that includes that index or shard will fail, even if the query uses [`WHERE`](/reference/query-languages/esql/commands/where.md) to filter out the results from the paused index. If you see an error of type `search_phase_execution_exception`, with the message `Search rejected due to missing shards`, you likely have an index or shard in `UNASSIGNED` state.
* The same field must have the same type across all indexes. If the same field is mapped to different types it is still possible to query the indexes, but the field must be [explicitly converted to a single type](/reference/query-languages/esql/esql-multi-index.md#esql-multi-index-union-types).

## Time series data streams [esql-tsdb]

## Time series data streams are not supported [esql-tsdb]

::::{tab-set}
:::{tab-item} 9.0-9.1
{{esql}} does not support querying time series data streams (TSDS).

:::
:::{tab-item} 9.2+
This limitation no longer exists and time series data streams (TSDS) are now supported (preview).
:::
::::

## Date math limitations [esql-limitations-date-math]

Expand Down