Skip to content

[KQL] Bring back config deprecations#268872

Merged
afharo merged 6 commits into
elastic:mainfrom
afharo:kql/bring-back-config-deprecations
May 12, 2026
Merged

[KQL] Bring back config deprecations#268872
afharo merged 6 commits into
elastic:mainfrom
afharo:kql/bring-back-config-deprecations

Conversation

@afharo
Copy link
Copy Markdown
Member

@afharo afharo commented May 12, 2026

Summary

It looks like this conversation had a misunderstanding: it focused on the unifiedSearch -> kql change, but it forgot the pre-existing rename from data.autocomplete to unifiedSearch.autocomplete.

We've seen some customers hitting this old path, so this PR brings it back.

@afharo afharo self-assigned this May 12, 2026
@afharo afharo requested a review from a team as a code owner May 12, 2026 11:47
@afharo afharo added Team:Presentation Presentation Team for Dashboard, Input Controls, and Canvas t// release_note:skip Skip the PR/issue when compiling release notes backport:version Backport to applied version labels v9.4.1 labels May 12, 2026
@infra-vault-gh-plugin-prod
Copy link
Copy Markdown

Pinging @elastic/kibana-presentation (Team:Presentation)

@afharo afharo added Duty:Core Team:Core Platform Core services: plugins, logging, config, saved objects, http, ES client, i18n, etc t// labels May 12, 2026
@infra-vault-gh-plugin-prod
Copy link
Copy Markdown

Pinging @elastic/kibana-core (Team:Core)

Copy link
Copy Markdown
Contributor

@nickpeihl nickpeihl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm! thanks.

Copy link
Copy Markdown
Contributor

@stratoula stratoula left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, tested locally.

Yeah def a misunderstanding because it was deleted here e23c55a#diff-0a87013bdf7a65805f246c8f3d9e04340c9432afa521ae52e0d96d3c82239c4b

Thanks for fixing it Alejandro

@afharo afharo enabled auto-merge (squash) May 12, 2026 12:15
@kibanamachine
Copy link
Copy Markdown
Contributor

💛 Build succeeded, but was flaky

Failed CI Steps

Test Failures

  • [job] [logs] Scout Lane #9 - stateful-classic / default / local-stateful-classic - Profiling is setup and data is loaded - Admin user

Metrics [docs]

✅ unchanged

History

cc @afharo

@afharo afharo merged commit 8713573 into elastic:main May 12, 2026
32 checks passed
@afharo afharo deleted the kql/bring-back-config-deprecations branch May 12, 2026 15:15
@kibanamachine
Copy link
Copy Markdown
Contributor

Starting backport for target branches: 9.4

https://github.com/elastic/kibana/actions/runs/25743784179

@kibanamachine
Copy link
Copy Markdown
Contributor

💚 All backports created successfully

Status Branch Result
9.4

Note: Successful backport PRs will be merged automatically after passing CI.

Questions ?

Please refer to the Backport tool documentation

kibanamachine added a commit that referenced this pull request May 12, 2026
# Backport

This will backport the following commits from `main` to `9.4`:
- [[KQL] Bring back config deprecations
(#268872)](#268872)

<!--- Backport version: 9.6.6 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sorenlouv/backport)

<!--BACKPORT [{"author":{"name":"Alejandro Fernández
Haro","email":"alejandro.haro@elastic.co"},"sourceCommit":{"committedDate":"2026-05-12T15:15:04Z","message":"[KQL]
Bring back config deprecations (#268872)\n\n## Summary\n\nIt looks like
[this\nconversation](https://github.com/elastic/kibana/pull/246674#discussion_r2668848366)\nhad
a misunderstanding: it focused on the `unifiedSearch` -> `kql`\nchange,
but it forgot the pre-existing rename from `data.autocomplete`\nto
`unifiedSearch.autocomplete`.\n\nWe've seen some customers hitting this
old path, so this PR brings it\nback.\n\n---------\n\nCo-authored-by:
kibanamachine
<42973632+kibanamachine@users.noreply.github.com>","sha":"8713573409f0be7c5baf98e566224becb621ac48","branchLabelMapping":{"^v9.5.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Core","Team:Presentation","release_note:skip","backport:version","Duty:Core","v9.5.0","v9.4.1"],"title":"[KQL]
Bring back config
deprecations","number":268872,"url":"https://github.com/elastic/kibana/pull/268872","mergeCommit":{"message":"[KQL]
Bring back config deprecations (#268872)\n\n## Summary\n\nIt looks like
[this\nconversation](https://github.com/elastic/kibana/pull/246674#discussion_r2668848366)\nhad
a misunderstanding: it focused on the `unifiedSearch` -> `kql`\nchange,
but it forgot the pre-existing rename from `data.autocomplete`\nto
`unifiedSearch.autocomplete`.\n\nWe've seen some customers hitting this
old path, so this PR brings it\nback.\n\n---------\n\nCo-authored-by:
kibanamachine
<42973632+kibanamachine@users.noreply.github.com>","sha":"8713573409f0be7c5baf98e566224becb621ac48"}},"sourceBranch":"main","suggestedTargetBranches":["9.4"],"targetPullRequestStates":[{"branch":"main","label":"v9.5.0","branchLabelMappingKey":"^v9.5.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/268872","number":268872,"mergeCommit":{"message":"[KQL]
Bring back config deprecations (#268872)\n\n## Summary\n\nIt looks like
[this\nconversation](https://github.com/elastic/kibana/pull/246674#discussion_r2668848366)\nhad
a misunderstanding: it focused on the `unifiedSearch` -> `kql`\nchange,
but it forgot the pre-existing rename from `data.autocomplete`\nto
`unifiedSearch.autocomplete`.\n\nWe've seen some customers hitting this
old path, so this PR brings it\nback.\n\n---------\n\nCo-authored-by:
kibanamachine
<42973632+kibanamachine@users.noreply.github.com>","sha":"8713573409f0be7c5baf98e566224becb621ac48"}},{"branch":"9.4","label":"v9.4.1","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->

Co-authored-by: Alejandro Fernández Haro <alejandro.haro@elastic.co>
patrykkopycinski pushed a commit to patrykkopycinski/kibana that referenced this pull request May 13, 2026
## Summary

It looks like [this
conversation](elastic#246674 (comment))
had a misunderstanding: it focused on the `unifiedSearch` -> `kql`
change, but it forgot the pre-existing rename from `data.autocomplete`
to `unifiedSearch.autocomplete`.

We've seen some customers hitting this old path, so this PR brings it
back.

---------

Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
DennisKo pushed a commit to DennisKo/kibana that referenced this pull request May 13, 2026
## Summary

It looks like [this
conversation](elastic#246674 (comment))
had a misunderstanding: it focused on the `unifiedSearch` -> `kql`
change, but it forgot the pre-existing rename from `data.autocomplete`
to `unifiedSearch.autocomplete`.

We've seen some customers hitting this old path, so this PR brings it
back.

---------

Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
florent-leborgne added a commit that referenced this pull request May 21, 2026
…269868)

## Summary

This PR addresses elastic/docs-content#6511.

The page [General settings in
Kibana](https://www.elastic.co/docs/reference/kibana/configuration-reference/general-settings)
lists \`data.autocomplete.valueSuggestions.terminateAfter\` and
\`data.autocomplete.valueSuggestions.timeout\` without any deprecation
indicator, making them appear as valid current settings.

These settings were deprecated in Kibana 8.3.0 when the autocomplete
logic was moved from the \`data\` plugin to the \`unified_search\`
plugin (now \`kql\`) via
[#129977](#129977). The canonical
settings since 8.3.0 are
\`unifiedSearch.autocomplete.valueSuggestions.terminateAfter\` and
\`unifiedSearch.autocomplete.valueSuggestions.timeout\`.

The backward-compatible deprecation handler (which remaps the old keys
to the new ones with a warning) was accidentally removed in
[#246674](#246674) and restored in
[#268872](#268872) (backported to
v9.4.2 and v9.5.0). During the window between 9.4.0 and 9.4.1, customers
using \`data.autocomplete.*\` in \`kibana.yml\` experienced startup
failures.

All three generations of the settings (\`kibana.*\`, \`data.*\`,
\`unifiedSearch.*\`) are explicitly allowlisted in ECH and work for
users on ECH deployments.

## Changes

- **\`docs/reference/configuration-reference/general-settings.yml\`**:
- Marks \`data.autocomplete.valueSuggestions.terminateAfter\` and
\`data.autocomplete.valueSuggestions.timeout\` as \`deprecated 8.3\` on
stack, with \`deprecation_details\` pointing to the \`unifiedSearch.*\`
replacements.
- Adds an inline note on both deprecated settings warning that using
them in Kibana 9.4.0–9.4.1 causes a startup failure, and advising users
to migrate or upgrade.
- Adds \`unifiedSearch.autocomplete.valueSuggestions.timeout\` and
\`unifiedSearch.autocomplete.valueSuggestions.terminateAfter\` as
\`stack: ga 8.3\` entries so the canonical settings are properly
documented.

## Resolves

Closes elastic/docs-content#6511

---

> **AI-assisted draft** — created with Claude Sonnet 4.6 in Cursor.
> Review all generated content for factual accuracy before merging.

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
paulinashakirova pushed a commit to paulinashakirova/kibana that referenced this pull request May 22, 2026
…lastic#269868)

## Summary

This PR addresses elastic/docs-content#6511.

The page [General settings in
Kibana](https://www.elastic.co/docs/reference/kibana/configuration-reference/general-settings)
lists \`data.autocomplete.valueSuggestions.terminateAfter\` and
\`data.autocomplete.valueSuggestions.timeout\` without any deprecation
indicator, making them appear as valid current settings.

These settings were deprecated in Kibana 8.3.0 when the autocomplete
logic was moved from the \`data\` plugin to the \`unified_search\`
plugin (now \`kql\`) via
[elastic#129977](elastic#129977). The canonical
settings since 8.3.0 are
\`unifiedSearch.autocomplete.valueSuggestions.terminateAfter\` and
\`unifiedSearch.autocomplete.valueSuggestions.timeout\`.

The backward-compatible deprecation handler (which remaps the old keys
to the new ones with a warning) was accidentally removed in
[elastic#246674](elastic#246674) and restored in
[elastic#268872](elastic#268872) (backported to
v9.4.2 and v9.5.0). During the window between 9.4.0 and 9.4.1, customers
using \`data.autocomplete.*\` in \`kibana.yml\` experienced startup
failures.

All three generations of the settings (\`kibana.*\`, \`data.*\`,
\`unifiedSearch.*\`) are explicitly allowlisted in ECH and work for
users on ECH deployments.

## Changes

- **\`docs/reference/configuration-reference/general-settings.yml\`**:
- Marks \`data.autocomplete.valueSuggestions.terminateAfter\` and
\`data.autocomplete.valueSuggestions.timeout\` as \`deprecated 8.3\` on
stack, with \`deprecation_details\` pointing to the \`unifiedSearch.*\`
replacements.
- Adds an inline note on both deprecated settings warning that using
them in Kibana 9.4.0–9.4.1 causes a startup failure, and advising users
to migrate or upgrade.
- Adds \`unifiedSearch.autocomplete.valueSuggestions.timeout\` and
\`unifiedSearch.autocomplete.valueSuggestions.terminateAfter\` as
\`stack: ga 8.3\` entries so the canonical settings are properly
documented.

## Resolves

Closes elastic/docs-content#6511

---

> **AI-assisted draft** — created with Claude Sonnet 4.6 in Cursor.
> Review all generated content for factual accuracy before merging.

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport:version Backport to applied version labels Duty:Core release_note:skip Skip the PR/issue when compiling release notes Team:Core Platform Core services: plugins, logging, config, saved objects, http, ES client, i18n, etc t// Team:Presentation Presentation Team for Dashboard, Input Controls, and Canvas t// v9.4.2 v9.5.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants