

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Trabalhando com logons AWS SAM
<a name="serverless-sam-cli-logging"></a>

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 CloudFormation
<a name="serverless-logging-cfn"></a>

Quando sua função faz parte de uma 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
<a name="serverless-logging-function"></a>

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

```
sam logs -n mystack-HelloWorldFunction-1FJ8PD
```

## Registros de rejeitos
<a name="serverless-logging-tail"></a>

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
<a name="serverless-logging-time-range"></a>

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
<a name="serverless-logging-time-range"></a>

Use a opção `--filter`para 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
<a name="serverless-logging-error-highlight"></a>

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
<a name="serverless-logging-error-highlight"></a>

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.