elasticsearch/docs/reference/search/search-your-data
Michael Peterson a451511e3a
Change skip_unavailable default value to true (#105792)
In order to improve the experience of cross-cluster search, we are changing
the default value of the remote cluster `skip_unavailable` setting from `false` to `true`.

This setting causes any cross-cluster _search (or _async_search) to entirely fail when
any remote cluster with `skip_unavailable=false` is either unavailable (connection to it fails)
or if the search on it fails on all shards.

Setting `skip_unavailable=true` allows partial results from other clusters to be
returned. In that case, the search response cluster metadata will show a `skipped`
status, so the user can see that no data came in from that cluster. Kibana also
now leverages this metadata in the cross-cluster search responses to allow users
to see how many clusters returned data and drill down into which clusters did not
(including failure messages).

Currently, the user/admin has to specifically set the value to `true` in the configs, like so:

```
cluster:
    remote:
        remote1:
            seeds: 10.10.10.10:9300
            skip_unavailable: true
```

even though that is probably what search admins want in the vast majority of cases.

Setting `skip_unavailable=false` should be a conscious (and probably rare) choice
by an Elasticsearch admin that a particular cluster's results are so essential to a
search (or visualization in dashboard or Discover panel) that no results at all should
be shown if it cannot return any results.
2024-04-29 15:53:47 -04:00
..
behavioral-analytics [DOCS] Migrate Behavioral Analytics docs to ES ref (#100704) 2023-10-13 09:05:23 +02:00
ccs-version-compat-matrix.asciidoc [Docs] Fix CCS matrix for 8.13 (#107028) 2024-04-03 10:54:49 +02:00
collapse-search-results.asciidoc Allow rescorer with field collapsing (#107779) 2024-04-29 08:48:12 +01:00
filter-search-results.asciidoc [DOCS] Refresh "Search your data" (#99482) 2023-10-10 10:47:35 +02:00
highlighting.asciidoc [DOCS] Refresh "Search your data" (#99482) 2023-10-10 10:47:35 +02:00
knn-search.asciidoc [DOCS] Refactor book-scoped variables in docs/reference/index.asciidoc (#107413) 2024-04-17 14:37:07 +02:00
learning-to-rank-model-training.asciidoc Fix typo in the LTR guide. (#106276) 2024-03-13 09:05:47 +01:00
learning-to-rank-search-usage.asciidoc Allow rescorer with field collapsing (#107779) 2024-04-29 08:48:12 +01:00
learning-to-rank.asciidoc First version of the LTR guide. (#105956) 2024-03-11 17:26:01 +01:00
long-running-searches.asciidoc [DOCS] Refresh "Search your data" (#99482) 2023-10-10 10:47:35 +02:00
near-real-time.asciidoc [DOCS] Refresh "Search your data" (#99482) 2023-10-10 10:47:35 +02:00
paginate-search-results.asciidoc [DOCS] Refresh "Search your data" (#99482) 2023-10-10 10:47:35 +02:00
retrieve-inner-hits.asciidoc [DOCS] Refresh "Search your data" (#99482) 2023-10-10 10:47:35 +02:00
retrieve-selected-fields.asciidoc [DOCS] Refresh "Search your data" (#99482) 2023-10-10 10:47:35 +02:00
search-across-clusters.asciidoc Change skip_unavailable default value to true (#105792) 2024-04-29 15:53:47 -04:00
search-api.asciidoc Clarify text expansion query docs to not suggest enabling track_total_hits for performance (#102102) 2023-11-20 08:56:26 -05:00
search-application-api.asciidoc Add retrievers using the parser-only approach (#105470) 2024-03-12 10:11:55 -07:00
search-application-client.asciidoc [DOCS] Refresh "Search your data" (#99482) 2023-10-10 10:47:35 +02:00
search-application-overview.asciidoc [DOCS] Refresh "Search your data" (#99482) 2023-10-10 10:47:35 +02:00
search-application-security.asciidoc [DOCS] Refresh "Search your data" (#99482) 2023-10-10 10:47:35 +02:00
search-multiple-indices.asciidoc [DOCS] Refresh "Search your data" (#99482) 2023-10-10 10:47:35 +02:00
search-shard-routing.asciidoc [DOCS] Refresh "Search your data" (#99482) 2023-10-10 10:47:35 +02:00
search-template.asciidoc Check that scripts produce correct json in render template action (#101518) 2023-10-30 13:25:39 +00:00
search-using-query-rules.asciidoc [Query Rules] Add some usability clarifications to docs (#102990) 2023-12-06 17:16:56 -05:00
search-with-synonyms.asciidoc [DOCS] Refactor book-scoped variables in docs/reference/index.asciidoc (#107413) 2024-04-17 14:37:07 +02:00
search-your-data.asciidoc First version of the LTR guide. (#105956) 2024-03-11 17:26:01 +01:00
semantic-search-elser.asciidoc [DOCS] Adds disclaimer to semantic search tutorials (#106590) 2024-03-21 11:32:57 +01:00
semantic-search-inference.asciidoc [DOCS] Refactor book-scoped variables in docs/reference/index.asciidoc (#107413) 2024-04-17 14:37:07 +02:00
semantic-search.asciidoc [DOCS] Refactor book-scoped variables in docs/reference/index.asciidoc (#107413) 2024-04-17 14:37:07 +02:00
sort-search-results.asciidoc [DOCS] Refresh "Search your data" (#99482) 2023-10-10 10:47:35 +02:00