From 43135b2a93c427d2b9e7511cc3c92d23c2770e45 Mon Sep 17 00:00:00 2001
From: florent-leborgne <florent.leborgne@elastic.co>
Date: Mon, 21 Oct 2024 10:03:30 +0200
Subject: [PATCH] [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)](https://github.com/elastic/kibana/pull/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     |  8 ++++++++
 docs/upgrade-notes.asciidoc | 12 ++++++++++++
 2 files changed, 20 insertions(+)

diff --git a/docs/CHANGELOG.asciidoc b/docs/CHANGELOG.asciidoc
index cfc4c0564962b..c5132fe51a678 100644
--- a/docs/CHANGELOG.asciidoc
+++ b/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
diff --git a/docs/upgrade-notes.asciidoc b/docs/upgrade-notes.asciidoc
index 57b97856a3d40..43fb4d5ac66e5 100644
--- a/docs/upgrade-notes.asciidoc
+++ b/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]