Como trabalhar com logs no AWS SAM - AWS Serverless Application Model

Como trabalhar com logs no AWS SAM

Para simplificar a solução de problemas, o AWS SAM CLI tem um comando chamado sam logs. Esse comando permite que você busque registros gerados pela sua função do Lambda na linha de comando.

nota

O comando sam logs funciona para todas as funções AWS Lambda, não apenas para aquelas que você implanta usando o AWS SAM.

Buscando registros por pilha CloudFormation

Quando sua função faz parte de uma pilha CloudFormation, você pode buscar logs usando o ID lógico da função:

sam logs -n HelloWorldFunction --stack-name mystack

Buscando registros pelo nome da função do Lambda

Ou você pode buscar registros usando o nome da função:

sam logs -n mystack-HelloWorldFunction-1FJ8PD

Registros de rejeitos

Adicione a opção --tail para aguardar os novos logs e vê-los quando eles chegam. Isso é útil durante a implantação ou quando você está solucionando um problema de produção.

sam logs -n HelloWorldFunction --stack-name mystack --tail

Visualizando registros para um intervalo de tempo específico

Você pode visualizar os registros de um intervalo de tempo específico usando as opções -s e -e:

sam logs -n HelloWorldFunction --stack-name mystack -s '10min ago' -e '2min ago'

Filtragem de logs

Use a opção --filterpara encontrar rapidamente logs que correspondam a termos, frases ou valores em seus eventos de log:

sam logs -n HelloWorldFunction --stack-name mystack --filter "error"

Na saída, AWS SAM CLI sublinha todas as ocorrências da palavra "erro" para que você possa localizar facilmente a palavra-chave do filtro na saída do log.

Destaques de erros

Quando sua função do Lambda falha ou atinge o tempo limite, o AWS SAM CLI destaca a mensagem de tempo limite em vermelho. Isso ajuda você a localizar facilmente as execuções específicas que estão expirando em um fluxo gigante de saída do log.

Impressão bonita em JSON

Se suas mensagens de registro imprimirem strings JSON, o AWS SAM CLI imprimirá automaticamente o JSON para ajudar você a analisar e entender visualmente o JSON.