Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Activation et désactivation de Performance Insights
<a name="performance-insights-enabling"></a>

Pour utiliser Performance Insights, vous devez l'activer sur votre instance de base de données. Vous pourrez le désactiver ultérieurement si nécessaire. L'activation et la désactivation de Performance Insights ne provoquent pas de temps d'arrêt, de redémarrage ou de basculement.

L’agent Performance Insights consomme une quantité limitée d’UC et de mémoire sur l’hôte de base de données. Lorsque la charge de base de données est élevée, l’agent limite l’impact sur les performances en collectant des données moins fréquemment.

## Activation de Performance Insights lors de la création d'un cluster
<a name="performance-insights-enabling-create-instance"></a>

Dans la console, vous pouvez activer ou désactiver Performance Insights lorsque vous créez ou modifiez une nouvelle instance de base de données.

### En utilisant le AWS Management Console
<a name="create-instance-console"></a>

Dans la console, vous pouvez activer Performance Insights lorsque vous créez un cluster Amazon DocumentDB. Lorsque vous créez un nouveau cluster Amazon DocumentDB, activez Performance Insights en choisissant **Enable Performance Insights** dans la section **Performance Insights**.

**Instructions relatives à la console**

1. Pour créer un cluster, suivez les instructions de [création d'un cluster Amazon DocumentDB.](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-create.html)

1. Sélectionnez **Activer Performance Insights** dans la section Performance Insights.  
![\[La section Performance Insights avec Enable Performance Insights sélectionnée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/select-performance-insights.png)
**Note**  
La période de conservation des données de Performance Insights sera de sept jours.

   ** AWS KMS clé** — Spécifiez votre clé AWS KMS. Performance Insights chiffre toutes les données potentiellement sensibles à l'aide de votre AWS KMS clé. Les données sont chiffrées en transit et au repos. Pour plus d'informations, consultez Configuration d'une AWS AWS KMS politique pour Performance Insights.

## Activation et désactivation lors de la modification d'une instance
<a name="performance-insights-enabling-modify-instance"></a>

Vous pouvez modifier une instance de base de données pour activer ou désactiver Performance Insights à l'aide de la console ou AWS CLI.

------
#### [ Using the AWS Management Console ]

**Instructions relatives à la console**

1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)

1. Choisissez **Clusters**.

1. Choisissez une instance de base de données, puis **Modifiez**.

1. Dans la section Performance Insights, choisissez **Enable Performance Insights** ou **Disable Performance Insights**.
**Note**  
Si vous choisissez **Enable Performance Insights**, vous pouvez spécifier votre AWS AWS KMS clé. Performance Insights chiffre toutes les données potentiellement sensibles à l'aide de votre AWS KMS clé. Les données sont chiffrées en transit et au repos. Pour plus d'informations, consultez la section [Chiffrement des données Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/encryption-at-rest.html) au repos.

1. Choisissez **Continuer**.

1. Pour **Scheduling of Modifications (Planification des modifications)**, choisissez **Appliquer immédiatement**. Si vous choisissez **Appliquer lors de la prochaine fenêtre de maintenance planifiée**, votre instance ignore ce paramètre et active immédiatement Performance Insights.

1. Choisissez **Modify instance** (Modifier l’instance).

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

Lorsque vous utilisez les `modify-db-instance` AWS AWS CLI commandes `create-db-instance` ou, vous pouvez activer Performance Insights en spécifiant`--enable-performance-insights`, ou le désactiver en spécifiant`--no-enable-performance-insights`.

La procédure suivante explique comment activer ou désactiver Performance Insights pour une instance de base de données à l'aide de l AWS AWS CLI.



**AWS AWS CLI instructions**

Appelez la `modify-db-instance` AWS AWS CLI commande et fournissez les valeurs suivantes :
+ `--db-instance-identifer`— Le nom de l'instance de base de données
+ `--enable-performance-insights` pour activer ou `--no-enable-performance-insights` pour désactiver

**Example**  
L'exemple suivant active Performance Insights pour `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
```

------