Como posso recuperar dados de log do CloudWatch Logs?

Resolução

Observação: se você receber mensagens de erro ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Solução de problemas da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

Para recuperar seus dados de log do CloudWatch Logs, use as seguintes práticas recomendadas.

Transmita dados de log com filtros de assinatura

Para recuperar seus dados de log do CloudWatch Logs em tempo real, use filtros de assinatura. Filtros de assinatura de dados de log evitam o controle de utilização de APIs do CloudWatch. Para obter mais informações, consulte Processamento em tempo real de dados de log com assinaturas e Filtros de assinatura ao nível do grupo de logs.

Observação: o Amazon Kinesis Data Streams repete automaticamente as APIs de serviço controladas.

Use APIs do CloudWatch

Para localizar manualmente seus dados de log, use as operações de API GetLogEvents ou FilterLogEvents do CloudWatch. Não é possível escalar essas operações de API devido à cota de transações por segundo (TPS). A operação de API GetLogEvents pode retornar resultados vazios quando há mais eventos de logs disponíveis por meio do token. Para as cotas atuais, consulte CloudWatch Logs quotas (Cotas do CloudWatch Logs). Em caso de controle de utilização de APIs, use filtros de assinatura.

Execute uma consulta do CloudWatch Logs Insights

Para pesquisar e analisar seus dados de log, execute uma consulta no CloudWatch Logs Insights. Consultas te ajudam a responder a problemas e identificar causas para uma solução de problemas adicional. Para obter mais informações, consulte Análise de dados de log com o CloudWatch Logs Insights.

Exporte dados de log para o Amazon S3

É possível exportar dados do CloudWatch Logs para o Amazon S3 em casos de uso em lote. A exportação de dados de log pode levar até 12 horas para ser disponibilizada no CloudWatch Logs. Para análise e processamento em tempo real, use filtros de assinatura.

Observação: uma conta da AWS pode ter somente uma tarefa de exportação para dados de log no estado PENDENTE, PENDENTE_CANCELAR ou EM EXECUÇÃO.

Baixe logs em um arquivo.csv

É possível usar o console do CloudWatch, a AWS CLI ou o CloudWatch Logs Insights para recuperar seus dados de log.Use o console do CloudWatch

Conclua as etapas a seguir:

1. Abra o Console do CloudWatch.
2. Selecione seu grupo de logs.
3. Selecione o fluxo de logs que contém os eventos de logs que você deseja baixar.
4. Clique em Ações e depois em Baixar resultados da pesquisa.

Use a AWS CLI

Para recuperar eventos de logs no formato de arquivo.csv, execute o seguinte comando get-log-events da AWS CLI:

aws logs get-log-events --log-group-name example-loggroup-name  --log-stream-name example-logstream-name  --start-time 1705147529 --end-time 1705233929 log_events.csv

Observação: substitua example-loggroup-name pelo nome do seu grupo de logs, example-logstream-name pelo nome do seu fluxo de logs, 1705147529 pela sua hora de início e 1705233929 pela sua hora de término.

O arquivo .csv é armazenado no mesmo diretório do qual o comando foi iniciado. Além disso, a AWS CLI usa a região e o perfil padrões da AWS configurados para a estação de trabalho. Especifique a região para sua estação de trabalho no comando anterior da AWS CLI.

Use o CloudWatch Logs Insights para recuperar seus dados de log

Execute uma consulta para recuperar seus dados de log. Para exportar dados com menos de 10.000 logs, clique em Exportar resultados. Ou, para exportar dados de mais de 10.000 logs, exporte os logs para um bucket do S3 e, em seguida, baixe os dados em um arquivo .csv.