Usar os logs do CloudWatch Logs com o Lambda - AWS Lambda

Usar os logs do CloudWatch Logs com o Lambda

O AWS Lambda monitora automaticamente as funções do Lambda em seu nome para ajudar a solucionar falhas nas funções. Desde que o perfil de execução da função tenha as permissões necessárias, o Lambda captura os logs de todas as solicitações tratadas pela função e os envia para o Amazon CloudWatch Logs.

Você pode inserir instruções de registro em log no seu código para ajudá-lo a validar se o seu código está funcionando conforme o esperado. O Lambda se integra automaticamente com o CloudWatch Logs e envia todos os logs do seu código a um grupo de logs do CloudWatch associado a uma função do Lambda.

Por padrão, o Lambda envia logs a um grupo de logs denominado /aws/lambda/<function name>. Caso queira que a função envie logs para outro grupo, você precisará configurar isso usando o console do Lambda, a AWS Command Line Interface (AWS CLI) ou a API do Lambda. Para saber mais, consulte Configurar grupos de logs do CloudWatch.

Você pode exibir registros de funções do Lambda usando o console do Lambda, o console do CloudWatch, oAWS Command Line Interface(AWS CLI) ou a API do CloudWatch.

nota

Pode levar de 5 a 10 minutos para que os logs apareçam após uma invocação de função.

Permissões obrigatórias do IAM

O perfil de execução precisa de permissão para carregar logs no CloudWatch Logs:

  • logs:CreateLogGroup

  • logs:CreateLogStream

  • logs:PutLogEvents

Para saber mais, consulte Usar políticas baseadas em identidade (políticas do IAM) para o CloudWatch Logs no Guia do usuário do Amazon CloudWatch.

Você pode adicionar essas permissões do CloudWatch Logs usando uma política gerenciada da AWS AWSLambdaBasicExecutionRole fornecida pelo Lambda. Para adicionar essa política à sua função, execute o seguinte comando:

aws iam attach-role-policy --role-name your-role --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole

Para ter mais informações, consulte Trabalhar com políticas gerenciadas pela AWS no perfil de execução.

Definição de preço

Não há nenhuma cobrança adicional para usar os logs do Lambda, porém, a cobrança padrão do CloudWatch Logs é aplicável. Para obter mais informações, consulte Preço do CloudWatch.