Skip to content

Commit 67f6840

Browse files
authored
[DOCS] Document how CCS handles cluster-level settings (#49941)
Updates the cross-cluster search (CCS) documentation to note how cluster-level settings are applied. When `ccs_minimize_roundtrips` is `true`, each cluster applies its own cluster-level settings to the request. When `ccs_minimize_roundtrips` is `false`, cluster-level settings for the local cluster is used. This includes shard limit settings, such as `action.search.shard_count.limit`, `pre_filter_shard_size`, and `max_concurrent_shard_requests`. If these limits are set too low, the request could be rejected.
1 parent 85fa2bd commit 67f6840

File tree

1 file changed

+11
-1
lines changed

1 file changed

+11
-1
lines changed

docs/reference/modules/cross-cluster-search.asciidoc

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -302,7 +302,8 @@ cluster receives and parses the request.
302302
image:images/ccs/ccs-min-roundtrip-client-request.svg[]
303303

304304
. The coordinating node sends a single search request to each cluster, including
305-
its own. Each cluster performs the search request independently.
305+
the local cluster. Each cluster performs the search request independently,
306+
applying its own cluster-level settings to the request.
306307
+
307308
image:images/ccs/ccs-min-roundtrip-cluster-search.svg[]
308309

@@ -340,6 +341,15 @@ image:images/ccs/ccs-min-roundtrip-cluster-results.svg[]
340341
. The coordinating node sends a search request to each shard, including those in
341342
its own cluster. Each shard performs the search request independently.
342343
+
344+
[WARNING]
345+
====
346+
When network roundtrips aren't minimized, the search is executed as if all data
347+
were in the coordinating node's cluster. We recommend updating cluster-level
348+
settings that limit searches, such as `action.search.shard_count.limit`,
349+
`pre_filter_shard_size`, and `max_concurrent_shard_requests`, to account for
350+
this. If these limits are too low, the search may be rejected.
351+
====
352+
+
343353
image:images/ccs/ccs-dont-min-roundtrip-shard-search.svg[]
344354

345355
. Each shard sends its search results back to the coordinating node.

0 commit comments

Comments
 (0)