Tutorial: Executar uma consulta com uma função de agregação

PDFRSS

Você pode usar funções de agregação no comando stats e como argumentos de outras funções. Neste tutorial, você executará um comando de consulta que conta o número de eventos de log contendo um campo especificado. O comando de consulta retorna uma contagem total agrupada pelo valor ou valores do campo especificado. Para obter mais informações sobre funções de agregação, consulte Operações e funções suportadas no Guia do usuário do Amazon CloudWatch Logs.

Executar uma consulta com uma função de agregação

1. Abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. No painel de navegação à esquerda, escolha Logs e, em seguida, escolha Log Insights(Insights de log).

3. Confirme se a guia Logs Insights QL está selecionada.

4. No menu suspenso Select log group(s) (Selecione grupo(s) de logs), escolha um ou mais grupos de logs a serem consultados.

   Se for uma conta de monitoramento na observabilidade CloudWatch entre contas, você poderá selecionar grupos de registros nas contas de origem e na conta de monitoramento. Uma única consulta pode consultar logs de diferentes contas ao mesmo tempo.

   Você pode filtrar os grupos de log por nome de grupo de log, ID de conta ou rótulo de conta.

   Quando você seleciona um grupo de CloudWatch registros, o Logs Insights detecta automaticamente os campos de dados no grupo de registros se for um grupo de registros de classe padrão. Para ver esses campos descobertos, selecione o menu Fields (Campos) próximo ao canto superior direito da página.

5. Exclua a consulta padrão no editor de consultas e insira o seguinte comando:

   stats count(*) by fieldName

6. fieldNameSubstitua por um campo descoberto no menu Campos.

   O menu Campos está localizado no canto superior direito da página e exibe todos os campos descobertos que o CloudWatch Logs Insights detecta em seu grupo de registros.

7. Selecione Run (Executar) para visualizar os resultados da consulta.

   Os resultados da consulta mostram o número de registros no grupo de logs que correspondem ao comando de consulta e a contagem total agrupada pelo valor ou valores do campo especificado.