[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":"lukas@elastic.co"},"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
<lcawley@elastic.co>\r\nCo-authored-by: Florent Le Borgne
<florent.leborgne@elastic.co>","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
<lcawley@elastic.co>\r\nCo-authored-by: Florent Le Borgne
<florent.leborgne@elastic.co>","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
<lcawley@elastic.co>\r\nCo-authored-by: Florent Le Borgne
<florent.leborgne@elastic.co>","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\":\"lukas@elastic.co\"},\"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<lcawley@elastic.co>\\r\\nCo-authored-by: Florent Le
Borgne\n<florent.leborgne@elastic.co>\",\"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<lcawley@elastic.co>\\r\\nCo-authored-by: Florent Le
Borgne\n<florent.leborgne@elastic.co>\",\"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<lcawley@elastic.co>\\r\\nCo-authored-by: Florent Le
Borgne\n<florent.leborgne@elastic.co>\",\"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
<lukas@elastic.co>"}},{"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\":\"lukas@elastic.co\"},\"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<lcawley@elastic.co>\\r\\nCo-authored-by: Florent Le
Borgne\n<florent.leborgne@elastic.co>\",\"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<lcawley@elastic.co>\\r\\nCo-authored-by: Florent Le
Borgne\n<florent.leborgne@elastic.co>\",\"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<lcawley@elastic.co>\\r\\nCo-authored-by: Florent Le
Borgne\n<florent.leborgne@elastic.co>\",\"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\\\":\\\"lukas@elastic.co\\\"},\\\"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<lcawley@elastic.co>\\\\r\\\\nCo-authored-by: Florent
Le\nBorgne\\n<florent.leborgne@elastic.co>\\\",\\\"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<lcawley@elastic.co>\\\\r\\\\nCo-authored-by: Florent
Le\nBorgne\\n<florent.leborgne@elastic.co>\\\",\\\"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<lcawley@elastic.co>\\\\r\\\\nCo-authored-by: Florent
Le\nBorgne\\n<florent.leborgne@elastic.co>\\\",\\\"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<lukas@elastic.co>\"}},{\"branch\":\"8.15\",\"label\":\"v8.15.4\",\"labelRegex\":\"^v(\\\\d+).(\\\\d+).\\\\d+$\",\"isSourceBranch\":false,\"state\":\"NOT_CREATED\"}]}]\nBACKPORT-->\n\nCo-authored-by:
Lukas Olson <lukas@elastic.co>"}}]}] BACKPORT-->

Co-authored-by: Lukas Olson <lukas@elastic.co>

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]