Como trabalhar com logs

Para simplificar a solução de problemas, o AWS SAMCLI 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 sam logs comando funciona para todas as AWS Lambda funções, não apenas para aquelas que você implanta usando AWS SAM.

Buscando registros por pilha AWS CloudFormation

Quando sua função faz parte de uma AWS CloudFormation pilha, você pode buscar registros 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.