From 19cedd80ebfac101e1f18afe2389e425f1744374 Mon Sep 17 00:00:00 2001
From: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
Date: Fri, 13 Sep 2024 07:03:59 +1000
Subject: [PATCH] [8.12] Deprecate search session documentation (#192224)
 (#192770)

# Backport

This will backport the following commits from `main` to `8.12`:
- [Deprecate search session documentation
(#192224)](https://github.com/elastic/kibana/pull/192224)

<!--- Backport version: 9.4.3 -->

### 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-09-12T20:35:55Z","message":"Deprecate
search session documentation (#192224)\n\n## Summary\r\n\r\nResolves
https://github.com/elastic/kibana/issues/186334.\r\n(See
https://github.com/elastic/kibana/issues/187923
and\r\nhttps://github.com/elastic/kibana/pull/188037.)\r\n\r\nUpdates
the documentation to have a message that search sessions
are\r\ndeprecated and will be
removed.","sha":"040714c2b7b412be2d833540da95eec9462119fa","branchLabelMapping":{"^v8.16.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","docs","Team:DataDiscovery","v8.0.2","v8.1.4","v8.2.4","v8.3.4","v8.4.4","v8.5.4","v8.6.3","v8.7.2","v8.8.3","v8.9.3","v8.10.5","v8.11.5","v8.12.3","v8.15.0","v8.13.5","v8.16.0","v8.14.4","v7.17.24","backport:version"],"title":"Deprecate
search session
documentation","number":192224,"url":"https://github.com/elastic/kibana/pull/192224","mergeCommit":{"message":"Deprecate
search session documentation (#192224)\n\n## Summary\r\n\r\nResolves
https://github.com/elastic/kibana/issues/186334.\r\n(See
https://github.com/elastic/kibana/issues/187923
and\r\nhttps://github.com/elastic/kibana/pull/188037.)\r\n\r\nUpdates
the documentation to have a message that search sessions
are\r\ndeprecated and will be
removed.","sha":"040714c2b7b412be2d833540da95eec9462119fa"}},"sourceBranch":"main","suggestedTargetBranches":["8.0","8.1","8.2","8.3","8.4","8.5","8.6","8.7","8.8","8.9","8.10","8.11","8.12","8.15","8.13","8.14","7.17"],"targetPullRequestStates":[{"branch":"8.0","label":"v8.0.2","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.1","label":"v8.1.4","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.2","label":"v8.2.4","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.3","label":"v8.3.4","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.4","label":"v8.4.4","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.5","label":"v8.5.4","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.6","label":"v8.6.3","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.7","label":"v8.7.2","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.8","label":"v8.8.3","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.9","label":"v8.9.3","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.10","label":"v8.10.5","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.11","label":"v8.11.5","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.12","label":"v8.12.3","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.15","label":"v8.15.0","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.13","label":"v8.13.5","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"main","label":"v8.16.0","branchLabelMappingKey":"^v8.16.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/192224","number":192224,"mergeCommit":{"message":"Deprecate
search session documentation (#192224)\n\n## Summary\r\n\r\nResolves
https://github.com/elastic/kibana/issues/186334.\r\n(See
https://github.com/elastic/kibana/issues/187923
and\r\nhttps://github.com/elastic/kibana/pull/188037.)\r\n\r\nUpdates
the documentation to have a message that search sessions
are\r\ndeprecated and will be
removed.","sha":"040714c2b7b412be2d833540da95eec9462119fa"}},{"branch":"8.14","label":"v8.14.4","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"7.17","label":"v7.17.24","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->

Co-authored-by: Lukas Olson <lukas@elastic.co>
---
 docs/discover/search-sessions.asciidoc          |  2 ++
 docs/management/advanced-options.asciidoc       |  4 ++--
 docs/settings/search-sessions-settings.asciidoc | 14 ++++++--------
 3 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/discover/search-sessions.asciidoc b/docs/discover/search-sessions.asciidoc
index 663c4231c07187..e7d7466b5ae0c9 100644
--- a/docs/discover/search-sessions.asciidoc
+++ b/docs/discover/search-sessions.asciidoc
@@ -1,6 +1,8 @@
 [[search-sessions]]
 == Run a search session in the background
 
+deprecated::[8.15.0,Search Sessions are deprecated and will be removed in a future version.]
+
 Sometimes you might need to search through large amounts of data, no matter
 how long the search takes.
 Consider a threat hunting scenario, where you need to search through years of data.
diff --git a/docs/management/advanced-options.asciidoc b/docs/management/advanced-options.asciidoc
index c0307253a72086..bb5c335d219f15 100644
--- a/docs/management/advanced-options.asciidoc
+++ b/docs/management/advanced-options.asciidoc
@@ -509,8 +509,8 @@ Includes {ref}/frozen-indices.html[frozen indices] in results. Searching through
 frozen indices might increase the search time. This setting is off by default.
 Users must opt-in to include frozen indices.
 
-[[search-timeout]]`search:timeout`:: Change the maximum timeout, in milliseconds (ms), for a search
-session. To disable the timeout and allow queries to run to completion, set to 0. The default is 600,000 ms, or 10 minutes.
+[[search-timeout]]`search:timeout`:: Change the maximum timeout, in milliseconds (ms), for search requests. To disable
+the timeout and allow queries to run to completion, set to 0. The default is `600000`, or 10 minutes.
 
 [float]
 [[kibana-siem-settings]]
diff --git a/docs/settings/search-sessions-settings.asciidoc b/docs/settings/search-sessions-settings.asciidoc
index 2862dec25b8812..01898549189b78 100644
--- a/docs/settings/search-sessions-settings.asciidoc
+++ b/docs/settings/search-sessions-settings.asciidoc
@@ -5,22 +5,20 @@
 <titleabbrev>Search sessions settings</titleabbrev>
 ++++
 
+deprecated::[8.15.0,Search Sessions are deprecated and will be removed in a future version.]
+
 Configure the search session settings in your `kibana.yml` configuration file.
 
-`data.search.sessions.enabled` {ess-icon}::
+deprecated:[8.15.0] `data.search.sessions.enabled` {ess-icon}::
 Set to `true` (default) to enable search sessions.
 
-`data.search.sessions.pageSize` {ess-icon}::
-How many search sessions {kib} processes at once while monitoring
-session progress. The default is `100`.
-
-`data.search.sessions.notTouchedTimeout` {ess-icon}::
+deprecated:[8.15.0] `data.search.sessions.notTouchedTimeout` {ess-icon}::
 How long {kib} stores search results from unsaved sessions,
 after the last search in the session completes. The default is `5m`.
 
-`data.search.sessions.maxUpdateRetries` {ess-icon}::
+deprecated:[8.15.0] `data.search.sessions.maxUpdateRetries` {ess-icon}::
 How many retries {kib} can perform while attempting to save a search session. The default is `10`.
 
-`data.search.sessions.defaultExpiration` {ess-icon}::
+deprecated:[8.15.0] `data.search.sessions.defaultExpiration` {ess-icon}::
 How long search session results are stored before they are deleted.
 Extending a search session resets the expiration by the same value. The default is `7d`.