elasticsearch/docs/reference/modules
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
..
cluster Change skip_unavailable default value to true (#105792) 2024-04-29 15:53:47 -04:00
discovery Update discovery.asciidoc (#106541) (#106695) 2024-03-22 15:43:48 -04:00
indices [DOCS] Refactor book-scoped variables in docs/reference/index.asciidoc (#107413) 2024-04-17 14:37:07 +02:00
network Mention network handler logging in docs (#100118) 2023-10-02 08:52:16 +01:00
cluster.asciidoc [DOCS] Document dynamic cluster-lvl shard alloc settings (#61338) 2020-08-31 11:04:11 -04:00
discovery.asciidoc [DOCS] Remove redirect pages (#88738) 2023-05-24 12:32:46 +01:00
gateway.asciidoc Remove deprecated gateway settings (#53845) 2021-02-03 14:10:45 +00:00
http.asciidoc Security auto-config overrides default http.host (#105377) 2024-02-12 09:54:38 +00:00
network.asciidoc Security auto-config overrides default http.host (#105377) 2024-02-12 09:54:38 +00:00
node.asciidoc [DOCS] Refactor book-scoped variables in docs/reference/index.asciidoc (#107413) 2024-04-17 14:37:07 +02:00
plugins.asciidoc [DOCS] Relocate "Plugins" page (#54974) 2020-04-10 15:29:44 -04:00
remote-cluster-network.asciidoc [Docs] Misc doc update for RCS 2.0 (#98472) 2023-08-15 20:11:21 -04:00
remote-clusters-shared.asciidoc [DOCS] Update remote cluster version compatibility table for 8.x (#81239) 2021-12-16 11:16:24 -05:00
remote-clusters.asciidoc [DOCS] [Remote clusters] Reference specific instructions for cloud trust 2024-02-15 09:39:02 +01:00
threadpool.asciidoc [DOC+] Write threadpool also covers ingest pipelines (#99010) 2023-08-29 13:51:18 -04:00
transport.asciidoc [DOCS] Remove redirect pages (#88738) 2023-05-24 12:32:46 +01:00