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á.
Tutorial: executar e modificar um exemplo de consulta
O tutorial a seguir ajuda você a começar a usar o CloudWatch Logs Insights. Você executa uma consulta de amostra e vê como modificar e reexecutá-la.
Para executar uma consulta, você já deve ter registros armazenados em CloudWatch Registros. Se você já usa o CloudWatch Logs e tem grupos e fluxos de registros configurados, você está pronto para começar. Você também pode já ter registros se usar serviços como AWS CloudTrailAmazon Route 53 ou Amazon VPC e tiver configurado os registros desses serviços para CloudWatch acessar Logs. Para obter mais informações sobre o envio de registros para o CloudWatch Logs, consulteIntrodução ao CloudWatch Logs.
As consultas no CloudWatch Logs Insights retornam um conjunto de campos de eventos de log ou o resultado de uma agregação matemática ou outra operação realizada em eventos de log. Este tutorial demonstra uma consulta que retorna uma lista de eventos de log.
Executar um exemplo de consulta
Para executar uma consulta de amostra do CloudWatch Logs Insights
Abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/
. No painel de navegação à esquerda, escolha Logs e, em seguida, escolha Log Insights(Insights de log).
Na página Logs Insights (Insights de log), o editor de consultas contém uma consulta padrão que retorna os 20 eventos de log mais recentes.
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. Para ver esses campos descobertos, selecione o menu Fields (Campos) próximo ao canto superior direito da página.
(Opcional) Use o seletor de tempo para selecionar o período que você deseja consultar.
Você pode escolher intervalos de 5 a 30 minutos, intervalos de 1, 3 e 12 horas ou um período personalizado.
-
Selecione Run (Executar) para visualizar os resultados.
Para este tutorial, os resultados incluem os 20 eventos de log adicionados mais recentemente.
CloudWatch Os registros exibem um gráfico de barras dos eventos de registro no grupo de registros ao longo do tempo. O gráfico de barras mostra não apenas os eventos na tabela. mas também a distribuição de eventos no grupo de logs correspondente à consulta e ao intervalo de tempo.
Para ver todos os campos de um evento de log retornado, escolha o ícone suspenso triangular à esquerda do evento numerado.
Modificar o exemplo de consulta
Neste tutorial, você modifica a consulta de amostra para mostrar os 50 eventos de log mais recentes.
Se você ainda não tiver executado o tutorial anterior, faça isso agora. Este tutorial começa onde esse tutorial anterior termina.
nota
Alguns exemplos de consultas fornecidos com o CloudWatch Logs Insights usam tail comandos head ou em vez delimit. Esses comandos estão defasados e foram substituídos por limit. Use limit em vez de head ou tail em todas as consultas que você gravar.
Para modificar a consulta de amostra do CloudWatch Logs Insights
No editor de consultas, altere 20 para 50, e escolha Executar.
Os resultados da nova consulta são exibidos. Pressupondo-se que haja dados suficientes no grupo de logs no intervalo de tempo padrão, agora há 50 eventos de log listados.
(Opcional) Você pode salvar consultas que você criou. Para salvar essa consulta, escolha Salvar. Para obter mais informações, consulte Salve e execute novamente as consultas do CloudWatch Logs Insights.
Adicionar um comando de filtro ao exemplo de consulta
Este tutorial mostra como fazer uma alteração mais eficiente na consulta no editor. Neste tutorial, filtre os resultados da consulta anterior com base em um campo nos eventos de log recuperados.
Se você ainda não tiver executado os tutoriais anteriores, faça isso agora. Este tutorial começa onde esse tutorial anterior termina.
Para adicionar um comando de filtro à consulta anterior
Decida um campo a ser filtrado. Para ver os campos mais comuns que o CloudWatch Logs detectou nos eventos de log contidos nos grupos de log selecionados nos últimos 15 minutos e a porcentagem desses eventos de log nos quais cada campo aparece, selecione Campos no lado direito da página.
Para ver os campos contidos em um determinado evento de log, escolha o ícone à esquerda dessa linha.
O campo awsRegion pode ser exibido no evento de log, dependendo de quais eventos estão nos logs. No restante deste tutorial, usamos awsRegion como o campo de filtro, mas você pode usar um campo diferente caso esse campo não esteja disponível.
Na caixa do editor de consultas, coloque o cursor após 50 e pressione Enter.
Na nova linha, digite primeiro | (o caractere de barra vertical) e um espaço. Os comandos em uma consulta do CloudWatch Logs Insights devem ser separados pelo caractere de barra vertical.
Insira
filter awsRegion="us-east-1".Escolha Executar.
A consulta é reexecutada e agora exibe os 50 resultados mais recentes correspondentes ao novo filtro.
Se tiver filtrado em um campo diferente e obtido um resultado de erro, você poderá precisar inserir caracteres de escape no nome do campo. Se o nome do campo incluir caracteres não alfanuméricos, você deverá inserir caracteres de apóstrofo (`) antes e depois do nome do campo (por exemplo,
`error-code`="102").Você deve usar os caracteres de apóstrofo para nomes de campo que contenham caracteres não alfanuméricos, mas não para valores. Os valores estão sempre entre aspas (").
CloudWatch O Logs Insights inclui poderosos recursos de consulta, incluindo vários comandos e suporte para expressões regulares, operações matemáticas e estatísticas. Para ter mais informações, consulte CloudWatch Sintaxe de consulta do Logs Insights.
