From c2acf108d698b1ed52baad96a3540e8f72f17e3d Mon Sep 17 00:00:00 2001
From: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
Date: Wed, 3 Jan 2024 11:42:53 -0500
Subject: [PATCH] [8.11] [DOCS] Warn against using ES|QL query rules on
 production environments (#174130) (#174198)

# Backport

This will backport the following commits from `main` to `8.11`:
- [[DOCS] Warn against using ES|QL query rules on production
environments (#174130)](https://github.com/elastic/kibana/pull/174130)

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

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

<!--BACKPORT [{"author":{"name":"Lisa
Cawley","email":"lcawley@elastic.co"},"sourceCommit":{"committedDate":"2024-01-03T16:16:43Z","message":"[DOCS]
Warn against using ES|QL query rules on production environments
(#174130)","sha":"4ff1f5941f163142df29b1827a858996d743a431","branchLabelMapping":{"^v8.13.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["release_note:skip","Team:ResponseOps","docs","Feature:Alerting/RuleTypes","backport:prev-minor","v8.12.1","v8.13.0","v8.11.4"],"title":"[DOCS]
Warn against using ES|QL query rules on production
environments","number":174130,"url":"https://github.com/elastic/kibana/pull/174130","mergeCommit":{"message":"[DOCS]
Warn against using ES|QL query rules on production environments
(#174130)","sha":"4ff1f5941f163142df29b1827a858996d743a431"}},"sourceBranch":"main","suggestedTargetBranches":["8.12","8.11"],"targetPullRequestStates":[{"branch":"8.12","label":"v8.12.1","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"main","label":"v8.13.0","branchLabelMappingKey":"^v8.13.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/174130","number":174130,"mergeCommit":{"message":"[DOCS]
Warn against using ES|QL query rules on production environments
(#174130)","sha":"4ff1f5941f163142df29b1827a858996d743a431"}},{"branch":"8.11","label":"v8.11.4","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->

Co-authored-by: Lisa Cawley <lcawley@elastic.co>
---
 docs/user/alerting/rule-types/es-query.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/user/alerting/rule-types/es-query.asciidoc b/docs/user/alerting/rule-types/es-query.asciidoc
index a95403f2a0329..6aabe3a2c0ff7 100644
--- a/docs/user/alerting/rule-types/es-query.asciidoc
+++ b/docs/user/alerting/rule-types/es-query.asciidoc
@@ -44,7 +44,7 @@ For example:
 If you use {kibana-ref}/kuery-query.html[KQL] or {kibana-ref}/lucene-query.html[Lucene], you must specify a data view then define a text-based query.
 For example, `http.request.referrer: "https://example.com"`.
 
-preview:[] If you use {ref}/esql.html[ES|QL], you must provide a source command followed by an optional series of processing commands, separated by pipe characters (|).
+preview:["Do not use {esql} on production environments. This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features."] If you use {ref}/esql.html[ES|QL], you must provide a source command followed by an optional series of processing commands, separated by pipe characters (|).
 For example:
 
 [source,sh]