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.

### Utilizzo di 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 ** Abilita Performance Insights ** nella sezione ** Performance Insights**.

**Istruzioni della console**

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

1. Seleziona ** Abilita Performance Insights ** nella sezione Performance Insights.  
![La sezione Performance Insights con l'opzione Abilita Performance Insights selezionata.](https://docs.aws.amazon.com/it_it/documentdb/latest/devguide/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, consulta 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 e apri Console di gestione AWS la console di 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 ** Abilita 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 at Rest. ](https://docs.aws.amazon.com/documentdb/latest/devguide/encryption-at-rest.html)

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 programmata**, l'istanza ignora questa impostazione e abilita immediatamente Performance Insights.

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

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

Quando utilizzi i `modify-db-instance` AWS AWS CLI comandi `create-db-instance` or, puoi abilitare Performance Insights `--enable-performance-insights` specificandolo o disabilitarlo specificando. `--no-enable-performance-insights`

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
```

------