

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Pubblicazione di log Aurora PostgreSQL in Amazon CloudWatch Logs
<a name="AuroraPostgreSQL.CloudWatch"></a>

È possibile configurare il cluster database Aurora PostgreSQL per l’esportazione dei dati di registro in File di log Amazon CloudWatch in modo regolare. In questo caso, gli eventi del registro PostgreSQL del cluster database Aurora PostgreSQL vengono *pubblicati* automaticamente in Amazon CloudWatch, come File di log Amazon CloudWatch. In CloudWatch, sono disponibili i dati di registro esportati in un *Gruppo di log* per il cluster database Aurora PostgreSQL. Il gruppo di log contiene uno o più *flussi di log* che contengono gli eventi del registro PostgreSQL di ogni istanza nel cluster. 

La pubblicazione dei registri in File di log CloudWatch consente di mantenere i record di registro PostgreSQL del cluster in uno storage altamente durevole. Con i dati di registro disponibili in File di log CloudWatch, puoi valutare e migliorare le operazioni del cluster. Puoi anche usare CloudWatch per creare allarmi e visualizzare metriche. Per ulteriori informazioni, consulta [Monitoraggio degli eventi di registro in Amazon CloudWatch](AuroraPostgreSQL.CloudWatch.Monitor.md).

**Nota**  
La pubblicazione dei registri PostgreSQL in File di log CloudWatch consuma spazio di archiviazione e comporta costi di archiviazione. Assicurati di eliminare gli eventuali File di log CloudWatch non più necessari. 

La disattivazione dell'opzione Export log (Esporta log) per un cluster database Aurora PostgreSQL esistente non influenza gli eventuali dati già contenuti in File di log CloudWatch. I registri esistenti rimangono disponibili in File di log CloudWatch in base alle impostazioni di conservazione dei registri. Per ulteriori informazioni su File di log CloudWatch, consulta [Che cos'è File di log Amazon CloudWatch?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) 

Aurora PostgreSQL supporta la pubblicazione di registri in File di log CloudWatch per le seguenti versioni. 
+ 16.1 e tutte le versioni successive
+ 15.2 o versioni successive alla 15
+ 14.3 o versioni successive alla 14
+ 13.3 o versioni successive alla 13
+ 12.8 e versioni successive alla 12
+ 11.9 o versioni successive alla 11

Per informazioni sull’attivazione dell’opzione di pubblicazione dei log su CloudWatch Logs, sul monitoraggio degli eventi di log in CloudWatch Logs e sull’analisi dei log utilizzando CloudWatch Logs Insights, consulta i seguenti argomenti.

**Topics**
+ [Attivazione dell'opzione per pubblicare i registri in Amazon CloudWatch](AuroraPostgreSQL.CloudWatch.Publishing.md)
+ [Monitoraggio degli eventi di registro in Amazon CloudWatch](AuroraPostgreSQL.CloudWatch.Monitor.md)
+ [Analisi dei registri Aurora PostgreSQL utilizzando approfondimenti sui file di log Amazon CloudWatch](AuroraPostgreSQL.CloudWatch.Analyzing.md)

# Attivazione dell'opzione per pubblicare i registri in Amazon CloudWatch
<a name="AuroraPostgreSQL.CloudWatch.Publishing"></a>

Per pubblicare il registro PostgreSQL del cluster database Aurora PostgreSQL in File di log CloudWatch, seleziona l’opzione **Log Export** (Esportazione log) per il cluster. Puoi scegliere l'impostazione Log export (Esportazione log) durante la creazione del cluster database Aurora PostgreSQL. In alternativa, puoi modificare il cluster in un secondo momento. Quando si modifica un cluster esistente, i relativi registri PostgreSQL di ciascuna istanza vengono pubblicati nel cluster CloudWatch da quel momento in poi. Per Aurora PostgreSQL, il registro PostgreSQL (`postgresql.log`) è l'unico registro pubblicato in Amazon CloudWatch. 

Puoi utilizzare la Console di gestione AWS, la AWS CLI o l'API RDS per attivare la funzionalità Log export (Esportazione log) per il cluster database Aurora PostgreSQL. 

## Console
<a name="AuroraPostgreSQL.CloudWatch.Console"></a>

Scegliere l’opzione Log exports (Esportazioni log) per avviare la pubblicazione dei registri PostgreSQL dal cluster database Aurora PostgreSQL in File di log Amazon CloudWatch.

**Per attivare la funzionalità Log export (Esportazione log) dalla console**

1. Apri la console Amazon RDS all’indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Nel pannello di navigazione, scegliere **Databases (Database)**.

1. Scegli il cluster database Aurora PostgreSQL di cui desideri pubblicare i dati di registro in File di log CloudWatch.

1. Scegliere **Modify (Modifica)**.

1. Nella sezione **Log exports** (Esportazioni log) scegli **Postgresql log** (Log PostgreSQL).

1. Scegliere **Continue (Continua)** e quindi selezionare **Modify cluster (Modifica cluster)** nella pagina di riepilogo.

## AWS CLI
<a name="AuroraPostgreSQL.CloudWatch.CLI"></a>

Puoi attivare l'opzione Log export (Esportazione log) per iniziare a pubblicare i registri di Aurora PostgreSQL in File di log Amazon CloudWatch con la AWS CLI. A questo scopo, esegui il comando AWS CLI [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) con le opzioni seguenti: 
+ `--db-cluster-identifier`: l’identificatore del cluster di database.
+ `--cloudwatch-logs-export-configuration`—L'impostazione di configurazione per i tipi di log da abilitare per l'esportazione in CloudWatch Logs per il cluster DB.

Puoi pubblicare i log Aurora PostgreSQL anche emettendo uno dei seguenti comandi della AWS CLI: 
+ [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html)
+ [restore-db-cluster-from-s3](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-from-s3.html)
+ [restore-db-cluster-from-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-from-snapshot.html)
+ [restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)

Esegui uno di questi comandi dell'AWS CLI con le opzioni seguenti:
+ `--db-cluster-identifier`: l’identificatore del cluster di database.
+ `--engine`— – Il motore di database.
+ `--enable-cloudwatch-logs-exports`— – L'impostazione di configurazione per i tipi di log da abilitare per l'esportazione in CloudWatch Logs per il cluster DB.

Altre opzioni potrebbero essere richieste a seconda del comando dell'AWS CLI che esegui.

**Example**  
Il seguente comando crea un cluster DB Aurora PostgreSQL per pubblicare i file di log in CloudWatch Logs.  
Per Linux, macOS o Unix:  

```
1. aws rds create-db-cluster \
2.     --db-cluster-identifier my-db-cluster \
3.     --engine aurora-postgresql \
4.     --enable-cloudwatch-logs-exports postgresql
```
Per Windows:  

```
1. aws rds create-db-cluster ^
2.     --db-cluster-identifier my-db-cluster ^
3.     --engine aurora-postgresql ^
4.     --enable-cloudwatch-logs-exports postgresql
```

**Example**  
Il seguente comando modifica un cluster DB Aurora PostgreSQL esistente per pubblicare i file di log in CloudWatch Logs. Il valore `--cloudwatch-logs-export-configuration` è un oggetto JSON. La chiave per questo oggetto è `EnableLogTypes` e il relativo valore è `postgresql` e `instance`.  
Per Linux, macOS o Unix:  

```
1. aws rds modify-db-cluster \
2.     --db-cluster-identifier my-db-cluster \
3.     --cloudwatch-logs-export-configuration '{"EnableLogTypes":["postgresql","instance"]}'
```
Per Windows:  

```
1. aws rds modify-db-cluster ^
2.     --db-cluster-identifier my-db-cluster ^
3.     --cloudwatch-logs-export-configuration '{\"EnableLogTypes\":[\"postgresql\",\"instance\"]}'
```
Quando usi il prompt comandi di Windows, non devi inserire le doppie virgolette (") nel codice JSON precedendole con il backslash (\$1).

**Example**  
Nell'esempio seguente viene modificato un cluster Aurora PostgreSQL DB esistente per disabilitare i file di registro di pubblicazione CloudWatch Logs. Il valore `--cloudwatch-logs-export-configuration` è un oggetto JSON. La chiave per questo oggetto è `DisableLogTypes` e il relativo valore è `postgresql` e `instance`.  
Per Linux, macOS o Unix:  

```
aws rds modify-db-cluster \
    --db-cluster-identifier mydbinstance \
    --cloudwatch-logs-export-configuration '{"DisableLogTypes":["postgresql","instance"]}'
```
Per Windows:  

```
aws rds modify-db-cluster ^
    --db-cluster-identifier mydbinstance ^
    --cloudwatch-logs-export-configuration "{\"DisableLogTypes\":[\"postgresql\",\"instance\"]}"
```
Quando usi il prompt comandi di Windows, non devi inserire le doppie virgolette (") nel codice JSON precedendole con il backslash (\$1).

## API RDS
<a name="AuroraPostgreSQL.CloudWatch.API"></a>

Puoi attivare l'opzione Log export (Esportazione log) per iniziare a pubblicare i registri di Aurora PostgreSQL con l’API RDS. A questo scopo, esegui l'operazione [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) con le seguenti opzioni: 
+ `DBClusterIdentifier` - L'identificatore del cluster di database.
+ `CloudwatchLogsExportConfiguration` – L'impostazione di configurazione per i tipi di log da abilitare per l'esportazione in CloudWatch Logs per il cluster di database.

Puoi anche pubblicare i log Aurora MySQL con l'API RDS eseguendo una delle seguenti operazioni dell'API RDS: 
+ [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html)
+ [RestoreDBClusterFromS3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterFromS3.html)
+ [RestoreDBClusterFromSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterFromSnapshot.html)
+ [RestoreDBClusterToPointInTime](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterToPointInTime.html)

Esegui l'operazione dell'API RDS con i seguenti parametri: 
+ `DBClusterIdentifier`: l’identificatore del cluster di database.
+ `Engine`— – Il motore di database.
+ `EnableCloudwatchLogsExports`— – L'impostazione di configurazione per i tipi di log da abilitare per l'esportazione in CloudWatch Logs per il cluster DB.

Altri parametri potrebbero essere richiesti a seconda del comando dell'AWS CLI che esegui.

# Monitoraggio degli eventi di registro in Amazon CloudWatch
<a name="AuroraPostgreSQL.CloudWatch.Monitor"></a>

Con gli eventi di log di Aurora PostgreSQL pubblicati e disponibili come Amazon CloudWatch Logs, puoi visualizzare e monitorare gli eventi utilizzando Amazon. CloudWatch Per ulteriori informazioni sul monitoraggio, consulta [Visualizza i dati di registro](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#ViewingLogData) inviati ai registri. CloudWatch 

Se si attiva Log exports (Esportazioni log), un nuovo gruppo di log viene creato automaticamente utilizzando il prefisso `/aws/rds/cluster/` con il nome di Aurora PostgreSQL e il tipo di registro, come nel modello seguente. 

```
/aws/rds/cluster/your-cluster-name/postgresql
```

Ad esempio, supponiamo che un cluster `docs-lab-apg-small` DB Aurora PostgreSQL denominato esporti il proprio log in Amazon Logs. CloudWatch Il nome del gruppo di log in Amazon CloudWatch è mostrato di seguito.

```
/aws/rds/cluster/docs-lab-apg-small/postgresql
```

Se esiste un gruppo di log con il nome specificato, Aurora utilizza quel gruppo di log per esportare i dati di log per il cluster DB Aurora. Ogni istanza database nel cluster database Aurora PostgreSQL carica il proprio registro PostgreSQL nel gruppo di log come flusso di log distinto. Puoi esaminare il gruppo di log e i relativi flussi di log utilizzando i vari strumenti grafici e analitici disponibili in Amazon. CloudWatch

Ad esempio, è possibile cercare informazioni all'interno degli eventi di registro del cluster Aurora PostgreSQL DB e filtrare gli eventi utilizzando la console Logs, o l'API CloudWatch Logs. AWS CLI CloudWatch Per ulteriori informazioni, consulta [Ricerca e filtraggio dei dati di log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/MonitoringLogData.html) nella *Amazon CloudWatch Logs User Guide.* 

Per impostazione predefinita, i nuovi gruppi di log vengono creati utilizzando **Never expire** (Non scade mai) per il periodo di conservazione. Puoi utilizzare la console CloudWatch Logs, l'API Logs o l' AWS CLI API CloudWatch Logs per modificare il periodo di conservazione dei log. Per ulteriori informazioni, consulta [Change log data retention in CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/SettingLogRetention.html) nella *Amazon CloudWatch Logs User* Guide.

**Suggerimento**  
Puoi utilizzare la configurazione automatizzata AWS CloudFormation, ad esempio per creare gruppi di log con periodi di conservazione dei log predefiniti, filtri metrici e autorizzazioni di accesso. 

# Analisi dei registri Aurora PostgreSQL utilizzando approfondimenti sui file di log Amazon CloudWatch
<a name="AuroraPostgreSQL.CloudWatch.Analyzing"></a>

Con i registri PostgreSQL del cluster database Aurora PostgreSQL pubblicati come File di log Amazon CloudWatch, è possibile usare approfondimenti sui File di log Amazon CloudWatch per cercare e analizzare in modo interattivo i dati di registro in File di log Amazon CloudWatch. Approfondimenti sui file di log Amazon CloudWatch include un linguaggio di query, query di esempio e altri strumenti per l'analisi dei dati di registro in modo da poter identificare potenziali problemi e verificare le correzioni. Per ulteriori informazioni, consulta [Analisi dei dati di registro con approfondimenti sui file di log Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) nella *Guida per l'utente di File di log Amazon CloudWatch*.

**Per analizzare i registri Aurora PostgreSQL con Approfondimenti sui file di log Amazon CloudWatch**

1. Apri la console CloudWatch all’indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Nel pannello di navigazione, aprire **Logs (Log)**, e scegliere **Log Insights (Informazioni dettagliate Log**.

1. In **Select log group(s)** (Seleziona uno o più i gruppi di log), seleziona il gruppo di log per il cluster database Aurora PostgreSQL.  
![\[\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-select-log-group.png)

1. Nell'editor di query, elimina la query attualmente visualizzata, quindi immetti quanto segue e scegli **Run (Esegui)**.

   ```
   ##Autovacuum execution time in seconds per 5 minute
   fields @message
   | parse @message "elapsed: * s" as @duration_sec
   | filter @message like / automatic vacuum /
   | display @duration_sec
   | sort @timestamp
   | stats avg(@duration_sec) as avg_duration_sec, 
   max(@duration_sec) as max_duration_sec 
   by bin(5 min)
   ```  
![\[\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-query.png)

1. Seleziona la scheda **Visualization (Visualizzazione)**.  
![\[\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-visualization.png)

1. Scegli **Add to dashboard (Aggiungi a pannello di controllo)**.

1. In **Seleziona un pannello di controllo**, seleziona un pannello di controllo o inserisci un nome per creare un nuovo pannello di controllo.

1. In **Tipo di widget**, scegli un tipo di widget per la tua visualizzazione.  
![\[\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-dashboard.png)

1. (Facoltativo) Aggiungi altri widget in base ai risultati della query di log.

   1. Seleziona **Add widget** (Aggiungi widget).

   1. Scegli un tipo di widget, ad esempio **Line (Linea)**.  
![\[\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-widget.png)

   1. Nella finestra **Aggiungi a questo pannello di controllo**, scegli **Log**.  
![\[\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-add-logs-to-dashboard.png)

   1. Nello stato **Seleziona gruppi di log**, seleziona il gruppo di log per il cluster di database di.

   1. Nell'editor di query, elimina la query attualmente visualizzata, quindi immetti quanto segue e scegli **Run (Esegui)**.

      ```
      ##Autovacuum tuples statistics per 5 min
      fields @timestamp, @message
      | parse @message "tuples: " as @tuples_temp
      | parse @tuples_temp "* removed," as @tuples_removed
      | parse @tuples_temp "remain, * are dead but not yet removable, " as @tuples_not_removable
      | filter @message like / automatic vacuum /
      | sort @timestamp
      | stats  avg(@tuples_removed) as avg_tuples_removed, 
      avg(@tuples_not_removable) as avg_tuples_not_removable 
      by bin(5 min)
      ```  
![\[\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-query2.png)

   1. Seleziona **Crea widget**.

      Il pannello di controllo dovrebbe apparire simile alla seguente immagine.  
![\[\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-dashboard-two-graphs.png)