# Como trabalhar com o CloudWatch Logs Insights usando o AWS Toolkit for JetBrains
<a name="cloudwatch-log-insights"></a>

Você pode usar o AWS Toolkit for JetBrains para trabalhar com o CloudWatch Logs Insights. O CloudWatch Logs Insights permite pesquisar e analisar dados de log de modo interativo no Amazon CloudWatch Logs. Para obter mais informações, consulte [Analisar logs de dados com o CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) no *Guia do usuário do Amazon CloudWatch Logs*.

## Permissões do IAM para o CloudWatch Logs Insights
<a name="iam-permissions-for-cwlog-insights"></a>

 Você precisa das seguintes permissões para executar e visualizar os resultados da consulta do CloudWatch Logs Insights: 

```
{
  "Version": "2012-10-17",
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "logs:StartQuery",
        "logs:GetQueryResults",
        "logs:GetLogRecord",
        "logs:describeLogGroups",
        "logs:describeLogStreams"
      ],
      "Resource" : "*"
    }
  ]
}
```

A permissão a seguir não é necessária, mas permitirá que o AWS Toolkit for JetBrains interrompa automaticamente qualquer consulta em execução ao fechar o painel de resultados ou o IDE associados. 

```
{
  "Version": "2012-10-17",
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "logs:StopQuery"
      ],
      "Resource" : "*"
    }
  ]
}
```

## Como trabalhar com o CloudWatch Logs Insights
<a name="working-with-cwlog-insights"></a>

**Abrir o editor de consulta do CloudWatch Logs Insights**

1. Abra o Explorador da AWS.

1.  Clique duas vezes no nó do **CloudWatch Logs** para expandir a lista de grupos de logs. 

1.  Clique com o botão direito do mouse no grupo de logs que você deseja abrir e escolha **Abrir um editor de consulta**. 

**Iniciar uma consulta do CloudWatch Logs Insights**

1. Na janela **Grupos de logs de consultas**, altere os parâmetros da consulta, conforme desejado.

   Você pode escolher um intervalo de tempo por data ou hora relativa.

   O campo **Grupos de logs de consultas** aceita a sintaxe de consulta do CloudWatch Logs Insights. Para obter mais informações, consulte [Sintaxe de consulta do CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html) no *Guia do usuário do Amazon CloudWatch Logs*.

1.  Escolha **Executar** para iniciar a consulta. 

**Salvar uma consulta do CloudWatch Logs Insights**

1. Digite um nome de consulta. 

1.  Escolha **Salvar consulta**. 

    Os grupos de logs e a consulta selecionados são salvos na sua conta da AWS. Os intervalos de tempo não são salvos. 

   Você pode recuperar e reutilizar consultas salvas na página do Console de gerenciamento da AWS do CloudWatch Logs Insights.

**Recuperar uma consulta salva do CloudWatch Logs Insights**

1.  Na janela **Grupos de logs de consultas**, escolha **Recuperar consultas salvas**. 

1.  Escolha a consulta desejada e depois **OK**. 

   Os grupos de logs e a consulta selecionados substituem tudo na caixa de diálogo existente.

**Navegar pelos resultados da consulta**
+  Na janela **Resultados da consulta** do CloudWatch Logs Insights, no canto superior direito, escolha **Abrir editor de consulta**. 

**Visualizar um registro de log individual**
+  No painel de resultados da consulta, clique duas vezes em uma linha para abrir uma nova aba com detalhes sobre esse registro de log. 

   Você também pode navegar até o fluxo de logs associado ao registro de log escolhendo **Exibir fluxo de logs** no canto superior direito.