

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Cómo empezar con las consultas programadas
<a name="scheduled-queries-getting-started"></a>

Al crear una consulta programada, configurará varios componentes clave que definen cómo se ejecuta la consulta y dónde se entregan los resultados. La comprensión de estos componentes le ayudará a configurar un análisis de registros automatizado y efectivo.

Cada consulta programada consta de los siguientes componentes clave:

**Configuración de la consulta**  
La cadena de consulta de CloudWatch Logs Insights, los grupos de registros de destino y el lenguaje de consulta que se van a utilizar para el análisis.

**Expresión de programación**  
Una expresión cron o un calendario de frecuencias que define cuándo se ejecuta la consulta. Puede especificar la configuración de la zona horaria para garantizar que las consultas se ejecuten en la hora local correcta. La consola muestra una descripción legible de tu agenda, por ejemplo: «Ejecuta la consulta todos los martes a las 15:10 durante un intervalo de tiempo de 5 minutos, con efecto inmediato, en UTC, hasta indefinidamente».

**Intervalo de tiempo**  
El período retrospectivo para la ejecución de cada consulta, definido por una diferencia entre la hora de inicio y la hora de ejecución. Esto determina la cantidad de datos históricos que analizará cada ejecución de consulta.

**Vista previa del programa de ejecución**  
La consola muestra las siguientes tres consultas programadas con fechas y horas exactas (por ejemplo, 2025/10 /28 15:10, UTC; 2025/11 /04 15:10, UTC; 2025/11 /11 15:10, UTC), lo que le ayuda a comprobar que la programación está configurada correctamente.

**Destinos**  
Donde se entregan los resultados de la consulta después de una ejecución correcta. Los destinos compatibles incluyen los buckets de Amazon S3 y, de forma predeterminada, los metadatos de los resultados se envían al bus de eventos predeterminado.

**Rol de ejecución**  
Función de IAM que CloudWatch Logs asume para ejecutar la consulta y entregar los resultados a los destinos especificados.

Antes de crear consultas programadas, asegúrese de tener configurados los permisos y recursos necesarios.