# Utilizzo di File di log CloudWatch tramite il AWS Toolkit for JetBrains
Amazon CloudWatch Logs consente di centralizzare i registri da tutti i sistemi, applicazioni e servizi AWS utilizzati in un unico servizio altamente scalabile. È quindi possibile visualizzarli facilmente, ricercarli per codici di errore o modelli specifici, filtrarli in base a campi specifici o archiviarli in modo sicuro per analisi future. Per ulteriori informazioni, consulta [Cos'è Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatchLogs.html) nella *Guida per l'utente di Amazon CloudWatch*.
Negli argomenti seguenti viene descritto come utilizzare il AWS Toolkit for JetBrains per lavorare con File di log CloudWatch in un account AWS.
**Topics**
+ [Visualizzazione dei gruppi di registro log e dei flussi di registro CloudWatch](viewing-CloudWatch-logs.md)
+ [Utilizzo dei log eventi di CloudWatch](working-CloudWatch-log-events.md)
+ [Utilizzo di Logs Insights di CloudWatch](cloudwatch-log-insights.md)
# Visualizzazione dei gruppi di log e dei flussi di log di CloudWatch tramite il AWS Toolkit for JetBrains
Un *flusso di log* è una sequenza di eventi di log che condividono la stessa origine. Ciascuna origine di registri separata in CloudWatch Logs costituisce un flusso di log distinto.
Un *gruppo di log* è un gruppo di flussi di log che condividono le stesse impostazioni di conservazione, monitoraggio e controllo degli accessi. Puoi definire i gruppi di log e specificare quali flussi inserire in ciascun gruppo. Non vi è alcun limite al numero di flussi di log che possono appartenere a un gruppo di log.
Per ulteriori informazioni, consulta la pagina [Working with Log Groups and Log Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Working-with-log-groups-and-streams.html) della *Guida per l'utente di Amazon CloudWatch*.
**Topics**
+ [Visualizzazione dei gruppi di registro log e dei flussi di registro con il nodo **CloudWatch Logs**](#viewing-log-groups)
+ [Visualizzazione dei flussi di log con il nodo **Lambda**](#viewing-lamba-log-groups)
+ [Visualizzazione dei flussi di log con il nodo **Amazon ECS**](#viewing-ecs-log-groups)
## Visualizzazione dei gruppi di registro log e dei flussi di registro con il nodo **CloudWatch Logs**
1. Aprire AWS Explorer, se non è già aperto.
1. Fai clic sul nodo **File di log CloudWatch** per espandere l'elenco dei gruppi di log.
I gruppi di log per la [regione AWS corrente](setup-region.md#setup-region-current-region) vengono visualizzati sotto il nodo **File di log CloudWatch**.
1. Per visualizzare i flussi di log in un gruppo di log, effettua una delle seguenti operazioni:
+ Fai doppio clic sul gruppo di log.
+ Fai clic con il pulsante destro del mouse su un gruppo di log e scegli **Visualizza flussi di log**.
I contenuti del gruppo di log vengono visualizzati nel riquadro **Flussi di log**. Per informazioni sull'interazione con i log eventi in ogni flusso, consulta [Utilizzo dei log eventi di CloudWatchUtilizzo di Logs Insights di CloudWatch](working-CloudWatch-log-events.md).
![\[Visualizzazione dei flussi di log in un gruppo di log di CloudWatch nell'Esploratore AWS\]](http://docs.aws.amazon.com/it_it/toolkit-for-jetbrains/latest/userguide/images/cloudwatch-view-log-streams.png)
## Visualizzazione dei flussi di log con il nodo **Lambda**
È possibile visualizzare File di log CloudWatch per le funzioni AWS Lambda tramite il nodo **Lambda** nell'Esploratore AWS.
**Nota**
È inoltre possibile visualizzare i flussi di log per tutti i servizi AWS, incluse le funzioni Lambda, che utilizzano il nodo **File di log CloudWatch** nell'Esploratore AWS. Tuttavia, per una panoramica dei dati di log specifici delle funzioni Lambda, ti consigliamo di utilizzare il nodo **Amazon ECS**.
1. Aprire AWS Explorer, se non è già aperto.
1. Fai clic sul nodo **Lambda** per espandere l'elenco delle funzioni Lambda.
Le funzioni Lambda per la [regione AWS corrente](setup-region.md#setup-region-current-region) vengono visualizzati sotto il nodo **Lambda**.
1. Fai clic con il pulsante destro del mouse su una funzione Lambda, quindi scegli **Visualizza flussi di log**.
I flussi di log relativi alla funzione vengono visualizzati nel riquadro **Flussi di log**. Per informazioni sull'interazione con i log eventi in ogni flusso, consulta [Utilizzo dei log eventi di CloudWatchUtilizzo di Logs Insights di CloudWatch](working-CloudWatch-log-events.md).
## Visualizzazione dei flussi di log con il nodo **Amazon ECS**
È possibile visualizzare File di log CloudWatch per cluster e container eseguiti e gestiti in Amazon Elastic Container Service tramite il nodo **Amazon ECS** nell'Esploratore AWS.
**Nota**
È inoltre possibile visualizzare i gruppi di log per tutti i servizi AWS, incluso Amazon ECS, che utilizzano il nodo **File di log CloudWatch** nell'Esploratore AWS. Tuttavia, per una panoramica dei dati di log specifici dei cluster e dei container Amazon ECS, ti consigliamo di utilizzare il nodo **Amazon ECS**.
1. Aprire AWS Explorer, se non è già aperto.
1. Fai clic sul nodo **Amazon ECS** per espandere l'elenco dei cluster Amazon ECS.
I cluster Amazon ECS per la [regione AWS corrente](setup-region.md#setup-region-current-region) vengono visualizzati sotto il nodo **Amazon ECS**.
1. Fai clic con il pulsante destro del mouse su un cluster, quindi scegli **Visualizza flussi di log**.
I flussi di log relativi al cluster vengono visualizzati nel riquadro **Flussi di log**.
1. Per visualizzare i flussi di log per un container specifico, fai clic su un cluster per espandere l'elenco dei container registrati.
I container registrati per il cluster sono visualizzati sotto.
1. Fai clic con il pulsante destro del mouse su un container, quindi scegli **Visualizza flusso di log del container**.
I flussi di log relativi al container vengono visualizzati nel riquadro **Flussi di log**. Per informazioni sull'interazione con i log eventi per cluster e container, consulta la pagina [Utilizzo dei log eventi di CloudWatchUtilizzo di Logs Insights di CloudWatch](working-CloudWatch-log-events.md).
# Utilizzo dei log eventi di CloudWatch nei flussi di log tramite il AWS Toolkit for JetBrains
Dopo aver aperto la finestra **Flussi di log**, puoi accedere ai log eventi in ogni flusso. Un log eventi è una serie di registri di attività registrate dall'applicazione o dalla risorsa monitorata.
**Topics**
+ [Visualizzazione e filtraggio dei log eventi in un flusso](#viewing-log-events)
+ [Utilizzo delle operazioni sui log](#working-with-log-actions)
+ [Esportazione dei log eventi di CloudWatch in un file o un editor](#exporting-CW-logs)
## Visualizzazione e filtraggio dei log eventi in un flusso
Quando apri un flusso di log, nella finestra **Flusso di log**, viene visualizzata la sequenza dei log eventi di tale flusso.
1. Per trovare un flusso di log da visualizzare, apri il riquadro **Flusso di log** (consulta la pagina [Visualizzazione dei gruppi di registro log e dei flussi di registro CloudWatch](viewing-CloudWatch-logs.md)).
**Nota**
È possibile utilizzare la corrispondenza del modello per individuare un flusso in un elenco. Fai clic sul riquadro **Flussi di log** e inizia a inserire il testo. Viene evidenziato il primo flusso di log con il testo corrispondente al tuo. È inoltre possibile riordinare l'elenco facendo clic sulla parte superiore della colonna **Ora dell'ultimo evento**.
1. Fai doppio clic su un flusso di log per visualizzarne la sequenza dei log eventi.
Il riquadro **Log eventi** visualizza i log eventi che costituiscono il flusso di log.
1. Per filtrare i log eventi in base al contenuto, inserisci il testo nel campo **Filtra flusso di log** e premi **Restituisci**.
I risultati sono log eventi contenenti il testo corrispondente al testo del filtro che hai inserito, facendo distinzione tra maiuscole e minuscole. Il filtro esegue la ricerca nell'intero flusso di log, inclusi gli eventi non visualizzati sullo schermo.
**Nota**
È inoltre possibile utilizzare la corrispondenza del modello per individuare un log eventi nel riquadro. Fai clic sul riquadro **Log eventi** e inizia a inserire il testo. Viene evidenziato il primo log eventi con il testo corrispondente al tuo. A differenza della ricerca **Filtra flusso di log**, vengono controllati solo gli eventi sullo schermo.
1. Per filtrare i log eventi in base all'ora, fai clic con il pulsante destro del mouse su un log eventi, quindi scegli **Mostra log**.
È possibile selezionare **Un minuto**, **Cinque minuti** oppure **Dieci minuti**. Ad esempio, se si seleziona **Cinque minuti**, l'elenco filtrato mostra solo i log eventi che si sono verificati cinque minuti prima e dopo la voce selezionata.
![\[Visualizzazione e filtraggio delle operazioni dei log nel riquadro Log eventi.\]](http://docs.aws.amazon.com/it_it/toolkit-for-jetbrains/latest/userguide/images/cloudwatch-filter-log-events.png)
Sulla sinistra del riquadro **Log eventi**, le [operazioni sui log](#working-with-log-actions) offrono ulteriori modi per interagire con i log eventi.
## Utilizzo delle operazioni sui log
Sulla sinistra del riquadro **Log eventi**, quattro operazioni di log consentono di aggiornare, modificare, aggiungere code e mandare a capo i log eventi di CloudWatch.
![\[Visualizzazione delle operazioni dei log nel riquadro Log eventi.\]](http://docs.aws.amazon.com/it_it/toolkit-for-jetbrains/latest/userguide/images/cloudwatch-log-actions.png)
1. Per trovare i log eventi con cui interagire, [apri il riquadro **Flussi di log**](#viewing-log-events).
1. Scegli una delle seguenti operazioni sui log:
+ **Aggiorna**: aggiorna l'elenco con i log eventi che si sono verificati dopo che è stato aperto il riquadro **Log eventi**.
+ **Apri nell'editor**: apre i log eventi sullo schermo nell'editor predefinito dell'IDE.
**Nota**
Questa operazione esporta solo i log eventi visualizzati sullo schermo nell'editor IDE. Per visualizzare tutti gli eventi del flusso nell'editor, scegli l'opzione [**Esporta flusso di log**](#exporting-CW-logs).
+ **Log di coda**: trasmette i nuovi log eventi al riquadro **Log eventi**. Questa è una funzionalità utile per gli aggiornamenti continui su servizi a lunga durata come le istanze Amazon EC2 e le build AWS CodeBuild.
+ **Manda a capo i log**: visualizza il testo del log eventi su più righe se le dimensioni del riquadro nascondono voci più lunghe.
## Esportazione dei log eventi di CloudWatch in un file o un editor
L'esportazione di un flusso di log di CloudWatch consente di aprire i log eventi nell'editor predefinito dell'IDE o di scaricarli in una cartella locale.
1. Per trovare un flusso di log a cui accedere, [apri il riquadro **Flussi di log**](#viewing-log-events).
1. Fai clic con il pulsante destro del mouse su un flusso di log, quindi scegli **Esporta flusso di log**, **Apri nell'editor** o **Esporta flusso di log**, **Salva in un file**.
+ **Apri nell'editor**: apre i log eventi che costituiscono il flusso selezionato nell'editor predefinito dell'IDE.
**Nota**
Questa opzione esporta tutti gli eventi nel flusso di log nell'editor dell'IDE.
+ **Salva in un file**: apre la finestra di dialogo **Scarica flusso di log**. Ciò consente di selezionare una cartella per il download e rinominare il file contenente i log eventi.
# Utilizzo di Logs Insights di CloudWatch tramite il AWS Toolkit for JetBrains
È 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
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
**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.