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.