[Alerting V2] Get ES|QL help and recommended queries in the rule query sandbox

Abierto Apto para principiantes
#9,428 1 comentario 1 reacción 1 asignado Ver en GitHub

Los mantenedores suelen responder en 2 días

@nastasha-solomon ya está trabajando en esto.

Desde el 16/11/2026.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
78/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
elasticsearch

Línea de trabajo

Actualiza la sección «Previsualizar los resultados de las consultas en el entorno aislado» de la documentación vinculada de reglas de ES|QL. Describe el menú de ayuda, el panel desplegable de la referencia del lenguaje, las consultas recomendadas y dónde aparecen esas consultas; comprueba la redacción del control dividido y la captura de pantalla con PR #290863. Confirma que el texto cubra la disponibilidad a partir de la versión 9.6.0 y en Serverless, y que el comportamiento documentado coincida con el del entorno aislado.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

alerting-v2 Team:SKI triaged

Summary

The query sandbox used when authoring a Universal Alerting ES|QL rule now has an ES|QL menu in its toolbar. Its help popover links to the ES|QL language reference (opened in a flyout) and lists recommended queries; selecting one replaces the editor content and runs it. Recommended queries are offered in the single editor and on the Base tab in split mode, and are hidden on the other split-mode tabs, which only hold a query fragment. The Discover-style query history and KQL/natural-language search buttons are not part of the sandbox menu, and the Split/Merge control moved out of the editor toolbar into the helper-text row above the editor.

Why this needs docs: New visible control (help menu with one-click recommended queries) in a sandbox the docs already describe control by control; small addition, release note present.

Resources

  • PR #290863 — [Alerting v2] Sandbox ES|QL editor: help/docs menu + recommended queries + gear relocation
Screenshots from PR

screenshot
screenshot

Availability

Channel Details
Stack v9.6.0
Serverless Sep 28–Oct 2
Feature flag None — active by default

Created with Docs Quest Scanner by @nastasha-solomon

Suggested edits

Create an ES|QL rule in Kibana Universal Alerting > Preview query results in the sandbox

  • What the docs say: The query sandbox lets you run your ES|QL query against current data and preview the results before applying them to the rule form. Use the time field selector and date picker to control the time range, then select Search (or press ⌘↵) to execute.
  • What to add: The section walks through the sandbox toolbar (time field selector, date picker, Search, Apply changes) but does not mention the new ES|QL help menu. Add one sentence or bullet: the help (question mark) menu in the sandbox toolbar opens the ES|QL language reference in a flyout and lists recommended queries; selecting a recommended query replaces the editor content and runs it. Recommended queries appear in the single editor and on the Base tab in manual split mode, and are hidden on the other split-mode tabs because those hold only a query fragment. In the same section, re-check the 'Control how your query splits' wording: it refers to 'the toggle in the sandbox', and the PR moves the Split/Merge control from the editor toolbar to the helper-text row above the editor, so confirm the description (and any screenshot) still matches. Applies from 9.6.0 and in serverless.
Lenguaje dominante
Sin datos de lenguaje
Estrellas
50
Forks
269
Merge medio
4 d 4 h
PR fusionados (30 d)
235

Preparar el entorno

  • Sin Dockerfile ni archivo de Docker Compose
  • Tiene una plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de elastic/docs-content

Todos los issues de elastic/docs-content

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.