From 175c1d0c02cd337017b2019a9d535fd02c9d0b8e Mon Sep 17 00:00:00 2001
From: florent-leborgne <florent.leborgne@elastic.co>
Date: Fri, 18 Oct 2024 10:20:37 +0200
Subject: [PATCH] [8.15] Add search session deprecation to release notes
 (#194052) (#196807)

# Backport

This will backport the following commits from `main` to `8.15`:
- [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.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.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
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.15","label":"v8.15.4","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->

Co-authored-by: Lukas Olson <lukas@elastic.co>
---
 docs/CHANGELOG.asciidoc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/CHANGELOG.asciidoc b/docs/CHANGELOG.asciidoc
index 9e4aca8ce5504..2e15de535f336 100644
--- a/docs/CHANGELOG.asciidoc
+++ b/docs/CHANGELOG.asciidoc
@@ -273,6 +273,15 @@ 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, and will be completely removed in early 2026. You should migrate to Synthetics as an alternative. For more details, refer to the {observability-guide}/uptime-intro.html[Uptime documentation].
 ====
 
+[discrete]
+[[deprecation-search-sessions]]
+.<<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