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á.

# Informações sobre CloudWatch registros de acesso
<a name="access-cloudwatch-logs-insights"></a>

Essa solução registra mensagens de erro, aviso, informações e depuração para as funções do Lambda. Para escolher o tipo de mensagem a ser registrada:

1. Localize a função aplicável no console do AWS Lambda.

1. Adicione uma variável de ambiente **POWERTOOLS\_LOG\_LEVEL**.

1. Defina a variável para o tipo de mensagem aplicável.

Para obter mais instruções, consulte [Criar variáveis de ambiente do Lambda no Guia](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html) do desenvolvedor do *AWS Lambda*.

A tabela a seguir lista os tipos de níveis de log que você pode escolher.


| Nível | Description | 
| --- | --- | 
|  **ERROR (Erro)**  | Os registros incluem informações sobre qualquer coisa que faça com que uma operação falhe. | 
|  **AVISO**  | Os registros incluem informações sobre qualquer coisa que possa causar inconsistências na função, mas não necessariamente causar falha na operação. Os registros também incluem mensagens de ERRO. | 
|  **INFO**  | Os registros incluem informações de alto nível sobre como a função está operando. Os registros também incluem mensagens de ERRO e AVISO. | 
|  **DEBUG**  | Os registros incluem informações que podem ser úteis ao depurar um problema com a função. Os registros também incluem mensagens de ERRO, AVISO e INFORMAÇÕES. | 

Use o procedimento a seguir para adicionar insights do CloudWatch Logs a essa solução.

1. Identifique os grupos de registros relevantes:

   1. Faça login no [ CloudFormation console da AWS](https://console.aws.amazon.com/cloudformation).

   1. Escolha sua pilha alvo.

   1. Selecione a guia **Recursos** e pesquise suas funções Lambda de destino.

   1. Faça login no [console do AWS Lambda](https://console.aws.amazon.com/lambda) e escolha cada uma das suas funções de destino do Lambda.

   1. Para cada uma das funções do Lambda de destino, selecione a guia **Monitor** e escolha **Exibir CloudWatch ** registros.

   1. Copie os nomes dos grupos de registros dos quais você deseja extrair insights.

1. Navegue até o [ CloudWatch console da Amazon](https://console.aws.amazon.com/cloudwatch).

1. No menu de navegação, em **Registros**, escolha **Logs Insights**.

1. Na página **Logs Insights**, escolha a guia **Registros**.

1. Pesquise nomes de grupos de registros na etapa 1.

1. Copie uma das consultas de exemplo a seguir e cole-a no campo de consulta:

   1. Para identificar todas as exceções do cliente:

      ```
      fields @message
      |filter @message like /(?i)Exception/|stats count(*) as exceptionCount by @message
      ```

   1. Para recuperar a contagem de invocações pelo nome da função:

      ```
      stats count(*) by function_name
      ```

   1. Para recuperar a contagem de invocações em intervalos de cinco minutos:

      ```
      stats count(*) as invocations by bin(5m)
      ```

   1. Para recuperar todo o rastreamento IDs do [AWS X-Ray](https://aws.amazon.com/xray/):

      ```
      filter @message like "XRAY TraceId"
      |parse @message "XRAY TraceId: * " as traceId|stats count(*) by traceId
      ```

   1. Para recuperar registros relacionados a um X-Ray Trace ID específico:

      ```
      filter @message like "your-traceid-here"
      ```

   1. Para recuperar erros não autorizados WebSocket :

      ```
      fields
      @ingestionTime,
      @log,
      @logStream,
      @message,
      @requestId,
      @timestamp,
      errorMessage,
      errorType
      |filter @message like /Unauthorized/ and @message like /websocket/|sort @timestamp desc
      ```

   1. Para recuperar a contagem de métricas publicadas:

      ```
      filter @message like "CloudWatchMetrics"
      |parse @message /"Metrics":\s*\[(?<metrics>.*?)\]/|stats count(*) as metric_count by metrics
      ```