# Utilizzo di Logs Insights di CloudWatch tramite il AWS Toolkit for JetBrains
<a name="cloudwatch-log-insights"></a>

È possibile utilizzare il AWS Toolkit for JetBrains per lavorare con Logs Insights di CloudWatch. Logs Insights di CloudWatch consente di eseguire ricerche interattive e analizzare i dati di log in File di log Amazon CloudWatch. Per ulteriori informazioni, consulta la pagina [Analyzing Log Data with CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) della *Guida per l'utente di File di log Amazon CloudWatch*.

## Autorizzazioni IAM per Logs Insights di CloudWatch
<a name="iam-permissions-for-cwlog-insights"></a>

 Per eseguire e visualizzare i risultati delle query di Logs Insights di CloudWatch sono necessarie le seguenti autorizzazioni: 

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

Le seguenti autorizzazioni non sono richieste, ma consentiranno al AWS Toolkit for JetBrains di interrompere automaticamente tutte le query attualmente in esecuzione quando si chiude il riquadro dei risultati o l'IDE associato. 

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

## Utilizzo di Logs Insights di CloudWatch
<a name="working-with-cwlog-insights"></a>

**Apertura dell'editor di query di Logs Insights di CloudWatch**

1. Apri l'Esploratore AWS.

1.  Fai doppio clic sul nodo **File di log CloudWatch** per espandere l'elenco dei gruppi di log. 

1.  Fate clic con il pulsante destro del mouse sul gruppo di log che desideri aprire, quindi scegli **Apri editor di query**. 

**Avvio di una query di Logs Insights di CloudWatch**

1. Nella finestra **Query sui gruppi di log**, modifica i parametri di query come desiderato.

   È possibile scegliere un intervallo di tempo per data oppure ora relativa.

   Il campo **Gruppi di log di query** accetta la sintassi delle query di Logs Insights di CloudWatch. Per ulteriori informazioni, consulta la pagina [CloudWatch Logs Insights Query Syntax](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html) della *Guida per l'utente di File di log Amazon CloudWatch*.

1.  Scegli **Esegui** per iniziare la query. 

**Salvataggio di una query di Logs Insights di CloudWatch**

1. Digita il nome della query. 

1.  Scegli **Salva query**. 

    I gruppi di log e la query selezionati vengono salvati nell'account AWS. Gli intervalli di tempo non vengono salvati. 

   È possibile recuperare e riutilizzare le query salvate dalla pagina della Console di gestione AWS di Logs Insights di CloudWatch.

**Recupero di una query salvata di Logs Insights di CloudWatch**

1.  Nella finestra **Query sui gruppi di log**, scegli **Recupera query salvate**. 

1.  Scegli la query desiderata e seleziona **OK**. 

   I gruppi di log e la query selezionati sostituiscono ogni campo nella finestra di dialogo esistente.

**Esplorazione dei risultati delle query**
+  Nella finestra **Risultati delle query** di Logs Insights di CloudWatch, nell'angolo in alto a destra, scegli **Apri editor di query**. 

**Visualizzazione di un singolo record di log**
+  Nel riquadro dei risultati della query, fai doppio clic su una riga per aprire una nuova scheda con i dettagli su tale record di log. 

   È inoltre possibile accedere al flusso di log associato al record di log scegliendo **Visualizza flusso di log** nell'angolo in alto a destra.