diff --git a/docs/reference/ccr/apis/auto-follow/put-auto-follow-pattern.asciidoc b/docs/reference/ccr/apis/auto-follow/put-auto-follow-pattern.asciidoc index 3876cab007d9..e6509e024de8 100644 --- a/docs/reference/ccr/apis/auto-follow/put-auto-follow-pattern.asciidoc +++ b/docs/reference/ccr/apis/auto-follow/put-auto-follow-pattern.asciidoc @@ -58,7 +58,10 @@ This API creates a new named collection of <> against the remote cluster specified in the request body. Newly created indices on the remote cluster matching any of the specified patterns will be automatically configured as follower -indices. Additionally, this API can be used to update existing +indices. Indices on the remote cluster that were created before the auto-follow +pattern is created won't be auto-followed even if they match the pattern. + +This API can also be used to update existing <>. Note that follower indices that were configured automatically before updating an auto-follow pattern will remain unchanged even if they don't match against the new patterns. diff --git a/docs/reference/ccr/getting-started.asciidoc b/docs/reference/ccr/getting-started.asciidoc index c5a2ac98e4e3..779dfc301baa 100644 --- a/docs/reference/ccr/getting-started.asciidoc +++ b/docs/reference/ccr/getting-started.asciidoc @@ -99,7 +99,7 @@ example, `cluster.es.eastus2.staging.azure.foundit.no:9400` or [%collapsible%open] .API example ==== -You can also use the <> to +You can also use the <> to add a remote cluster: [source,console] @@ -192,8 +192,8 @@ image::images/ccr-follower-index.png["The Cross-Cluster Replication page in {kib [%collapsible%open] .API example ==== -You can also use the <> to create follower -indices. When you create a follower index, you must reference the remote cluster +You can also use the <> to create follower +indices. When you create a follower index, you must reference the remote cluster and the leader index that you created in the remote cluster. When initiating the follower request, the response returns before the @@ -247,7 +247,9 @@ POST /server-metrics-follower/_ccr/unfollow You use <> to automatically create new followers for rolling time series indices. Whenever the name of a new index on the remote cluster matches the auto-follow pattern, a corresponding follower -index is added to the local cluster. +index is added to the local cluster. Note that only indices created on the +remote cluster after the auto-follow pattern is created will be auto-followed: +existing indices on the remote cluster are ignored even if they match the pattern. An auto-follow pattern specifies the remote cluster you want to replicate from, and one or more index patterns that specify the rolling time series indices you