From 5aab82a390845bfb030400e9f0303f1feacd04b9 Mon Sep 17 00:00:00 2001 From: Liam Thompson Date: Mon, 25 Aug 2025 21:08:26 +0200 Subject: [PATCH 1/2] update doc links --- .../configuration-reference/thread-pool-settings.md | 2 +- docs/reference/elasticsearch/index.md | 2 +- .../esql/_snippets/commands/layout/enrich.md | 2 +- .../query-languages/esql/_snippets/commands/layout/from.md | 4 ++-- docs/reference/query-languages/esql/esql-getting-started.md | 2 +- docs/reference/query-languages/esql/esql-rest.md | 2 +- docs/reference/query-languages/esql/esql-search-tutorial.md | 2 +- docs/reference/query-languages/esql/esql-syntax.md | 2 +- .../esql/functions-operators/search-functions.md | 2 +- docs/reference/query-languages/esql/limitations.md | 6 +++--- 10 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/reference/elasticsearch/configuration-reference/thread-pool-settings.md b/docs/reference/elasticsearch/configuration-reference/thread-pool-settings.md index 61569a818954c..fed63c27bd1b9 100644 --- a/docs/reference/elasticsearch/configuration-reference/thread-pool-settings.md +++ b/docs/reference/elasticsearch/configuration-reference/thread-pool-settings.md @@ -92,7 +92,7 @@ $$$search-throttled$$$`search_throttled` : For [watch executions](docs-content://explore-analyze/alerts-cases/watcher.md). Thread pool type is `fixed` with a default maximum size of `min(5 * (`[`# of allocated processors`](#node.processors)`), 50)` and queue_size of `1000`. $$$modules-threadpool-esql$$$`esql_worker` -: Executes [{{esql}}](docs-content://explore-analyze/query-filter/languages/esql.md) operations. Thread pool type is `fixed` with a size of `int((`[`# of allocated processors`](#node.processors) ` * 3) / 2) + 1`, and queue_size of `1000`. +: Executes [{{esql}}](elasticsearch://reference/query-languages/esql.md) operations. Thread pool type is `fixed` with a size of `int((`[`# of allocated processors`](#node.processors) ` * 3) / 2) + 1`, and queue_size of `1000`. Thread pool settings are [Static](docs-content://deploy-manage/stack-settings.md#static-cluster-setting) and can be changed by editing `elasticsearch.yml`. Changing a specific thread pool can be done by setting its type-specific parameters; for example, changing the number of threads in the `write` thread pool: diff --git a/docs/reference/elasticsearch/index.md b/docs/reference/elasticsearch/index.md index 2d10104429185..d74f47b2e3e76 100644 --- a/docs/reference/elasticsearch/index.md +++ b/docs/reference/elasticsearch/index.md @@ -46,7 +46,7 @@ - [Learn how to search your data](docs-content://solutions/search/querying-for-search.md) - Query data programmatically: use query languages to run advanced search, filtering, or analytics - [Query DSL](docs-content://explore-analyze/query-filter/languages/querydsl.md): full JSON-based query language - - [ES|QL](docs-content://explore-analyze/query-filter/languages/esql.md): fast, SQL-like language with piped syntax + - [ES|QL](elasticsearch://reference/query-languages/esql.md): fast, SQL-like language with piped syntax - [EQL](docs-content://explore-analyze/query-filter/languages/eql.md): for event-based time series data, such as logs, metrics, and traces - [SQL](docs-content://explore-analyze/query-filter/languages/sql.md): SQL-style queries on Elasticsearch data - [Search applications](docs-content://solutions/search/search-applications.md) diff --git a/docs/reference/query-languages/esql/_snippets/commands/layout/enrich.md b/docs/reference/query-languages/esql/_snippets/commands/layout/enrich.md index 5747f7994b072..22bf1bab20710 100644 --- a/docs/reference/query-languages/esql/_snippets/commands/layout/enrich.md +++ b/docs/reference/query-languages/esql/_snippets/commands/layout/enrich.md @@ -22,7 +22,7 @@ ENRICH policy [ON match_field] [WITH [new_name1 = ]field1, [new_name2 = ]field2, `mode` : The mode of the enrich command in cross cluster {{esql}}. - See [enrich across clusters](docs-content://explore-analyze/query-filter/languages/esql-cross-clusters.md#ccq-enrich). + See [enrich across clusters](elasticsearch://reference/query-languages/esql/esql-cross-clusters.md#ccq-enrich). `match_field` : The match field. `ENRICH` uses its value to look for records in the enrich diff --git a/docs/reference/query-languages/esql/_snippets/commands/layout/from.md b/docs/reference/query-languages/esql/_snippets/commands/layout/from.md index a8ff5b6b716be..793eb92a42b0c 100644 --- a/docs/reference/query-languages/esql/_snippets/commands/layout/from.md +++ b/docs/reference/query-languages/esql/_snippets/commands/layout/from.md @@ -59,14 +59,14 @@ FROM ``` Use comma-separated lists or wildcards to -[query multiple data streams, indices, or aliases](docs-content://explore-analyze/query-filter/languages/esql-multi-index.md): +[query multiple data streams, indices, or aliases](elasticsearch://reference/query-languages/esql/esql-multi-index.md): ```esql FROM employees-00001,other-employees-* ``` Use the format `:` to -[query data streams and indices on remote clusters](docs-content://explore-analyze/query-filter/languages/esql-cross-clusters.md): +[query data streams and indices on remote clusters](elasticsearch://reference/query-languages/esql/esql-cross-clusters.md): ```esql FROM cluster_one:employees-00001,cluster_two:other-employees-* diff --git a/docs/reference/query-languages/esql/esql-getting-started.md b/docs/reference/query-languages/esql/esql-getting-started.md index 22bd898b51245..8215568f19586 100644 --- a/docs/reference/query-languages/esql/esql-getting-started.md +++ b/docs/reference/query-languages/esql/esql-getting-started.md @@ -420,5 +420,5 @@ For more about data processing with {{esql}}, refer to [Data processing with DIS - Explore the zero-setup, live [{{esql}} demo environment](http://esql.demo.elastic.co/). - - Follow along with our hands-on tutorials: - - [Search and filter with {{esql}}](docs-content://solutions/search/esql-search-tutorial.md): A hands-on tutorial that shows you how to use {{esql}} to search and filter data. + - [Search and filter with {{esql}}](elasticsearch://reference/query-languages/esql/esql-search-tutorial.md): A hands-on tutorial that shows you how to use {{esql}} to search and filter data. - [Threat hunting with {{esql}}](docs-content://solutions/security/esql-for-security/esql-threat-hunting-tutorial.md): A hands-on tutorial that shows you how to use {{esql}} for advanced threat hunting techniques and security analysis. \ No newline at end of file diff --git a/docs/reference/query-languages/esql/esql-rest.md b/docs/reference/query-languages/esql/esql-rest.md index 85cffa101986c..54405980499fd 100644 --- a/docs/reference/query-languages/esql/esql-rest.md +++ b/docs/reference/query-languages/esql/esql-rest.md @@ -12,7 +12,7 @@ products: # Use the {{esql}} REST API [esql-rest] ::::{tip} -The [Search and filter with {{esql}}](docs-content://solutions/search/esql-search-tutorial.md) tutorial provides a hands-on introduction to the {{esql}} `_query` API. +The [Search and filter with {{esql}}](elasticsearch://reference/query-languages/esql/esql-search-tutorial.md) tutorial provides a hands-on introduction to the {{esql}} `_query` API. :::: ## Overview [esql-rest-overview] diff --git a/docs/reference/query-languages/esql/esql-search-tutorial.md b/docs/reference/query-languages/esql/esql-search-tutorial.md index 1386e09d4ca81..8b8fbf1a736f6 100644 --- a/docs/reference/query-languages/esql/esql-search-tutorial.md +++ b/docs/reference/query-languages/esql/esql-search-tutorial.md @@ -31,7 +31,7 @@ FROM cooking_blog | LIMIT 1000 ``` -If you want to run these queries in the [Dev Tools Console](docs-content://explore-analyze/query-filter/languages/esql-rest.md#esql-kibana-console), you need to use the following syntax: +If you want to run these queries in the [Dev Tools Console](elasticsearch://reference/query-languages/esql/esql-rest.md#esql-kibana-console), you need to use the following syntax: ```console POST /_query?format=txt diff --git a/docs/reference/query-languages/esql/esql-syntax.md b/docs/reference/query-languages/esql/esql-syntax.md index 248c85ddd95d6..b90f63f2b488a 100644 --- a/docs/reference/query-languages/esql/esql-syntax.md +++ b/docs/reference/query-languages/esql/esql-syntax.md @@ -159,7 +159,7 @@ FROM library } ``` -You can also use [query parameters](docs-content://explore-analyze/query-filter/languages/esql-rest.md#esql-rest-params) in function named parameters: +You can also use [query parameters](elasticsearch://reference/query-languages/esql/esql-rest.md#esql-rest-params) in function named parameters: ```console POST /_query diff --git a/docs/reference/query-languages/esql/functions-operators/search-functions.md b/docs/reference/query-languages/esql/functions-operators/search-functions.md index bf31cce7df3ca..896287ab3103c 100644 --- a/docs/reference/query-languages/esql/functions-operators/search-functions.md +++ b/docs/reference/query-languages/esql/functions-operators/search-functions.md @@ -8,7 +8,7 @@ mapped_pages: :::{tip} Get started with {{esql}} for search use cases with -our [hands-on tutorial](docs-content://solutions/search/esql-search-tutorial.md). +our [hands-on tutorial](elasticsearch://reference/query-languages/esql/esql-search-tutorial.md). For a high-level overview of search functionalities in {{esql}}, and to learn about relevance scoring, refer to [{{esql}} for search](docs-content://solutions/search/esql-for-search.md#esql-for-search-scoring). ::: diff --git a/docs/reference/query-languages/esql/limitations.md b/docs/reference/query-languages/esql/limitations.md index df248faa36466..0a5c70fed7439 100644 --- a/docs/reference/query-languages/esql/limitations.md +++ b/docs/reference/query-languages/esql/limitations.md @@ -93,7 +93,7 @@ Some [field types](/reference/elasticsearch/mapping-reference/field-data-types.m * `cartesian_shape` -In addition, when [querying multiple indexes](docs-content://explore-analyze/query-filter/languages/esql-multi-index.md), it’s possible for the same field to be mapped to multiple types. These fields cannot be directly used in queries or returned in results, unless they’re [explicitly converted to a single type](docs-content://explore-analyze/query-filter/languages/esql-multi-index.md#esql-multi-index-union-types). +In addition, when [querying multiple indexes](elasticsearch://reference/query-languages/esql/esql-multi-index.md), it’s possible for the same field to be mapped to multiple types. These fields cannot be directly used in queries or returned in results, unless they’re [explicitly converted to a single type](elasticsearch://reference/query-languages/esql/esql-multi-index.md#esql-multi-index-union-types). ## _source availability [esql-_source-availability] @@ -177,10 +177,10 @@ Or consider using one of the [full-text search](/reference/query-languages/esql/ ## Using {{esql}} to query multiple indices [esql-multi-index-limitations] -As discussed in more detail in [Using {{esql}} to query multiple indices](docs-content://explore-analyze/query-filter/languages/esql-multi-index.md), {{esql}} can execute a single query across multiple indices, data streams, or aliases. However, there are some limitations to be aware of: +As discussed in more detail in [Using {{esql}} to query multiple indices](elasticsearch://reference/query-languages/esql/esql-multi-index.md), {{esql}} can execute a single query across multiple indices, data streams, or aliases. However, there are some limitations to be aware of: * 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](docs-content://explore-analyze/query-filter/languages/esql-multi-index.md#esql-multi-index-union-types). +* 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](elasticsearch://reference/query-languages/esql/esql-multi-index.md#esql-multi-index-union-types). ## Time series data streams are not supported [esql-tsdb] From f15c60047f262ad21c8aae3ce3e704ac84ad4a57 Mon Sep 17 00:00:00 2001 From: Liam Thompson Date: Tue, 26 Aug 2025 15:03:47 +0200 Subject: [PATCH 2/2] use non-cross repo paths --- .../configuration-reference/thread-pool-settings.md | 2 +- docs/reference/elasticsearch/index.md | 2 +- .../esql/_snippets/commands/layout/enrich.md | 2 +- .../query-languages/esql/_snippets/commands/layout/from.md | 4 ++-- docs/reference/query-languages/esql/esql-getting-started.md | 2 +- docs/reference/query-languages/esql/esql-rest.md | 2 +- docs/reference/query-languages/esql/esql-search-tutorial.md | 2 +- docs/reference/query-languages/esql/esql-syntax.md | 2 +- .../esql/functions-operators/search-functions.md | 2 +- docs/reference/query-languages/esql/limitations.md | 6 +++--- 10 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/reference/elasticsearch/configuration-reference/thread-pool-settings.md b/docs/reference/elasticsearch/configuration-reference/thread-pool-settings.md index fed63c27bd1b9..1058a235452b8 100644 --- a/docs/reference/elasticsearch/configuration-reference/thread-pool-settings.md +++ b/docs/reference/elasticsearch/configuration-reference/thread-pool-settings.md @@ -92,7 +92,7 @@ $$$search-throttled$$$`search_throttled` : For [watch executions](docs-content://explore-analyze/alerts-cases/watcher.md). Thread pool type is `fixed` with a default maximum size of `min(5 * (`[`# of allocated processors`](#node.processors)`), 50)` and queue_size of `1000`. $$$modules-threadpool-esql$$$`esql_worker` -: Executes [{{esql}}](elasticsearch://reference/query-languages/esql.md) operations. Thread pool type is `fixed` with a size of `int((`[`# of allocated processors`](#node.processors) ` * 3) / 2) + 1`, and queue_size of `1000`. +: Executes [{{esql}}](/reference/query-languages/esql.md) operations. Thread pool type is `fixed` with a size of `int((`[`# of allocated processors`](#node.processors) ` * 3) / 2) + 1`, and queue_size of `1000`. Thread pool settings are [Static](docs-content://deploy-manage/stack-settings.md#static-cluster-setting) and can be changed by editing `elasticsearch.yml`. Changing a specific thread pool can be done by setting its type-specific parameters; for example, changing the number of threads in the `write` thread pool: diff --git a/docs/reference/elasticsearch/index.md b/docs/reference/elasticsearch/index.md index d74f47b2e3e76..18b308999471e 100644 --- a/docs/reference/elasticsearch/index.md +++ b/docs/reference/elasticsearch/index.md @@ -46,7 +46,7 @@ - [Learn how to search your data](docs-content://solutions/search/querying-for-search.md) - Query data programmatically: use query languages to run advanced search, filtering, or analytics - [Query DSL](docs-content://explore-analyze/query-filter/languages/querydsl.md): full JSON-based query language - - [ES|QL](elasticsearch://reference/query-languages/esql.md): fast, SQL-like language with piped syntax + - [ES|QL](/reference/query-languages/esql.md): fast, SQL-like language with piped syntax - [EQL](docs-content://explore-analyze/query-filter/languages/eql.md): for event-based time series data, such as logs, metrics, and traces - [SQL](docs-content://explore-analyze/query-filter/languages/sql.md): SQL-style queries on Elasticsearch data - [Search applications](docs-content://solutions/search/search-applications.md) diff --git a/docs/reference/query-languages/esql/_snippets/commands/layout/enrich.md b/docs/reference/query-languages/esql/_snippets/commands/layout/enrich.md index 22bf1bab20710..854f7d5285481 100644 --- a/docs/reference/query-languages/esql/_snippets/commands/layout/enrich.md +++ b/docs/reference/query-languages/esql/_snippets/commands/layout/enrich.md @@ -22,7 +22,7 @@ ENRICH policy [ON match_field] [WITH [new_name1 = ]field1, [new_name2 = ]field2, `mode` : The mode of the enrich command in cross cluster {{esql}}. - See [enrich across clusters](elasticsearch://reference/query-languages/esql/esql-cross-clusters.md#ccq-enrich). + See [enrich across clusters](/reference/query-languages/esql/esql-cross-clusters.md#ccq-enrich). `match_field` : The match field. `ENRICH` uses its value to look for records in the enrich diff --git a/docs/reference/query-languages/esql/_snippets/commands/layout/from.md b/docs/reference/query-languages/esql/_snippets/commands/layout/from.md index 793eb92a42b0c..6a5d6c2387d19 100644 --- a/docs/reference/query-languages/esql/_snippets/commands/layout/from.md +++ b/docs/reference/query-languages/esql/_snippets/commands/layout/from.md @@ -59,14 +59,14 @@ FROM ``` Use comma-separated lists or wildcards to -[query multiple data streams, indices, or aliases](elasticsearch://reference/query-languages/esql/esql-multi-index.md): +[query multiple data streams, indices, or aliases](/reference/query-languages/esql/esql-multi-index.md): ```esql FROM employees-00001,other-employees-* ``` Use the format `:` to -[query data streams and indices on remote clusters](elasticsearch://reference/query-languages/esql/esql-cross-clusters.md): +[query data streams and indices on remote clusters](/reference/query-languages/esql/esql-cross-clusters.md): ```esql FROM cluster_one:employees-00001,cluster_two:other-employees-* diff --git a/docs/reference/query-languages/esql/esql-getting-started.md b/docs/reference/query-languages/esql/esql-getting-started.md index 8215568f19586..a24baaea4b3e6 100644 --- a/docs/reference/query-languages/esql/esql-getting-started.md +++ b/docs/reference/query-languages/esql/esql-getting-started.md @@ -420,5 +420,5 @@ For more about data processing with {{esql}}, refer to [Data processing with DIS - Explore the zero-setup, live [{{esql}} demo environment](http://esql.demo.elastic.co/). - - Follow along with our hands-on tutorials: - - [Search and filter with {{esql}}](elasticsearch://reference/query-languages/esql/esql-search-tutorial.md): A hands-on tutorial that shows you how to use {{esql}} to search and filter data. + - [Search and filter with {{esql}}](/reference/query-languages/esql/esql-search-tutorial.md): A hands-on tutorial that shows you how to use {{esql}} to search and filter data. - [Threat hunting with {{esql}}](docs-content://solutions/security/esql-for-security/esql-threat-hunting-tutorial.md): A hands-on tutorial that shows you how to use {{esql}} for advanced threat hunting techniques and security analysis. \ No newline at end of file diff --git a/docs/reference/query-languages/esql/esql-rest.md b/docs/reference/query-languages/esql/esql-rest.md index 54405980499fd..ac1c5deab722d 100644 --- a/docs/reference/query-languages/esql/esql-rest.md +++ b/docs/reference/query-languages/esql/esql-rest.md @@ -12,7 +12,7 @@ products: # Use the {{esql}} REST API [esql-rest] ::::{tip} -The [Search and filter with {{esql}}](elasticsearch://reference/query-languages/esql/esql-search-tutorial.md) tutorial provides a hands-on introduction to the {{esql}} `_query` API. +The [Search and filter with {{esql}}](/reference/query-languages/esql/esql-search-tutorial.md) tutorial provides a hands-on introduction to the {{esql}} `_query` API. :::: ## Overview [esql-rest-overview] diff --git a/docs/reference/query-languages/esql/esql-search-tutorial.md b/docs/reference/query-languages/esql/esql-search-tutorial.md index 8b8fbf1a736f6..443c5439b3101 100644 --- a/docs/reference/query-languages/esql/esql-search-tutorial.md +++ b/docs/reference/query-languages/esql/esql-search-tutorial.md @@ -31,7 +31,7 @@ FROM cooking_blog | LIMIT 1000 ``` -If you want to run these queries in the [Dev Tools Console](elasticsearch://reference/query-languages/esql/esql-rest.md#esql-kibana-console), you need to use the following syntax: +If you want to run these queries in the [Dev Tools Console](/reference/query-languages/esql/esql-rest.md#esql-kibana-console), you need to use the following syntax: ```console POST /_query?format=txt diff --git a/docs/reference/query-languages/esql/esql-syntax.md b/docs/reference/query-languages/esql/esql-syntax.md index b90f63f2b488a..ea941563e0728 100644 --- a/docs/reference/query-languages/esql/esql-syntax.md +++ b/docs/reference/query-languages/esql/esql-syntax.md @@ -159,7 +159,7 @@ FROM library } ``` -You can also use [query parameters](elasticsearch://reference/query-languages/esql/esql-rest.md#esql-rest-params) in function named parameters: +You can also use [query parameters](/reference/query-languages/esql/esql-rest.md#esql-rest-params) in function named parameters: ```console POST /_query diff --git a/docs/reference/query-languages/esql/functions-operators/search-functions.md b/docs/reference/query-languages/esql/functions-operators/search-functions.md index 896287ab3103c..597f61cfc5003 100644 --- a/docs/reference/query-languages/esql/functions-operators/search-functions.md +++ b/docs/reference/query-languages/esql/functions-operators/search-functions.md @@ -8,7 +8,7 @@ mapped_pages: :::{tip} Get started with {{esql}} for search use cases with -our [hands-on tutorial](elasticsearch://reference/query-languages/esql/esql-search-tutorial.md). +our [hands-on tutorial](/reference/query-languages/esql/esql-search-tutorial.md). For a high-level overview of search functionalities in {{esql}}, and to learn about relevance scoring, refer to [{{esql}} for search](docs-content://solutions/search/esql-for-search.md#esql-for-search-scoring). ::: diff --git a/docs/reference/query-languages/esql/limitations.md b/docs/reference/query-languages/esql/limitations.md index 0a5c70fed7439..ed5ebbbf6aa87 100644 --- a/docs/reference/query-languages/esql/limitations.md +++ b/docs/reference/query-languages/esql/limitations.md @@ -93,7 +93,7 @@ Some [field types](/reference/elasticsearch/mapping-reference/field-data-types.m * `cartesian_shape` -In addition, when [querying multiple indexes](elasticsearch://reference/query-languages/esql/esql-multi-index.md), it’s possible for the same field to be mapped to multiple types. These fields cannot be directly used in queries or returned in results, unless they’re [explicitly converted to a single type](elasticsearch://reference/query-languages/esql/esql-multi-index.md#esql-multi-index-union-types). +In addition, when [querying multiple indexes](/reference/query-languages/esql/esql-multi-index.md), it’s possible for the same field to be mapped to multiple types. These fields cannot be directly used in queries or returned in results, unless they’re [explicitly converted to a single type](/reference/query-languages/esql/esql-multi-index.md#esql-multi-index-union-types). ## _source availability [esql-_source-availability] @@ -177,10 +177,10 @@ Or consider using one of the [full-text search](/reference/query-languages/esql/ ## Using {{esql}} to query multiple indices [esql-multi-index-limitations] -As discussed in more detail in [Using {{esql}} to query multiple indices](elasticsearch://reference/query-languages/esql/esql-multi-index.md), {{esql}} can execute a single query across multiple indices, data streams, or aliases. However, there are some limitations to be aware of: +As discussed in more detail in [Using {{esql}} to query multiple indices](/reference/query-languages/esql/esql-multi-index.md), {{esql}} can execute a single query across multiple indices, data streams, or aliases. However, there are some limitations to be aware of: * 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](elasticsearch://reference/query-languages/esql/esql-multi-index.md#esql-multi-index-union-types). +* 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 are not supported [esql-tsdb]