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

# Abilitazione e disattivazione di Performance Insights
<a name="performance-insights-enabling"></a>

Per utilizzare Performance Insights, è necessario attivarlo nell'istanza database. Puoi disabilitarlo in un secondo momento, se necessario. L'attivazione e la disattivazione di Performance Insights non determina tempi di inattività, riavvio o failover.

L'agente Performance 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.

## Abilitazione di Performance Insights durante la creazione di un cluster
<a name="performance-insights-enabling-create-instance"></a>

Nella console è possibile attivare o disattivare Performance Insights quando si crea o si modifica una nuova istanza DB.

### Utilizzando il Console di gestione AWS
<a name="create-instance-console"></a>

Nella console, puoi abilitare Performance Insights quando crei un cluster Amazon DocumentDB. Quando crei un nuovo cluster Amazon DocumentDB, abilita Performance Insights scegliendo **Enable Performance Insights nella sezione Performance** **Insights**.

**Istruzioni per la console**

1. Per creare un cluster, segui le istruzioni per la [creazione di un cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-create.html).

1. Seleziona **Abilita Performance Insights** nella sezione Performance Insights.  
![\[La sezione Performance Insights con l'opzione Abilita Performance Insights selezionata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/select-performance-insights.png)
**Nota**  
Il periodo di conservazione dei dati di Performance Insights sarà di sette giorni.

   ** AWS KMS chiave**: specifica la tua chiave AWS KMS. Performance Insights crittografa tutti i dati potenzialmente sensibili utilizzando la tua AWS KMS chiave. I dati vengono crittografati mentre sono in transito o inattivi. Per ulteriori informazioni, vedere Configurazione di una AWS AWS KMS policy per Performance Insights.

## Abilitazione e disabilitazione durante la modifica di un'istanza
<a name="performance-insights-enabling-modify-instance"></a>

È possibile modificare un'istanza DB per abilitare o disabilitare Performance Insights utilizzando la console o AWS CLI.

------
#### [ Using the Console di gestione AWS ]

**Istruzioni della console**

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

1. Scegli **Cluster**.

1. Scegliere un'istanza DB e scegliere **Modifica**.

1. Nella sezione Performance Insights, scegli **Abilita Performance Insights** o **Disabilita Performance Insights**.
**Nota**  
Se scegli **Enable Performance Insights**, puoi specificare la tua AWS AWS KMS chiave. Performance Insights crittografa tutti i dati potenzialmente sensibili utilizzando la tua AWS KMS chiave. I dati vengono crittografati mentre sono in transito o inattivi. Per ulteriori informazioni, [consulta Encrypting Amazon DocumentDB Data](https://docs.aws.amazon.com/documentdb/latest/developerguide/encryption-at-rest.html) at Rest.

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

1. In **Scheduling of Modifications (Pianificazione delle modifiche)**, scegliere **Apply immediately (Applica immediatamente)**. Se scegli **Applica durante la successiva finestra di manutenzione pianificata**, l'istanza ignora questa impostazione e abilita immediatamente Performance Insights.

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

------
#### [ Using the AWS CLI ]

Quando si utilizzano i `modify-db-instance` AWS AWS CLI comandi `create-db-instance` o, è possibile abilitare Performance Insights `--enable-performance-insights` specificando o disabilitarlo `--no-enable-performance-insights` specificando.

La seguente procedura descrive come attivare Performance Insights per un'istanza database utilizzando AWS AWS CLI.



**AWS AWS CLI istruzioni**

Chiamate il `modify-db-instance` AWS AWS CLI comando e fornite i seguenti valori:
+ `--db-instance-identifer`— Il nome dell'istanza DB
+ `--enable-performance-insights` per abilitare o `--no-enable-performance-insights` per disabilitare

**Example**  
L'esempio seguente abilita Performance Insights per`sample-db-instance`:  

```
aws docdb modify-db-instance \
    --db-instance-identifier sample-db-instance \
    --enable-performance-insights
```

```
aws docdb modify-db-instance ^
    --db-instance-identifier sample-db-instance ^
    --enable-performance-insights
```

------