

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

# Attivazione e disabilitazione di metriche dettagliate per query e contatore di database
<a name="USER_PerfInsights.Enabling"></a>

Le metriche dettagliate per query e contatore del database sono abilitate per impostazione predefinita quando si seleziona la modalità Database Insights Advanced. Se si seleziona la modalità Database Insights Standard, è possibile abilitarle quando si crea l'istanza  DB del cluster  DB e disattivarle successivamente modificando il cluster  DB dell'istanza  DB dalla console. L'attivazione di metriche dettagliate per query e contatore del database non causa tempi di inattività, riavvio o failover.

**Nota**  
Performance Schema è uno strumento di prestazioni opzionale utilizzato da Aurora MySQL. Se si attiva o disattiva Performance Schema, è necessario riavviare il sistema. Tuttavia, se abiliti o disabiliti le metriche dettagliate per query e contatore del database, non è necessario riavviare. Per ulteriori informazioni, consulta [Panoramica dello schema delle prestazioni per Database Insights in Aurora MySQL](USER_PerfInsights.EnableMySQL.md).

Se utilizzate metriche dettagliate per query e contatore di database con i database globali Aurora, attivatele singolarmente per i database di ciascuno. Regione AWS Per informazioni dettagliate, vedi [Monitoraggio di un database globale Amazon Aurora con Amazon RDS Performance Insights](aurora-global-database-monitoring.md#aurora-global-database-pi). 

L'agente Database Insights consuma CPU e memoria limitate sull'host DB. Quando il carico del DB è elevato, l'agente limita l'impatto sulle prestazioni raccogliendo i dati meno frequentemente.

------
#### [ Console ]

Nella console, puoi abilitare la raccolta di metriche dettagliate per query e contatore del database per la modalità Database Insights Standard quando crei o modifichi un cluster DB. L'attivazione di metriche dettagliate per query e contatore di database consente di gestire le impostazioni e le opzioni di Database Insights per il cluster DB. Le impostazioni a livello di cluster si applicano a tutte le istanze database nel cluster.

**Abilitazione o disabilitazione di metriche dettagliate per query e contatore di database durante la creazione di un'istanza DB o di un   **

Dopo aver creato una nuova istanza  DB, Amazon RDS abilita per impostazione predefinita metriche dettagliate per query e contatore di database. Per disattivarlo, scegli l'opzione ** Database Insights — Standard ** e deseleziona l'opzione ** Abilita la raccolta di metriche dettagliate per query e contatore di database. **

 Per creare un cluster di database, seguire le istruzioni per il proprio motore di database in [Creazione di un cluster database Amazon Aurora](Aurora.CreateInstance.md). 

La schermata seguente mostra la ** sezione ** Database Insights.

![Sezione Database Insights nella pagina di creazione del cluster DB, con la possibilità di abilitare metriche dettagliate del database.](https://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/db_insights_enabling.png)


Se scegli ** Abilita la raccolta di metriche dettagliate per query e contatore di database**, hai le seguenti opzioni:
+ **Conservazione**: la quantità di tempo necessaria per conservare i dati di Database Insights. L’impostazione del periodo di conservazione **Impostazione predefinita (7 giorni)**. Per mantenere i dati sulle prestazioni più a lungo, specifica da 1 a 24 mesi. Per altre informazioni sui periodi di conservazione, consulta [Prezzi e conservazione dei dati per Database Insights](USER_PerfInsights.Overview.cost.md).
+ **AWS KMS key**— Specifica il tuo AWS KMS key. Database Insights crittografa tutti i dati potenzialmente sensibili utilizzando la tua chiave KMS. I dati vengono crittografati mentre sono in transito o inattivi. Per ulteriori informazioni, consulta [ Modifica di una politica chiave KMS per Database Insights. ](USER_PerfInsights.access-control.cmk-policy.md)

**Abilitazione o disabilitazione di metriche dettagliate per query e contatore di database quando si modifica un cluster DB, un'istanza DB o un cluster  DB  **

Nella console, è possibile modificare  un cluster DB, un'istanza DB o  per gestire metriche dettagliate per query e contatore di Multi-AZ database per Database Insights.

**Per gestire metriche dettagliate per query e contatori di database per a cluster di database utilizzando la console**

1. Accedi Console di gestione AWS e apri la console Amazon RDS all'indirizzo [ https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Scegli **Database**.

1. Scegli un'istanza  e scegli ** Modifica**.

1. Seleziona ** Abilita la raccolta di metriche dettagliate per query e contatore di database ** per abilitarla. Per disattivarlo  per il tuo cluster DB, scegli l'opzione ** Database Insights — Standard ** e deseleziona l'opzione ** Abilita la raccolta di metriche dettagliate per query e contatore di database. **

   Se scegli ** Abilita la raccolta di metriche ** dettagliate per query e contatori di database, hai le seguenti opzioni:
   + **Conservazione**: la quantità di tempo necessaria per conservare i dati di Database Insights. L’impostazione del periodo di conservazione **Impostazione predefinita (7 giorni)**. Per mantenere i dati sulle prestazioni più a lungo, specifica da 1 a 24 mesi. Per altre informazioni sui periodi di conservazione, consulta [Prezzi e conservazione dei dati per Database Insights](USER_PerfInsights.Overview.cost.md).
   + **AWS KMS key**: specificare la chiave KMS. Database Insights crittografa tutti i dati potenzialmente sensibili utilizzando la chiave KMS. I dati vengono crittografati mentre sono in transito o inattivi. Per ulteriori informazioni, consulta [Crittografia Amazon Aurora risorse](Overview.Encryption.md).  
![Sezione Database Insights nella pagina di modifica del cluster DB, con la possibilità di abilitare metriche dettagliate del database.](https://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/db_insights_enabling.png)

1. Scegli **Continue** (Continua).

1. In **Scheduling of Modifications** (Pianificazione delle modifiche), scegli Apply immediately (Applica immediatamente). Se scegli Applica durante la successiva finestra di manutenzione pianificata, l'istanza ignora questa impostazione e attiva la raccolta immediata di metriche dettagliate per query e contatore del database.

1. Scegli **Modify instance (Modifica istanza)**.

------
#### [ AWS CLI ]

Quando usi il [AWS CLI comando ](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) create-db-instance, attiva le metriche dettagliate per query e contatore del database specificando e impostando uno o. `--enable-performance-insights` `--database-insights-mode` `advanced` `standard` Per disattivarli, specifica e impostali su. `--no-enable-performance-insights` `database-insights-mode` `standard`

È inoltre possibile specificare questi valori utilizzando i seguenti AWS CLI comandi:
+  [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) 
+  [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) 
+  [create-db-instance-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) 
+  [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) 
+  [restore-db-instance-from-s3](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-s3.html) 

**Per gestire metriche dettagliate per query e contatore di database per un cluster DB utilizzando AWS CLI**
+ Chiama il comando [ modify-db-cluster ](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) AWS CLI e fornisci i seguenti valori:
  + `--db-cluster-identifier` - Il nome dell'istanza database nel cluster di database.
  + `--enable-performance-insights` per attivare o `--no-enable-performance-insights` per disattivare
  + `database-insights-mode` - La modalità di Database Insights per il cluster di database. Per disattivare le metriche dettagliate per query e contatore del database, imposta questo valore su. `standard`

  L'esempio seguente attiva le metriche dettagliate per query e contatore del database per. `sample-db-cluster`

  Per Linux, macOS o Unix:

  ```
  aws rds modify-db-cluster \
  	--database-insights-mode standard \
      --db-cluster-identifier sample-db-instance \
      --enable-performance-insights
  ```

  Per Windows:

  ```
  aws rds modify-db-cluster ^
  	--database-insights-mode standard ^
      --db-cluster-identifier sample-db-instance ^
      --enable-performance-insights
  ```

Quando attivi le metriche dettagliate per query e per i contatori del database nella CLI, puoi facoltativamente specificare il numero di giorni per conservare i dati con l'opzione. `--performance-insights-retention-period` È possibile specificare`7`, {{month}} \* 31 (dove {{month}} è un numero compreso tra 1 e 23) o. `731` Ad esempio, se desideri mantenere i dati sulle prestazioni per 3 mesi, specifica `93`, che è 3 \* 31. L'impostazione di default è `7` giorni. Per altre informazioni sui periodi di conservazione, consulta [Prezzi e conservazione dei dati per Database Insights](USER_PerfInsights.Overview.cost.md).

L'esempio seguente attiva metriche dettagliate per query e contatore del database `sample-db-cluster` e specifica che i dati vengono conservati per 93 giorni (3 mesi).

Per Linux, macOS o Unix:

```
aws rds modify-db-cluster \
	--database-insights-mode standard \
    --db-cluster-identifier sample-db-instance \
    --enable-performance-insights \
    --performance-insights-retention-period 93
```

Per Windows:

```
aws rds modify-db-cluster ^
	--database-insights-mode standard ^
    --db-cluster-identifier sample-db-instance ^
    --enable-performance-insights ^
    --performance-insights-retention-period 93
```

Se il periodo di conservazione specificato, ad esempio 94 giorni, non è un valore valido, RDS genera un errore.

```
An error occurred (InvalidParameterValue) when calling the CreateDBInstance operation: 
Invalid Performance Insights retention period. Valid values are: [7, 31, 62, 93, 124, 155, 186, 217, 
248, 279, 310, 341, 372, 403, 434, 465, 496, 527, 558, 589, 620, 651, 682, 713, 731]
```

**Nota**  
È possibile attivare metriche dettagliate per query e contatore di database solo per un'istanza in un cluster DB in cui non sono gestite a livello di cluster.

------
#### [ RDS API ]

Quando crei una nuova istanza DB  nel tuo cluster DB  utilizzando l'[operazione ](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) CreateDBInstance Amazon RDS API, attiva le metriche dettagliate per query e contatore del database impostando su. `EnablePerformanceInsights` `True` Per disattivarli, imposta su e imposta su. `EnablePerformanceInsights` `False` `DatabaseInsightsMode` `standard`

Puoi anche specificare il valore `EnablePerformanceInsights` utilizzando le seguenti operazioni API:
+  [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) 
+  [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) 
+  [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) 
+  [CreateDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html) 
+  [RestoreDBInstanceFromS3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromS3.html) 

Quando si attivano le metriche dettagliate per query e contatore del database, è possibile specificare facoltativamente la quantità di tempo, in giorni, per conservare i dati con il parametro. `PerformanceInsightsRetentionPeriod` È possibile specificare`7`, {{month}} \* 31 (dove {{month}} è un numero compreso tra 1 e 23) o. `731` Ad esempio, se desideri mantenere i dati sulle prestazioni per 3 mesi, specifica `93`, che è 3 \* 31. L'impostazione di default è `7` giorni. Per altre informazioni sui periodi di conservazione, consulta [Prezzi e conservazione dei dati per Database Insights](USER_PerfInsights.Overview.cost.md).

------