[8.x] Add search session deprecation to release notes (#194052) (#196998

)

# Backport

This will backport the following commits from `main` to `8.x`:
- [Add search session deprecation to release notes
(#194052)](#194052)

<!--- Backport version: 8.9.8 -->

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

<!--BACKPORT [{"author":{"name":"Lukas
Olson","email":"[email protected]"},"sourceCommit":{"committedDate":"2024-10-17T18:34:02Z","message":"Add
search session deprecation to release notes (#194052)\n\n##
Summary\r\n\r\nAs part of the Search Session deprecation, we need this
listed in the\r\n8.15.x release
notes.\r\n\r\n---------\r\n\r\nCo-authored-by: Lisa Cawley
<[email protected]>\r\nCo-authored-by: Florent Le Borgne
<[email protected]>","sha":"d23b409ff9fbd87ae70d16cce490cf6bcae1d4e9","branchLabelMapping":{"^v9.0.0$":"main","^v8.17.0$":"8.x","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","v9.0.0","Team:DataDiscovery","Feature:Search
Sessions","v8.16.0","backport:version","v8.17.0","v8.15.4"],"number":194052,"url":"https://github.com/elastic/kibana/pull/194052","mergeCommit":{"message":"Add
search session deprecation to release notes (#194052)\n\n##
Summary\r\n\r\nAs part of the Search Session deprecation, we need this
listed in the\r\n8.15.x release
notes.\r\n\r\n---------\r\n\r\nCo-authored-by: Lisa Cawley
<[email protected]>\r\nCo-authored-by: Florent Le Borgne
<[email protected]>","sha":"d23b409ff9fbd87ae70d16cce490cf6bcae1d4e9"}},"sourceBranch":"main","suggestedTargetBranches":["8.x"],"targetPullRequestStates":[{"branch":"main","label":"v9.0.0","labelRegex":"^v9.0.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/194052","number":194052,"mergeCommit":{"message":"Add
search session deprecation to release notes (#194052)\n\n##
Summary\r\n\r\nAs part of the Search Session deprecation, we need this
listed in the\r\n8.15.x release
notes.\r\n\r\n---------\r\n\r\nCo-authored-by: Lisa Cawley
<[email protected]>\r\nCo-authored-by: Florent Le Borgne
<[email protected]>","sha":"d23b409ff9fbd87ae70d16cce490cf6bcae1d4e9"}},{"branch":"8.16","label":"v8.16.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"url":"https://github.com/elastic/kibana/pull/196760","number":196760,"state":"MERGED","mergeCommit":{"sha":"95ae64bb3d3bc502db27ce896606469fbe257238","message":"[8.16]
Add search session deprecation to release notes (#194052) (#196760)\n\n#
Backport\n\nThis will backport the following commits from `main` to
`8.16`:\n- [Add search session deprecation to release
notes\n(#194052)](https://github.com/elastic/kibana/pull/194052)\n\n<!---
Backport version: 9.4.3 -->\n\n### Questions ?\nPlease refer to the
[Backport
tool\ndocumentation](https://github.com/sqren/backport)\n\n<!--BACKPORT
[{\"author\":{\"name\":\"Lukas\nOlson\",\"email\":\"[email protected]\"},\"sourceCommit\":{\"committedDate\":\"2024-10-17T18:34:02Z\",\"message\":\"Add\nsearch
session deprecation to release notes
(#194052)\\n\\n##\nSummary\\r\\n\\r\\nAs part of the Search Session
deprecation, we need this\nlisted in the\\r\\n8.15.x
release\nnotes.\\r\\n\\r\\n---------\\r\\n\\r\\nCo-authored-by: Lisa
Cawley\n<[email protected]>\\r\\nCo-authored-by: Florent Le
Borgne\n<[email protected]>\",\"sha\":\"d23b409ff9fbd87ae70d16cce490cf6bcae1d4e9\",\"branchLabelMapping\":{\"^v9.0.0$\":\"main\",\"^v8.17.0$\":\"8.x\",\"^v(\\\\d+).(\\\\d+).\\\\d+$\":\"$1.$2\"}},\"sourcePullRequest\":{\"labels\":[\"Team:Docs\",\"release_note:skip\",\"v9.0.0\",\"Team:DataDiscovery\",\"Feature:Search\nSessions\",\"v8.16.0\",\"backport:version\",\"v8.15.4\"],\"title\":\"Add
search\nsession deprecation to
release\nnotes\",\"number\":194052,\"url\":\"https://github.com/elastic/kibana/pull/194052\",\"mergeCommit\":{\"message\":\"Add\nsearch
session deprecation to release notes
(#194052)\\n\\n##\nSummary\\r\\n\\r\\nAs part of the Search Session
deprecation, we need this\nlisted in the\\r\\n8.15.x
release\nnotes.\\r\\n\\r\\n---------\\r\\n\\r\\nCo-authored-by: Lisa
Cawley\n<[email protected]>\\r\\nCo-authored-by: Florent Le
Borgne\n<[email protected]>\",\"sha\":\"d23b409ff9fbd87ae70d16cce490cf6bcae1d4e9\"}},\"sourceBranch\":\"main\",\"suggestedTargetBranches\":[\"8.16\",\"8.15\"],\"targetPullRequestStates\":[{\"branch\":\"main\",\"label\":\"v9.0.0\",\"branchLabelMappingKey\":\"^v9.0.0$\",\"isSourceBranch\":true,\"state\":\"MERGED\",\"url\":\"https://github.com/elastic/kibana/pull/194052\",\"number\":194052,\"mergeCommit\":{\"message\":\"Add\nsearch
session deprecation to release notes
(#194052)\\n\\n##\nSummary\\r\\n\\r\\nAs part of the Search Session
deprecation, we need this\nlisted in the\\r\\n8.15.x
release\nnotes.\\r\\n\\r\\n---------\\r\\n\\r\\nCo-authored-by: Lisa
Cawley\n<[email protected]>\\r\\nCo-authored-by: Florent Le
Borgne\n<[email protected]>\",\"sha\":\"d23b409ff9fbd87ae70d16cce490cf6bcae1d4e9\"}},{\"branch\":\"8.16\",\"label\":\"v8.16.0\",\"branchLabelMappingKey\":\"^v(\\\\d+).(\\\\d+).\\\\d+$\",\"isSourceBranch\":false,\"state\":\"NOT_CREATED\"},{\"branch\":\"8.15\",\"label\":\"v8.15.4\",\"branchLabelMappingKey\":\"^v(\\\\d+).(\\\\d+).\\\\d+$\",\"isSourceBranch\":false,\"state\":\"NOT_CREATED\"}]}]\nBACKPORT-->\n\nCo-authored-by:
Lukas Olson
<[email protected]>"}},{"branch":"8.x","label":"v8.17.0","labelRegex":"^v8.17.0$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.15","label":"v8.15.4","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"url":"https://github.com/elastic/kibana/pull/196807","number":196807,"state":"MERGED","mergeCommit":{"sha":"175c1d0c02cd337017b2019a9d535fd02c9d0b8e","message":"[8.15]
Add search session deprecation to release notes (#194052) (#196807)\n\n#
Backport\n\nThis will backport the following commits from `main` to
`8.15`:\n- [Add search session deprecation to release
notes\n(#194052)](https://github.com/elastic/kibana/pull/194052)\n\n<!---
Backport version: 8.9.8 -->\n\n### Questions ?\nPlease refer to the
[Backport
tool\ndocumentation](https://github.com/sqren/backport)\n\n<!--BACKPORT
[{\"author\":{\"name\":\"Lukas\nOlson\",\"email\":\"[email protected]\"},\"sourceCommit\":{\"committedDate\":\"2024-10-17T18:34:02Z\",\"message\":\"Add\nsearch
session deprecation to release notes
(#194052)\\n\\n##\nSummary\\r\\n\\r\\nAs part of the Search Session
deprecation, we need this\nlisted in the\\r\\n8.15.x
release\nnotes.\\r\\n\\r\\n---------\\r\\n\\r\\nCo-authored-by: Lisa
Cawley\n<[email protected]>\\r\\nCo-authored-by: Florent Le
Borgne\n<[email protected]>\",\"sha\":\"d23b409ff9fbd87ae70d16cce490cf6bcae1d4e9\",\"branchLabelMapping\":{\"^v9.0.0$\":\"main\",\"^v8.17.0$\":\"8.x\",\"^v(\\\\d+).(\\\\d+).\\\\d+$\":\"$1.$2\"}},\"sourcePullRequest\":{\"labels\":[\"Team:Docs\",\"release_note:skip\",\"v9.0.0\",\"Team:DataDiscovery\",\"Feature:Search\nSessions\",\"v8.16.0\",\"backport:version\",\"v8.15.4\"],\"number\":194052,\"url\":\"https://github.com/elastic/kibana/pull/194052\",\"mergeCommit\":{\"message\":\"Add\nsearch
session deprecation to release notes
(#194052)\\n\\n##\nSummary\\r\\n\\r\\nAs part of the Search Session
deprecation, we need this\nlisted in the\\r\\n8.15.x
release\nnotes.\\r\\n\\r\\n---------\\r\\n\\r\\nCo-authored-by: Lisa
Cawley\n<[email protected]>\\r\\nCo-authored-by: Florent Le
Borgne\n<[email protected]>\",\"sha\":\"d23b409ff9fbd87ae70d16cce490cf6bcae1d4e9\"}},\"sourceBranch\":\"main\",\"suggestedTargetBranches\":[\"8.15\"],\"targetPullRequestStates\":[{\"branch\":\"main\",\"label\":\"v9.0.0\",\"labelRegex\":\"^v9.0.0$\",\"isSourceBranch\":true,\"state\":\"MERGED\",\"url\":\"https://github.com/elastic/kibana/pull/194052\",\"number\":194052,\"mergeCommit\":{\"message\":\"Add\nsearch
session deprecation to release notes
(#194052)\\n\\n##\nSummary\\r\\n\\r\\nAs part of the Search Session
deprecation, we need this\nlisted in the\\r\\n8.15.x
release\nnotes.\\r\\n\\r\\n---------\\r\\n\\r\\nCo-authored-by: Lisa
Cawley\n<[email protected]>\\r\\nCo-authored-by: Florent Le
Borgne\n<[email protected]>\",\"sha\":\"d23b409ff9fbd87ae70d16cce490cf6bcae1d4e9\"}},{\"branch\":\"8.16\",\"label\":\"v8.16.0\",\"labelRegex\":\"^v(\\\\d+).(\\\\d+).\\\\d+$\",\"isSourceBranch\":false,\"url\":\"https://github.com/elastic/kibana/pull/196760\",\"number\":196760,\"state\":\"MERGED\",\"mergeCommit\":{\"sha\":\"95ae64bb3d3bc502db27ce896606469fbe257238\",\"message\":\"[8.16]\nAdd
search session deprecation to release notes (#194052)
(#196760)\\n\\n#\nBackport\\n\\nThis will backport the following commits
from `main` to\n`8.16`:\\n- [Add search session deprecation to
release\nnotes\\n(#194052)](https://github.com/elastic/kibana/pull/194052)\\n\\n<!---\nBackport
version: 9.4.3 -->\\n\\n### Questions ?\\nPlease refer to
the\n[Backport\ntool\\ndocumentation](https://github.com/sqren/backport)\\n\\n<!--BACKPORT\n[{\\\"author\\\":{\\\"name\\\":\\\"Lukas\\nOlson\\\",\\\"email\\\":\\\"[email protected]\\\"},\\\"sourceCommit\\\":{\\\"committedDate\\\":\\\"2024-10-17T18:34:02Z\\\",\\\"message\\\":\\\"Add\\nsearch\nsession
deprecation to release
notes\n(#194052)\\\\n\\\\n##\\nSummary\\\\r\\\\n\\\\r\\\\nAs part of the
Search Session\ndeprecation, we need this\\nlisted in
the\\\\r\\\\n8.15.x\nrelease\\nnotes.\\\\r\\\\n\\\\r\\\\n---------\\\\r\\\\n\\\\r\\\\nCo-authored-by:
Lisa\nCawley\\n<[email protected]>\\\\r\\\\nCo-authored-by: Florent
Le\nBorgne\\n<[email protected]>\\\",\\\"sha\\\":\\\"d23b409ff9fbd87ae70d16cce490cf6bcae1d4e9\\\",\\\"branchLabelMapping\\\":{\\\"^v9.0.0$\\\":\\\"main\\\",\\\"^v8.17.0$\\\":\\\"8.x\\\",\\\"^v(\\\\\\\\d+).(\\\\\\\\d+).\\\\\\\\d+$\\\":\\\"$1.$2\\\"}},\\\"sourcePullRequest\\\":{\\\"labels\\\":[\\\"Team:Docs\\\",\\\"release_note:skip\\\",\\\"v9.0.0\\\",\\\"Team:DataDiscovery\\\",\\\"Feature:Search\\nSessions\\\",\\\"v8.16.0\\\",\\\"backport:version\\\",\\\"v8.15.4\\\"],\\\"title\\\":\\\"Add\nsearch\\nsession
deprecation
to\nrelease\\nnotes\\\",\\\"number\\\":194052,\\\"url\\\":\\\"https://github.com/elastic/kibana/pull/194052\\\",\\\"mergeCommit\\\":{\\\"message\\\":\\\"Add\\nsearch\nsession
deprecation to release
notes\n(#194052)\\\\n\\\\n##\\nSummary\\\\r\\\\n\\\\r\\\\nAs part of the
Search Session\ndeprecation, we need this\\nlisted in
the\\\\r\\\\n8.15.x\nrelease\\nnotes.\\\\r\\\\n\\\\r\\\\n---------\\\\r\\\\n\\\\r\\\\nCo-authored-by:
Lisa\nCawley\\n<[email protected]>\\\\r\\\\nCo-authored-by: Florent
Le\nBorgne\\n<[email protected]>\\\",\\\"sha\\\":\\\"d23b409ff9fbd87ae70d16cce490cf6bcae1d4e9\\\"}},\\\"sourceBranch\\\":\\\"main\\\",\\\"suggestedTargetBranches\\\":[\\\"8.16\\\",\\\"8.15\\\"],\\\"targetPullRequestStates\\\":[{\\\"branch\\\":\\\"main\\\",\\\"label\\\":\\\"v9.0.0\\\",\\\"branchLabelMappingKey\\\":\\\"^v9.0.0$\\\",\\\"isSourceBranch\\\":true,\\\"state\\\":\\\"MERGED\\\",\\\"url\\\":\\\"https://github.com/elastic/kibana/pull/194052\\\",\\\"number\\\":194052,\\\"mergeCommit\\\":{\\\"message\\\":\\\"Add\\nsearch\nsession
deprecation to release
notes\n(#194052)\\\\n\\\\n##\\nSummary\\\\r\\\\n\\\\r\\\\nAs part of the
Search Session\ndeprecation, we need this\\nlisted in
the\\\\r\\\\n8.15.x\nrelease\\nnotes.\\\\r\\\\n\\\\r\\\\n---------\\\\r\\\\n\\\\r\\\\nCo-authored-by:
Lisa\nCawley\\n<[email protected]>\\\\r\\\\nCo-authored-by: Florent
Le\nBorgne\\n<[email protected]>\\\",\\\"sha\\\":\\\"d23b409ff9fbd87ae70d16cce490cf6bcae1d4e9\\\"}},{\\\"branch\\\":\\\"8.16\\\",\\\"label\\\":\\\"v8.16.0\\\",\\\"branchLabelMappingKey\\\":\\\"^v(\\\\\\\\d+).(\\\\\\\\d+).\\\\\\\\d+$\\\",\\\"isSourceBranch\\\":false,\\\"state\\\":\\\"NOT_CREATED\\\"},{\\\"branch\\\":\\\"8.15\\\",\\\"label\\\":\\\"v8.15.4\\\",\\\"branchLabelMappingKey\\\":\\\"^v(\\\\\\\\d+).(\\\\\\\\d+).\\\\\\\\d+$\\\",\\\"isSourceBranch\\\":false,\\\"state\\\":\\\"NOT_CREATED\\\"}]}]\\nBACKPORT-->\\n\\nCo-authored-by:\nLukas
Olson\n<[email protected]>\"}},{\"branch\":\"8.15\",\"label\":\"v8.15.4\",\"labelRegex\":\"^v(\\\\d+).(\\\\d+).\\\\d+$\",\"isSourceBranch\":false,\"state\":\"NOT_CREATED\"}]}]\nBACKPORT-->\n\nCo-authored-by:
Lukas Olson <[email protected]>"}}]}] BACKPORT-->

Co-authored-by: Lukas Olson <[email protected]>

docs/CHANGELOG.asciidoc

@@ -237,6 +237,14 @@ you make the necessary updates after you upgrade to 8.15.0.
 The Uptime app is already hidden from Kibana when there is no recent Heartbeat data, but will be completely removed in 9.0.0. You should migrate to Synthetics as an alternative. For more details, refer to the {observability-guide}/uptime-intro.html[Uptime documentation].
 ====
 
+[discrete]
+.<<search-sessions,Search sessions>> are deprecated in 8.15.0 and will be removed in a future version.
+[%collapsible]
+====
+*Details* +
+Search sessions are now deprecated and will be removed in a future version. By default, queries that take longer than 10 minutes (the default for the advanced setting `search:timeout`) will be canceled. To allow queries to run longer, consider increasing `search:timeout` or setting it to `0` which will allow queries to continue running as long as a user is waiting on-screen for results.
+====
+
 [float]
 [[breaking-changes-8.15.0]]
 === Breaking changes

docs/upgrade-notes.asciidoc

@@ -1481,6 +1481,18 @@ The following rule action variables have been deprecated. Use the recommended va
 For more information, refer to ({kibana-pull}161136[#161136]).
 ====
 
+// Discover
+
+[discrete]
+[[deprecation-search-sessions]]
+.[Discover] <<search-sessions,Search sessions>> are deprecated in 8.15.0 and will be removed in a future version. (8.15)
+[%collapsible]
+====
+*Details* +
+Search sessions are now deprecated and will be removed in a future version. By default, queries that take longer than 10 minutes (the default for the advanced setting `search:timeout`) will be canceled. To allow queries to run longer, consider increasing `search:timeout` or setting it to `0` which will allow queries to continue running as long as a user is waiting on-screen for results.
+====
+
+
 // General settings
 
 [discrete]