From 78c1c73963ac55d689e5ee384e7c48e08509f9fe Mon Sep 17 00:00:00 2001 From: Florent Le Borgne Date: Tue, 19 May 2026 10:53:03 +0200 Subject: [PATCH 1/9] docs: mark data.autocomplete.* settings as deprecated since 8.3.0 (#6511) These settings were moved to unifiedSearch.autocomplete.* when the unified_search plugin was introduced in 8.3.0. The docs still showed them as valid current settings with no deprecation indicator. Co-authored-by: Cursor --- .../configuration-reference/general-settings.yml | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/reference/configuration-reference/general-settings.yml b/docs/reference/configuration-reference/general-settings.yml index b726c3e428e2c..51e91491a15d1 100644 --- a/docs/reference/configuration-reference/general-settings.yml +++ b/docs/reference/configuration-reference/general-settings.yml @@ -894,9 +894,10 @@ groups: datatype: int default: 100000 applies_to: - stack: ga - ech: ga - self: ga + - "stack: deprecated 8.3" + - "ech: ga" + - "self: ga" + deprecation_details: "Deprecated in 8.3.0. Use `unifiedSearch.autocomplete.valueSuggestions.terminateAfter` instead." - setting: data.autocomplete.valueSuggestions.timeout description: | @@ -904,9 +905,10 @@ groups: datatype: int default: 1000 applies_to: - stack: ga - ech: ga - self: ga + - "stack: deprecated 8.3" + - "ech: ga" + - "self: ga" + deprecation_details: "Deprecated in 8.3.0. Use `unifiedSearch.autocomplete.valueSuggestions.timeout` instead." - setting: unifiedSearch.autocomplete.valueSuggestions.timeout description: | From 160e78a5d4d63705535699b3f6920c156e766eea Mon Sep 17 00:00:00 2001 From: Florent Le Borgne Date: Tue, 19 May 2026 11:01:24 +0200 Subject: [PATCH 2/9] docs: set ech: unavailable for deprecated data.autocomplete.* settings Co-authored-by: Cursor --- docs/reference/configuration-reference/general-settings.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/configuration-reference/general-settings.yml b/docs/reference/configuration-reference/general-settings.yml index 51e91491a15d1..8b95f72b72a71 100644 --- a/docs/reference/configuration-reference/general-settings.yml +++ b/docs/reference/configuration-reference/general-settings.yml @@ -895,7 +895,7 @@ groups: default: 100000 applies_to: - "stack: deprecated 8.3" - - "ech: ga" + - "ech: unavailable" - "self: ga" deprecation_details: "Deprecated in 8.3.0. Use `unifiedSearch.autocomplete.valueSuggestions.terminateAfter` instead." @@ -906,7 +906,7 @@ groups: default: 1000 applies_to: - "stack: deprecated 8.3" - - "ech: ga" + - "ech: unavailable" - "self: ga" deprecation_details: "Deprecated in 8.3.0. Use `unifiedSearch.autocomplete.valueSuggestions.timeout` instead." From 0c34690fd2622203253c234a596c7d87a7e6e5d9 Mon Sep 17 00:00:00 2001 From: Florent Le Borgne Date: Tue, 19 May 2026 11:09:25 +0200 Subject: [PATCH 3/9] docs: add 9.4.0-9.4.1 startup failure note to deprecated data.autocomplete.* settings Co-authored-by: Cursor --- .../configuration-reference/general-settings.yml | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/reference/configuration-reference/general-settings.yml b/docs/reference/configuration-reference/general-settings.yml index 8b95f72b72a71..bfb06377818a7 100644 --- a/docs/reference/configuration-reference/general-settings.yml +++ b/docs/reference/configuration-reference/general-settings.yml @@ -898,6 +898,11 @@ groups: - "ech: unavailable" - "self: ga" deprecation_details: "Deprecated in 8.3.0. Use `unifiedSearch.autocomplete.valueSuggestions.terminateAfter` instead." + note: | + :::{note} + :applies_to: stack: ga 9.4.0!-9.4.1! + Using this setting in Kibana 9.4.0 and 9.4.1 causes a startup failure due to a known regression. Upgrade to 9.4.2 or later, or migrate to `unifiedSearch.autocomplete.valueSuggestions.terminateAfter`. + ::: - setting: data.autocomplete.valueSuggestions.timeout description: | @@ -909,6 +914,11 @@ groups: - "ech: unavailable" - "self: ga" deprecation_details: "Deprecated in 8.3.0. Use `unifiedSearch.autocomplete.valueSuggestions.timeout` instead." + note: | + :::{note} + :applies_to: stack: ga 9.4.0!-9.4.1! + Using this setting in Kibana 9.4.0 and 9.4.1 causes a startup failure due to a known regression. Upgrade to 9.4.2 or later, or migrate to `unifiedSearch.autocomplete.valueSuggestions.timeout`. + ::: - setting: unifiedSearch.autocomplete.valueSuggestions.timeout description: | From 20b604124aea557b9890297d0b8a4e78a8e4b85a Mon Sep 17 00:00:00 2001 From: Florent LB Date: Tue, 19 May 2026 11:17:41 +0200 Subject: [PATCH 4/9] Apply suggestion from @florent-leborgne --- docs/reference/configuration-reference/general-settings.yml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/reference/configuration-reference/general-settings.yml b/docs/reference/configuration-reference/general-settings.yml index bfb06377818a7..18d9385febcce 100644 --- a/docs/reference/configuration-reference/general-settings.yml +++ b/docs/reference/configuration-reference/general-settings.yml @@ -891,6 +891,11 @@ groups: - setting: data.autocomplete.valueSuggestions.terminateAfter description: | Specifies the max number of documents loaded by each shard to generate autocomplete suggestions. Allowed values are between 1 and 10000000. + + :::{note} + :applies_to: stack: ga 9.4.0!-9.4.1! + Using this setting in Kibana 9.4.0 and 9.4.1 causes a startup failure due to a known regression. Migrate to `unifiedSearch.autocomplete.valueSuggestions.terminateAfter` or upgrade to a later version. + ::: datatype: int default: 100000 applies_to: From 86f538ffe51e8416baec8e1b53c359a6ca4da244 Mon Sep 17 00:00:00 2001 From: Florent LB Date: Tue, 19 May 2026 11:18:17 +0200 Subject: [PATCH 5/9] Apply suggestion from @florent-leborgne --- docs/reference/configuration-reference/general-settings.yml | 5 ----- 1 file changed, 5 deletions(-) diff --git a/docs/reference/configuration-reference/general-settings.yml b/docs/reference/configuration-reference/general-settings.yml index 18d9385febcce..734092bd54368 100644 --- a/docs/reference/configuration-reference/general-settings.yml +++ b/docs/reference/configuration-reference/general-settings.yml @@ -903,11 +903,6 @@ groups: - "ech: unavailable" - "self: ga" deprecation_details: "Deprecated in 8.3.0. Use `unifiedSearch.autocomplete.valueSuggestions.terminateAfter` instead." - note: | - :::{note} - :applies_to: stack: ga 9.4.0!-9.4.1! - Using this setting in Kibana 9.4.0 and 9.4.1 causes a startup failure due to a known regression. Upgrade to 9.4.2 or later, or migrate to `unifiedSearch.autocomplete.valueSuggestions.terminateAfter`. - ::: - setting: data.autocomplete.valueSuggestions.timeout description: | From 38fb25b8505404611037766bbf64a32b5cbfaedf Mon Sep 17 00:00:00 2001 From: Florent LB Date: Tue, 19 May 2026 11:18:48 +0200 Subject: [PATCH 6/9] Apply suggestion from @florent-leborgne --- docs/reference/configuration-reference/general-settings.yml | 5 ----- 1 file changed, 5 deletions(-) diff --git a/docs/reference/configuration-reference/general-settings.yml b/docs/reference/configuration-reference/general-settings.yml index 734092bd54368..015074d4f47db 100644 --- a/docs/reference/configuration-reference/general-settings.yml +++ b/docs/reference/configuration-reference/general-settings.yml @@ -914,11 +914,6 @@ groups: - "ech: unavailable" - "self: ga" deprecation_details: "Deprecated in 8.3.0. Use `unifiedSearch.autocomplete.valueSuggestions.timeout` instead." - note: | - :::{note} - :applies_to: stack: ga 9.4.0!-9.4.1! - Using this setting in Kibana 9.4.0 and 9.4.1 causes a startup failure due to a known regression. Upgrade to 9.4.2 or later, or migrate to `unifiedSearch.autocomplete.valueSuggestions.timeout`. - ::: - setting: unifiedSearch.autocomplete.valueSuggestions.timeout description: | From 1392135265c8dfeeeafdb4ace03c77e38fa334a0 Mon Sep 17 00:00:00 2001 From: Florent LB Date: Tue, 19 May 2026 11:19:34 +0200 Subject: [PATCH 7/9] Apply suggestion from @florent-leborgne --- docs/reference/configuration-reference/general-settings.yml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/reference/configuration-reference/general-settings.yml b/docs/reference/configuration-reference/general-settings.yml index 015074d4f47db..b4511e778261e 100644 --- a/docs/reference/configuration-reference/general-settings.yml +++ b/docs/reference/configuration-reference/general-settings.yml @@ -907,6 +907,11 @@ groups: - setting: data.autocomplete.valueSuggestions.timeout description: | Specifies the time in milliseconds to wait for autocomplete suggestions from Elasticsearch. Allowed values are between 1 and 1200000. + + :::{note} + :applies_to: stack: ga 9.4.0!-9.4.1! + Using this setting in Kibana 9.4.0 and 9.4.1 causes a startup failure due to a known regression. Migrate to `unifiedSearch.autocomplete.valueSuggestions.timeout` or upgrade to a later version. + ::: datatype: int default: 1000 applies_to: From fa103096c091349c08637ac147238dfbe6782cb9 Mon Sep 17 00:00:00 2001 From: Florent Le Borgne Date: Tue, 19 May 2026 11:27:05 +0200 Subject: [PATCH 8/9] docs: use note: field for 9.4.0-9.4.1 startup failure warning Co-authored-by: Cursor --- .../configuration-reference/general-settings.yml | 16 ++++++---------- 1 file changed, 6 insertions(+), 10 deletions(-) diff --git a/docs/reference/configuration-reference/general-settings.yml b/docs/reference/configuration-reference/general-settings.yml index b4511e778261e..2418738423f39 100644 --- a/docs/reference/configuration-reference/general-settings.yml +++ b/docs/reference/configuration-reference/general-settings.yml @@ -891,11 +891,6 @@ groups: - setting: data.autocomplete.valueSuggestions.terminateAfter description: | Specifies the max number of documents loaded by each shard to generate autocomplete suggestions. Allowed values are between 1 and 10000000. - - :::{note} - :applies_to: stack: ga 9.4.0!-9.4.1! - Using this setting in Kibana 9.4.0 and 9.4.1 causes a startup failure due to a known regression. Migrate to `unifiedSearch.autocomplete.valueSuggestions.terminateAfter` or upgrade to a later version. - ::: datatype: int default: 100000 applies_to: @@ -903,15 +898,13 @@ groups: - "ech: unavailable" - "self: ga" deprecation_details: "Deprecated in 8.3.0. Use `unifiedSearch.autocomplete.valueSuggestions.terminateAfter` instead." + note: | + :applies_to: stack: ga 9.4.0!-9.4.1! + Using this setting in Kibana 9.4.0 and 9.4.1 causes a startup failure due to a known regression. Migrate to `unifiedSearch.autocomplete.valueSuggestions.terminateAfter` or upgrade to a later version. - setting: data.autocomplete.valueSuggestions.timeout description: | Specifies the time in milliseconds to wait for autocomplete suggestions from Elasticsearch. Allowed values are between 1 and 1200000. - - :::{note} - :applies_to: stack: ga 9.4.0!-9.4.1! - Using this setting in Kibana 9.4.0 and 9.4.1 causes a startup failure due to a known regression. Migrate to `unifiedSearch.autocomplete.valueSuggestions.timeout` or upgrade to a later version. - ::: datatype: int default: 1000 applies_to: @@ -919,6 +912,9 @@ groups: - "ech: unavailable" - "self: ga" deprecation_details: "Deprecated in 8.3.0. Use `unifiedSearch.autocomplete.valueSuggestions.timeout` instead." + note: | + :applies_to: stack: ga 9.4.0!-9.4.1! + Using this setting in Kibana 9.4.0 and 9.4.1 causes a startup failure due to a known regression. Migrate to `unifiedSearch.autocomplete.valueSuggestions.timeout` or upgrade to a later version. - setting: unifiedSearch.autocomplete.valueSuggestions.timeout description: | From 8017db25412b6d61f3b1aa060b471011b771e40f Mon Sep 17 00:00:00 2001 From: Florent Le Borgne Date: Tue, 19 May 2026 12:04:46 +0200 Subject: [PATCH 9/9] docs: fix ech availability and add unifiedSearch canonical settings - data.autocomplete.* settings: ech: ga (all three generations are explicitly allowlisted in ECH, not unavailable) - unifiedSearch.autocomplete.* settings: stack: ga 8.3 to reflect when these became the canonical replacement settings Co-authored-by: Cursor --- .../configuration-reference/general-settings.yml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/reference/configuration-reference/general-settings.yml b/docs/reference/configuration-reference/general-settings.yml index 2418738423f39..c78884538a6d5 100644 --- a/docs/reference/configuration-reference/general-settings.yml +++ b/docs/reference/configuration-reference/general-settings.yml @@ -895,7 +895,7 @@ groups: default: 100000 applies_to: - "stack: deprecated 8.3" - - "ech: unavailable" + - "ech: ga" - "self: ga" deprecation_details: "Deprecated in 8.3.0. Use `unifiedSearch.autocomplete.valueSuggestions.terminateAfter` instead." note: | @@ -909,7 +909,7 @@ groups: default: 1000 applies_to: - "stack: deprecated 8.3" - - "ech: unavailable" + - "ech: ga" - "self: ga" deprecation_details: "Deprecated in 8.3.0. Use `unifiedSearch.autocomplete.valueSuggestions.timeout` instead." note: | @@ -922,7 +922,7 @@ groups: datatype: int default: 1000 applies_to: - stack: ga + stack: ga 8.3 ech: ga self: ga @@ -932,7 +932,7 @@ groups: datatype: int default: 100000 applies_to: - stack: ga + stack: ga 8.3 ech: ga self: ga note: "To reload the logging settings, send a SIGHUP signal to {{kib}}. For more logging configuration options, see the [Configure Logging in {{kib}}](docs-content://deploy-manage/monitor/logging-configuration/kibana-logging.md) guide."