View a markdown version of this page

Começando com consultas agendadas - CloudWatch Registros da Amazon

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Começando com consultas agendadas

Ao criar uma consulta agendada, você configurará vários componentes principais que definem como sua consulta é executada e onde os resultados são entregues. Compreender esses componentes ajudará você a configurar uma análise de registros automatizada eficaz.

Cada consulta agendada consiste nos seguintes componentes principais:

Configuração de consulta

A string de consulta do CloudWatch Logs Insights, os grupos de registros de destino e a linguagem de consulta a serem usados na análise.

Expressão de programação

Uma expressão cron ou calendário de frequência que define quando a consulta é executada. Você pode especificar as configurações de fuso horário para garantir que as consultas sejam executadas no horário local correto. O console exibe uma descrição legível por humanos de sua programação, como “Execute a consulta todas as terças-feiras às 15:10 por um intervalo de tempo de 5 minutos, com efeito imediato, no UTC, até indefinidamente”.

Intervalo de tempo

O período de lookback para cada execução de consulta, definido por uma diferença de horário de início em relação ao tempo de execução. Isso determina a quantidade de dados históricos que cada execução de consulta analisará.

Prévia do cronograma de execução

O console mostra as próximas três consultas agendadas com datas e horas exatas (por exemplo, 2025/10 /28 15:10, UTC; 2025/11 /04 15:10, UTC; 2025/11 /11 15:10, UTC), ajudando você a verificar se a programação está configurada corretamente.

Destinos

Onde os resultados da consulta são entregues após a execução bem-sucedida. Os destinos compatíveis incluem buckets do Amazon S3 e, por padrão, os metadados dos resultados são enviados para o barramento de eventos padrão.

Perfil de execução

Uma função do IAM que o CloudWatch Logs presume para executar a consulta e entregar os resultados aos destinos especificados.

Antes de criar consultas agendadas, verifique se você tem as permissões e os recursos necessários configurados.