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.
# Surveillance d'Amazon DocumentDB
La surveillance de vos AWS services joue un rôle important dans le maintien de la santé et du fonctionnement optimal de vos systèmes. Il est judicieux de collecter des données de surveillance provenant de toutes les parties de votre AWS solution afin de pouvoir plus facilement déboguer et corriger les défaillances ou les dégradations, le cas échéant. Avant de commencer à surveiller vos AWS solutions, nous vous recommandons de réfléchir aux questions suivantes et de formuler des réponses à ces questions :
+ Quels sont les objectifs de la surveillance ?
+ Quelles ressources allez-vous surveiller ?
+ Selon quelle fréquence allez-vous surveiller ces ressources ?
+ Quels outils de surveillance utiliser ?
+ Qui est responsable d'effectuer la surveillance ?
+ Qui doit être informé et par quels moyens en cas de problème ?
Pour comprendre vos modèles de performances actuelles, identifier les anomalies de rendement et formuler des méthodes pour régler les problèmes, vous devriez établir des mesures des performances de base pour diverses périodes et dans différentes conditions de charge. Lorsque vous surveillez votre AWS solution, nous vous recommandons de stocker vos données de surveillance historiques pour référence future et pour établir vos bases de référence.
En général, les valeurs acceptables pour les métriques de performances dépendent de vos données de référence et de l'activité de votre application. Enquêtez sur les écarts cohérents ou tendanciels de vos données de référence. Voici quelques conseils sur les types spécifiques de mesures :
+ **Utilisation élevée du processeur ou de la RAM** : des valeurs élevées d'utilisation du processeur ou de la RAM peuvent être appropriées, à condition qu'elles soient conformes aux objectifs de votre application (tels que le débit ou la simultanéité) et qu'elles soient attendues.
+ **Consommation du volume** de stockage : étudiez la consommation de stockage (`VolumeBytesUsed`) si l'espace utilisé est constamment égal ou supérieur à 85 % de l'espace total du volume de stockage. Déterminez s'il est possible de supprimer des données du volume de stockage ou d'archiver des données sur un système différent pour libérer de l'espace. Pour plus d’informations, consultez [Stockage Amazon DocumentDB](how-it-works.md#how-it-works.storage) et [Quotas et limites Amazon DocumentDB](limits.md).
+ **Trafic réseau** : pour le trafic réseau, contactez votre administrateur système afin de connaître le débit attendu pour le réseau de votre domaine et votre connexion Internet. Enquêtez sur le trafic réseau si le débit est constamment inférieur à vos attentes.
+ **Connexions aux bases** de données — Envisagez de restreindre les connexions aux bases de données si vous constatez un nombre élevé de connexions utilisateur associé à une baisse des performances et du temps de réponse des instances. Le bon nombre de connexions utilisateur pour votre instance dépendra de votre classe d'instance et de la complexité des opérations exécutées.
+ **Métriques d'IOPS** : les valeurs attendues pour les métriques d'IOPS dépendent des spécifications du disque et de la configuration du serveur. Utilisez donc votre base de référence pour déterminer ce qui est typique. Déterminer si les valeurs sont constamment différentes par rapport à vos données de référence. Pour de meilleures performances IOPS, veillez à ce que votre ensemble de travail typique puisse être chargé en mémoire pour minimiser les opérations de lecture et écriture.
Amazon DocumentDB (compatible avec MongoDB) fournit une variété de CloudWatch métriques Amazon que vous pouvez surveiller pour déterminer l'état et les performances de vos clusters et instances Amazon DocumentDB. Vous pouvez consulter les métriques Amazon DocumentDB à l'aide de différents outils, notamment la console Amazon DocumentDB AWS CLI CloudWatch , l'API et Performance Insights.
**Topics**
+ [Surveillance de l'état d'un cluster](monitoring_docdb-cluster_status.md)
+ [Surveillance de l'état d'une instance](monitoring_docdb-instance_status.md)
+ [Afficher les recommandations d'Amazon DocumentDB](view-docdb-recommendations.md)
+ [Abonnements aux événements](event-subscriptions.md)
+ [Surveillance d'Amazon DocumentDB avec CloudWatch](cloud_watch.md)
+ [Journalisation des appels d'API Amazon DocumentDB avec CloudTrail](logging-with-cloudtrail.md)
+ [Opérations de profilage](profiling.md)
+ [Surveillance avec Performance Insights](performance-insights.md)
# Surveillance de l'état d'un cluster Amazon DocumentDB
Le statut d'un cluster indique son état. Vous pouvez consulter l'état d'un cluster à l'aide de la console Amazon DocumentDB ou de la AWS CLI `describe-db-clusters` commande.
**Topics**
+ [Valeurs d'état du cluster](#monitoring_docdb-status_values)
+ [Surveillance de l'état d'un cluster](#monitor-cluster-status)
## Valeurs d'état du cluster
Le tableau suivant répertorie les valeurs valides pour le statut d'un cluster.
| Statut du cluster | Description |
| --- | --- |
| active | Le cluster est actif. Ce statut s'applique uniquement aux clusters élastiques. |
| available | Le cluster est sain et disponible. Ce statut s'applique uniquement aux clusters basés sur des instances. |
| backing-up | Le cluster est en cours de sauvegarde. |
| creating | Le cluster est en cours de création. Il n'est pas accessible pendant sa création. |
| deleting | Le cluster est en cours de suppression. Il n'est pas accessible pendant sa suppression. |
| failing-over | Un basculement de l'instance principale vers une réplique Amazon DocumentDB est en cours d'exécution. |
| inaccessible-encryption-credentials | La AWS KMS clé utilisée pour chiffrer ou déchiffrer le cluster n'est pas accessible. |
| maintenance | Une mise à jour de maintenance est appliquée au cluster. Ce statut est utilisé pour la maintenance au niveau du cluster qu'Amazon DocumentDB planifie bien à l'avance. |
| migrating | Un instantané de cluster est en cours de restauration à partir d'un cluster. |
| migration-failed | Échec d’une migration. |
| modifying | Le cluster est en cours de modification en raison d'une demande du client de modification du cluster. |
| renaming | Le cluster est actuellement renommé en raison d'une demande du client pour le renommer. |
| resetting-master-credentials | Les informations d'identification principales du cluster sont en cours de réinitialisation, en raison d'une demande du client pour les réinitialiser. |
| upgrading | La version du moteur du cluster est en cours de mise à niveau. |
## Surveillance de l'état d'un cluster
------
#### [ Using the AWS Management Console ]
Lorsque vous utilisez le AWS Management Console pour déterminer l'état d'un cluster, suivez la procédure suivante.
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. Dans le panneau de navigation, choisissez **Clusters**.
1. Dans la boîte de navigation Clusters, vous verrez la colonne **Identifiant du cluster**. Vos instances sont répertoriées sous des clusters, comme dans la capture d'écran ci-dessous.
![\[Tableau des clusters indiquant comment une instance est imbriquée sous un cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/choose-clusters.png)
1. Dans la colonne **Identifiant du cluster**, recherchez le nom de l'instance qui vous intéresse. Ensuite, pour connaître le statut de l'instance, parcourez cette ligne jusqu'à la colonne **Status**, comme indiqué ci-dessous.
![\[Instance de cluster affichant le statut disponible.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cluster-status-con.png)
------
#### [ Using the AWS CLI ]
Lorsque vous utilisez le AWS CLI pour déterminer l'état d'un cluster, utilisez l'`describe-db-clusters`opération. Le code suivant trouve le statut du cluster `sample-cluster`.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Pour Windows :
```
aws docdb describe-db-clusters ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Le résultat de cette opération ressemble à ceci.
```
[
[
"sample-cluster",
"available"
]
]
```
------
# Surveillance de l'état d'une instance Amazon DocumentDB
Amazon DocumentDB fournit des informations sur l'état actuel de chaque instance configurée dans la base de données.
Il existe trois types de statut que vous pouvez consulter pour une instance Amazon DocumentDB :
+ État de l'instance : cet état est affiché dans la colonne **État** du tableau du cluster dans le AWS Management Console et indique l'état actuel du cycle de vie de l'instance. Les valeurs affichées dans la colonne **Status** sont dérivées du `Status` champ de la réponse de l'`DescribeDBCluster`API.
+ État de santé de l'instance : cet état apparaît dans la colonne État de l'**instance** du tableau du cluster dans le AWS Management Console et indique si le moteur de base de données, le composant responsable de la gestion et de la récupération des données, est en cours d'exécution. Les valeurs affichées dans la colonne **État de l'instance** sont basées sur la métrique CloudWatch `EngineUptime` du système Amazon.
+ État de maintenance : cet état est affiché dans la colonne **Maintenance** du tableau du cluster dans le AWS Management Console et indique l'état de tout événement de maintenance devant être appliqué à une instance. Le statut de maintenance est indépendant du statut des autres instances et est dérivé de l'`PendingMaintenanceAction`API. Pour plus d'informations sur l'état de maintenance, consultez [Maintenance d'Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html).
**Topics**
+ [Valeurs de l’état d'instance](#monitoring_docdb-instance_status-values)
+ [Surveillance de l'état de l'instance à l'aide du AWS Management Console ou AWS CLI](#monitoring-instance-status)
+ [Valeurs de l'état de santé de l'instance](#instance-health-status-values)
+ [Surveillance de l'état de santé de l'instance à l'aide du AWS Management Console](#monitoring-instance-health-status)
## Valeurs de l’état d'instance
Le tableau suivant répertorie les valeurs de statut possibles pour les instances et la façon dont vous êtes facturé pour chaque statut. Il indique si vous serez facturé pour l'instance et le stockage, uniquement pour le stockage, ou si vous ne serez pas facturé. Pour tous les statuts d'instance, vous êtres toujours facturé pour l'utilisation de la sauvegarde.
| état de l’instance | Facturé | Description |
| --- | --- | --- |
| available | Facturé | L'instance est saine et disponible. |
| backing-up | Facturé | L'instance est en cours de sauvegarde. |
| configuring-log-exports | Facturé | La publication de fichiers CloudWatch journaux sur Amazon Logs est activée ou désactivée pour cette instance. |
| creating | Non facturé | L'instance est en cours de création. L'instance n'est pas accessible pendant sa création. |
| deleting | Non facturé | L'instance est en cours de suppression. |
| failed | Non facturé | L'instance a échoué et Amazon DocumentDB n'a pas pu la récupérer. Pour récupérer les données, effectuez une point-in-time restauration à la date de restauration la plus récente de l'instance. |
| inaccessible-encryption-credentials | Non facturé | Impossible d'accéder à la AWS KMS clé utilisée pour chiffrer ou déchiffrer l'instance. |
| incompatible-network | Non facturé | Amazon DocumentDB tente d'effectuer une action de restauration sur une instance mais n'y parvient pas car le VPC est dans un état qui empêche l'exécution de l'action. Ce statut peut se produire si, par exemple, toutes les adresses IP disponibles dans un sous-réseau étaient utilisées et qu'Amazon DocumentDB n'a pas pu obtenir d'adresse IP pour l'instance. |
| maintenance | Facturé | Amazon DocumentDB applique une mise à jour de maintenance à l'instance. Ce statut est utilisé pour la maintenance au niveau de l'instance qu'Amazon DocumentDB planifie bien à l'avance. Nous avons évalué des façons d'exposer davantage d'actions de maintenance aux clients par le biais de cet état. |
| modifying | Facturé | L'instance est en cours de modification en raison d'une demande de modification de l'instance. |
| rebooting | Facturé | L'instance est redémarrée en raison d'une demande ou d'un processus Amazon DocumentDB qui nécessite le redémarrage de l'instance. |
| renaming | Facturé | L'instance est en cours d'être renommée en raison d'une demande pour la renommer. |
| resetting-master-credentials | Facturé | Les informations d'identification principales de l'instance sont en cours de réinitialisation en raison d'une demande pour les réinitialiser. |
| restore-error | Facturé | L'instance a rencontré une erreur lors de la tentative de restauration depuis point-in-time ou vers un instantané. |
| starting | Facturé pour stockage | L'instance démarre. |
| stopped | Facturé pour stockage | L'instance est arrêtée. |
| stopping | Facturé pour stockage | L'instance est en cours d'arrêt. |
| storage-full | Facturé | L'instance a atteint son attribution de capacité de stockage. Il s'agit d'un état critique, qui doit être corrigé immédiatement ; augmentez votre stockage en modifiant l'instance. Configurez les CloudWatch alarmes Amazon pour qu'elles vous avertissent lorsque l'espace de stockage est insuffisant afin de ne pas vous retrouver dans cette situation. |
## Surveillance de l'état de l'instance à l'aide du AWS Management Console ou AWS CLI
Utilisez le AWS Management Console ou AWS CLI pour surveiller le statut de votre instance.
------
#### [ Using the AWS Management Console ]
Lorsque vous utilisez le AWS Management Console pour déterminer l'état d'un cluster, suivez la procédure suivante.
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. Dans le panneau de navigation, choisissez **Clusters**.
**Note**
Notez que dans la zone de navigation Clusters, la colonne **Identifiant du cluster** indique à la fois les clusters et les instances. Les instances sont répertoriées sous les clusters, comme dans l'image ci-dessous.
![\[Liste des clusters et des instances sur la page Clusters de la console Amazon DocumentDB.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/clusters.png)
1. Trouvez le nom de l'instance qui vous intéresse. Ensuite, pour trouver le statut de l'instance, lire dans cette ligne à la colonne **Statut**, comme ci-dessous.
![\[Colonne d'état indiquant l'état disponible pour les clusters et les instances sur la page Clusters.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/instance-status.png)
------
#### [ Using the AWS CLI ]
Lorsque vous utilisez le AWS CLI pour déterminer l'état d'un cluster, utilisez l'`describe-db-instances`opération. Le code suivant trouve le statut de l'instance `sample-cluster-instance-01`.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance-01 \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]'
```
Pour Windows :
```
aws docdb describe-db-instances ^
--db-instance-identifier sample-cluster-instance-01 ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]'
```
Le résultat de cette opération ressemble à ceci.
```
[
[
"sample-cluster-instance-01",
"available"
]
]
```
------
## Valeurs de l'état de santé de l'instance
Le tableau suivant répertorie les valeurs d'état de santé possibles pour les instances. La colonne État **de l'instance**, située dans le tableau des **clusters** du AWS Management Console, indique si le moteur de base de données, le composant responsable du stockage, de la gestion et de la récupération des données, fonctionne normalement. Cette colonne indique également si la métrique du `EngineUptime` système, disponible dans CloudWatch, indique l'état de santé de chaque instance.
| État d'une instance | Description |
| --- | --- |
| sain | Le moteur de base de données est en cours d'exécution dans l'instance Amazon DocumentDB. |
| mauvais pour la santé | Le moteur de base de données ne fonctionne pas ou a redémarré il y a moins d'une minute. |
## Surveillance de l'état de santé de l'instance à l'aide du AWS Management Console
Utilisez le AWS Management Console pour surveiller l'état de santé de votre instance.
Lors de l'utilisation AWS Management Console, suivez les étapes suivantes pour comprendre l'état de santé de l'instance.
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. Dans le panneau de navigation, choisissez **Clusters**.
**Note**
Dans la zone de navigation **Clusters**, la colonne **Identifiant du cluster** indique à la fois les clusters et les instances. Les instances sont répertoriées sous les clusters, comme dans l'image ci-dessous.
![\[Liste des clusters et des instances sur la page Clusters de la console Amazon DocumentDB.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/clusters.png)
1. Trouvez le nom de l'instance qui vous intéresse. Ensuite, pour connaître l'état de l'instance, parcourez cette ligne jusqu'à la colonne État de l'**instance**, comme indiqué dans l'image suivante :
![\[Colonne d'état de l'instance indiquant les états sains et non sains des instances répertoriées sur la page Clusters.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/health-status-1.png)
**Note**
L'état de santé de l'instance est interrogé toutes les 60 secondes en fonction de la métrique CloudWatch `EngineUptime` du système. Les valeurs de la colonne État de **l'instance** sont automatiquement mises à jour.
# Afficher les recommandations d'Amazon DocumentDB
Amazon DocumentDB fournit une liste de recommandations automatisées pour les ressources de base de données, telles que les instances et les clusters. Ces recommandations fournissent des conseils sur les meilleures pratiques en analysant les configurations de votre cluster et de votre instance.
À titre d'exemple de ces recommandations, consultez les pages suivantes :
| Type | Description | Recommandation | Informations supplémentaires |
| --- | --- | --- | --- |
| Une instance | Le cluster ne contient qu'une seule instance | Performances et disponibilité : nous vous recommandons d'ajouter une autre instance avec la même classe d'instance dans une autre zone de disponibilité. | [Haute disponibilité et réplication d'Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/replication.html) |
Amazon DocumentDB génère des recommandations pour une ressource lorsque celle-ci est créée ou modifiée. Amazon DocumentDB analyse également régulièrement vos ressources et génère des recommandations.
**Pour consulter les recommandations d'Amazon DocumentDB et prendre les mesures nécessaires**
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. Dans le volet de navigation, sélectionnez **Recommandations** :
![\[Volet de navigation de la console Amazon DocumentDB avec l'option Recommandations sélectionnée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/recommendations-nav-1.png)
1. Dans la boîte de dialogue **Recommandations**, développez la section qui vous intéresse et sélectionnez la tâche recommandée.
Dans l'exemple ci-dessous, la tâche recommandée s'applique à un cluster Amazon DocumentDB avec une seule instance. Il est recommandé d'ajouter une autre instance pour améliorer les performances et la disponibilité.
![\[Le formulaire de recommandations affiche une tâche recommandée sélectionnée pour un cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/recommendations-1.png)
1. Cliquez sur **Appliquer maintenant**.
Pour cet exemple, la boîte de dialogue **Ajouter des instances** apparaît :
![\[Le formulaire Ajouter des instances avec des options pour les paramètres des instances.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/add-instances-1.png)
1. Modifiez les paramètres de votre nouvelle instance et cliquez sur **Créer**.
# Utilisation des abonnements aux événements Amazon DocumentDB
Amazon DocumentDB utilise Amazon Simple Notification Service (Amazon SNS) pour envoyer des notifications lorsqu'un événement Amazon DocumentDB se produit. Ces notifications peuvent prendre n'importe quelle forme prise en charge par Amazon SNS, par exemple un e-mail Région AWS, un message texte ou un appel à un point de terminaison HTTP.
Amazon DocumentDB regroupe ces événements dans des catégories auxquelles vous pouvez vous abonner afin d'être averti lorsqu'un événement de cette catégorie se produit. Vous pouvez vous abonner à une catégorie d'événements pour une instance, un cluster, un instantané, un instantané de cluster ou un groupe de paramètres. Par exemple, si vous vous abonnez à la catégorie Backup pour une instance donnée, vous êtes averti chaque fois qu'un événement lié à la sauvegarde affecte l'instance. Vous recevez également une notification en cas de modification de l'abonnement à un événement.
Les événements se produisent à la fois au niveau du cluster et de l'instance. Vous pouvez donc recevoir des événements si vous vous abonnez à un cluster ou à une instance.
Les abonnements aux événements sont envoyés aux adresses que vous avez fournies lors de la création de l'abonnement. Vous souhaiterez peut-être créer plusieurs abonnements différents, tels qu'un abonnement qui reçoit toutes les notifications d'événements et un autre qui inclut uniquement les événements critiques pour vos instances de production. Vous pouvez facilement désactiver les notifications sans supprimer d'abonnement. Pour ce faire, réglez le bouton radio **Enabled** sur **Non** dans la console Amazon DocumentDB.
**Important**
Amazon DocumentDB ne garantit pas l'ordre des événements envoyés dans un flux d'événements. L’ordre des événements est susceptible de changer.
Amazon DocumentDB utilise le nom de ressource Amazon (ARN) d'une rubrique Amazon SNS pour identifier chaque abonnement. La console Amazon DocumentDB crée l'ARN pour vous lorsque vous créez l'abonnement.
La facturation des abonnements aux événements Amazon DocumentDB s'effectue via Amazon SNS. Des frais Amazon SNS s’appliquent en cas d’utilisation de la notification d’événement. Pour plus d'informations, consultez Tarification Amazon Simple Notification Service. Hormis les frais Amazon SNS, Amazon DocumentDB ne facture pas les abonnements aux événements.
**Topics**
+ [Abonnement aux événements](event-subscriptions.subscribe.md)
+ [Gérer les abonnements](event-subscriptions.managing.md)
+ [Catégories et messages](event-subscriptions.categories-messages.md)
# Abonnement aux événements Amazon DocumentDB
Vous pouvez utiliser la console Amazon DocumentDB pour vous abonner à des événements, comme suit :
1. Connectez-vous à l' AWS Management Console adresse[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Dans le panneau de navigation, choisissez **Abonnements aux événements**.
![\[Volet de navigation de la console Amazon DocumentDB avec l'option d'abonnement aux événements surlignée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/subscribe-event-subs.png)
1. Dans le volet **Abonnements aux événements**, choisissez **Créer un abonnement aux événements**.
![\[Le volet Abonnements aux événements met en évidence le bouton Créer un abonnement à un événement dans le coin supérieur droit.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/subscribe-create.png)
1. Dans la boîte de dialogue **Créer un abonnement aux événements**, exécutez l'une des actions suivantes :
+ Dans le champ **Nom**, entrez un nom pour l'abonnement à la notification d'événements.
![\[Le formulaire d'inscription à un événement présentant la section Détails et le champ de saisie du nom.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/subscribe-name.png)
+ Pour **Target**, choisissez l'adresse à laquelle vous souhaitez envoyer les notifications. Vous pouvez choisir un **ARN** existant ou choisir **Nouveau sujet d'e-mail** pour saisir le nom d'un sujet et une liste de destinataires.
![\[La section Cible contient des options permettant de spécifier à qui envoyer les notifications.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/subscribe-target.png)
+ Pour **Source**, choisissez un type de source. Selon le type de source que vous avez sélectionné, choisissez les catégories d'événement et les sources pour lesquelles vous souhaitez recevoir des notifications d'événements.
![\[La section Source permet de sélectionner le type de source dont vous souhaitez recevoir les notifications d'événements.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/subscribe-source.png)
+ Choisissez **Créer**.
![\[La section Source avec le bouton Créer dans le coin inférieur droit.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/subscribe-create-2.png)
# Gestion des abonnements aux notifications d'événements Amazon DocumentDB
Si vous choisissez **Abonnements aux événements** dans le volet de navigation de la console Amazon DocumentDB, vous pouvez consulter les catégories d'abonnement et la liste de vos abonnements actuels. Vous pouvez également modifier ou supprimer un abonnement spécifique.
## Pour modifier vos abonnements actuels aux notifications d'événements Amazon DocumentDB
1. Connectez-vous à l' AWS Management Console adresse[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Dans le panneau de navigation, choisissez **Abonnements aux événements**. Le volet **Abonnements aux événements** affiche tous les abonnements aux notifications d’événements.
![\[Volet de navigation de la console Amazon DocumentDB avec l'option d'abonnement aux événements surlignée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/modify-event-subs.png)
1. Dans le volet **Abonnements aux événements**, choisissez l’abonnement que vous voulez modifier, puis choisissez **Modifier**.
![\[Le volet Abonnements aux événements affichant un abonnement sélectionné et le bouton Modifier.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/modify-edit.png)
1. Apportez les modifications requises à l’abonnement dans la section **Cible** ou **Source**. Vous pouvez ajouter ou supprimer des identifiants sources en les sélectionnant ou en annulant leur sélection dans la section Source.
![\[Le formulaire de modification de l'abonnement à un événement met en évidence la section Cible.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/modify-target.png)
1. Sélectionnez **Modifier**. La console Amazon DocumentDB indique que l'abonnement est en cours de modification.
![\[Fin du formulaire d'inscription à un événement Modifier avec le bouton Modifier surligné.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/modify-button.png)
## Supprimer un abonnement aux notifications d'événements Amazon DocumentDB
Vous pouvez supprimer un abonnement lorsque vous n’en avez plus besoin. Tous les abonnés à la rubrique ne reçoivent plus les notifications d’événements spécifiées par l’abonnement.
1. Connectez-vous à l' AWS Management Console adresse[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Dans le panneau de navigation, choisissez **Abonnements aux événements**.
![\[Volet de navigation de la console Amazon DocumentDB avec l'option d'abonnement aux événements surlignée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/delete-event-subs.png)
1. Dans le volet **Mes abonnements aux événements de base de données**, cliquez sur l'abonnement que vous souhaitez supprimer.
![\[Le volet Abonnements aux événements affiche un abonnement sélectionné.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/delete-select.png)
1. Sélectionnez **Delete (Supprimer)**.
![\[Le volet Abonnements aux événements met en évidence le bouton Supprimer.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/delete-delete.png)
1. Une fenêtre contextuelle apparaît pour vous demander si vous souhaitez supprimer définitivement cette notification. Sélectionnez **Delete (Supprimer)**.
![\[Une boîte de dialogue confirmant la suppression de l'abonnement à l'événement avec le bouton Supprimer surligné dans le coin inférieur droit.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/delete-delete-2.png)
# Catégories d'événements et messages Amazon DocumentDB
Amazon DocumentDB génère un nombre important d'événements dans des catégories auxquelles vous pouvez vous abonner à l'aide de la console. Chaque catégorie s'applique à un type de source, qui peut être une instance, un cluster, un instantané ou un groupe de paramètres.
**Note**
Amazon DocumentDB utilise les définitions d'événements Amazon RDS existantes et. IDs
## Événements Amazon DocumentDB provenant d'instances
| Catégorie | Description |
| --- | --- |
| disponibilité | L'instance a redémarré. |
| disponibilité | L'arrêt de l'instance. |
| modification de configuration | Appliquer une modification à une classe d'instance. |
| modification de configuration | L'application de la modification à une classe d'instance est terminée. |
| modification de configuration | Réinitialisez les informations d'identification principales. |
| création | Instance créée. |
| suppression | Instance supprimée |
| échec | L'instance a échoué en raison d'une configuration incompatible ou d'un problème de stockage sous-jacent. Commencez par point-in-time-restore pour l'instance. |
| notification | Instance arrêtée. |
| notification | Instance démarrée. |
| notification | L'instance est en cours de démarrage car le temps d'arrêt maximal autorisé est dépassé. |
| ponctuelle | La restauration de l'instance a commencé. Le temps de récupération varie selon la quantité de données à restaurer. |
| ponctuelle | La restauration de l'instance est terminée. |
| application de correctifs de sécurité | La mise à jour du système d'exploitation est disponible pour votre instance. Pour plus d'informations sur l'application des mises à jour, consultez [Maintenance d'Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html). |
## Événements Amazon DocumentDB provenant d'un cluster
| Catégorie | Description |
| --- | --- |
| création | Cluster créé |
| suppression | Cluster supprimé. |
| basculement | Promouvoir à nouveau les primaires précédentes. |
| basculement | Le basculement vers l'instance est terminé. |
| basculement | Basculement commencé vers l'instance de base de données : %s |
| basculement | Démarrage du même basculement AZ vers l'instance de base de données : %s |
| basculement | Basculement inter-AZ lancé vers l'instance de base de données : %s |
| maintenance | Le cluster a été corrigé. |
| maintenance | Le cluster de base de données est dans un état qui ne peut pas être mis à niveau : %s |
| notification | Le cluster s'est arrêté. |
| notification | Le cluster a démarré. |
| notification | L'arrêt du cluster a échoué. |
| notification | Le cluster est en cours de démarrage car le temps d'arrêt maximal autorisé est dépassé. |
| notification | Cluster renommé de %s à %s. |
## Événements Amazon DocumentDB provenant d'un instantané du cluster
Le tableau suivant indique la catégorie d'événements et la liste des événements dont le type de source est un instantané de cluster Amazon DocumentDB.
| Catégorie | Description |
| --- | --- |
| sauvegarde | Création d'un instantané de cluster manuel. |
| sauvegarde | Instantané de cluster manuel créé. |
| sauvegarde | Création d'instantané de cluster automatisé. |
| sauvegarde | Instantané de cluster automatisé créé. |
## Événements Amazon DocumentDB provenant d'un groupe de paramètres
Le tableau suivant affiche la catégorie d’événement et la liste d’événements quand un groupe de paramètres est le type source.
| Catégorie | Description |
| --- | --- |
| modification de configuration | Paramètre %s mis à jour vers %s avec la méthode d'application %s |
# Surveillance d'Amazon DocumentDB avec CloudWatch
Amazon DocumentDB (compatible avec MongoDB) s'intègre à Amazon CloudWatch afin que vous puissiez collecter et analyser les métriques opérationnelles de vos clusters. Vous pouvez surveiller ces métriques à l'aide de la CloudWatch console, de la console Amazon DocumentDB, du AWS Command Line Interface (AWS CLI) ou de l' CloudWatchAPI.
CloudWatch vous permet également de définir des alarmes afin d'être averti si une valeur métrique dépasse un seuil que vous spécifiez. Vous pouvez même configurer Amazon CloudWatch Events pour prendre des mesures correctives en cas de violation. Pour plus d'informations sur l'utilisation CloudWatch et les alarmes, consultez la [ CloudWatch documentation Amazon](https://docs.aws.amazon.com/cloudwatch/index.html).
**Topics**
+ [Métriques Amazon DocumentDB](#cloud_watch-metrics_list)
+ [Visualisation CloudWatch des données](#cloud_watch-view_data)
+ [Dimensions d'Amazon DocumentDB](#cloud_watch-metrics_dimensions)
+ [Surveillance des métriques d'Opcounter](#cloud_watch-monitoring_opcounters)
+ [Surveillance des connexions à la base de données](#cloud_watch-monitoring_connections)
## Métriques Amazon DocumentDB
Pour surveiller l'état et les performances de votre cluster et de vos instances Amazon DocumentDB, vous pouvez consulter les mesures suivantes dans la console Amazon DocumentDB.
**Note**
Les mesures présentées dans les tableaux suivants s'appliquent à la fois aux clusters basés sur des instances et aux clusters élastiques.
**Topics**
+ [Métriques d'utilisation des ressources](#resource-utilization)
+ [Métriques de latence](#latency-metrics)
+ [NVMe-métriques d'instance soutenues](#nvme-metrics)
+ [Métriques des opérations](#operations-metrics)
+ [Métriques de débit](#throughput-metrics)
+ [Métriques du système](#system-metrics)
+ [Métriques de l'instance T3](#t3-instance-metrics)
### Métriques d'utilisation des ressources
| Métrique | Description |
| --- | --- |
| BackupRetentionPeriodStorageUsed | La quantité totale de stockage de sauvegarde en octets utilisée pour prendre en charge la fonctionnalité de point-in-time restauration dans le cadre de la fenêtre de rétention d'Amazon DocumentDB. Incluse dans le total indiqué par la métrique TotalBackupStorageBilled. Calculée séparément pour chaque cluster Amazon DocumentDB. |
| ChangeStreamLogSize | Quantité de stockage (en Mo) utilisée par votre cluster pour stocker le journal du flux de modifications. Cette valeur est un sous-ensemble du stockage total du cluster (VolumeBytesUsed) et affecte le coût du cluster. Pour obtenir des informations sur les tarifs du stockage, consultez la [page produit Amazon DocumentDB](https://aws.amazon.com//documentdb/pricing). La taille du journal du flux de modifications est fonction de la quantité de modifications qui se produisent sur votre cluster et de la longue durée de rétention du flux de modifications. Pour de plus amples informations sur les flux de modifications, veuillez consulter [Utilisation de flux de modifications avec Amazon DocumentDB](change_streams.md). |
| CPUUtilization | Pourcentage de l'UC utilisé par une instance. |
| DatabaseConnections | Le nombre de connexions (actives et inactives) ouvertes sur une instance prise à une fréquence d'une minute. |
| DatabaseConnectionsMax | Nombre maximal de connexions de base de données ouvertes (actives et inactives) sur une instance sur une période d'une minute. |
| DatabaseConnectionsLimit | Nombre maximal de connexions simultanées à la base de données (actives et inactives) autorisées sur une instance à un moment donné. |
| DatabaseCursors | Le nombre de curseurs ouverts sur une instance prise à une fréquence d'une minute. |
| DatabaseCursorsMax | Le nombre maximum de curseurs ouverts sur une instance sur une période d'une minute. |
| DatabaseCursorsLimit | Le nombre maximum de curseurs autorisés sur une instance à un moment donné. |
| DatabaseCursorsTimedOut | Le nombre de curseurs dont le délai a expiré sur une période d'une minute. |
| FreeableMemory | Quantité de mémoire vive disponible, en octets. |
| FreeLocalStorage | Cette métrique indique la quantité de stockage accessible à chaque instance pour les journaux et les tables temporaires. Cette valeur dépend de la classe d'instance. Vous pouvez augmenter la quantité d'espace de stockage libre pour une instance en choisissant une classe d'instance plus grande pour votre instance. (Cela ne s'applique pas à DocumentDB Serverless.) |
| LowMemThrottleQueueDepth | La profondeur de la file d'attente pour les demandes limitées en raison d'une faible quantité de mémoire disponible traitées à une fréquence d'une minute. |
| LowMemThrottleMaxQueueDepth | Profondeur de file d'attente maximale pour les demandes limitées en raison d'un manque de mémoire disponible sur une période d'une minute. |
| LowMemNumOperationsThrottled | Nombre de demandes limitées en raison d'un manque de mémoire disponible sur une période d'une minute. |
| SnapshotStorageUsed | Quantité totale de stockage de sauvegarde en octets consommée par tous les instantanés d'un cluster Amazon DocumentDB donné en dehors de sa fenêtre de conservation des sauvegardes. Incluse dans le total indiqué par la métrique TotalBackupStorageBilled. Calculée séparément pour chaque cluster Amazon DocumentDB. |
| SwapUsage | Quantité d'espace d'échange utilisé sur l'instance. |
| TotalBackupStorageBilled | La quantité totale de stockage de sauvegarde en octets pour laquelle vous êtes facturé pour un cluster Amazon DocumentDB donné. Inclut le stockage de sauvegarde mesuré par les métriques BackupRetentionPeriodStorageUsed et SnapshotStorageUsed. Calculée séparément pour chaque cluster Amazon DocumentDB. |
| TransactionsOpen | Le nombre de transactions ouvertes sur une instance prise toutes les 1 minute. |
| TransactionsOpenMax | Le nombre maximum de transactions ouvertes sur une instance au cours d'une période d'une minute. |
| TransactionsOpenLimit | Le nombre maximum de transactions simultanées autorisées sur une instance à un moment donné. |
| VolumeBytesUsed | Volume de stockage, en octets, utilisé par votre cluster. Cette valeur a une incidence sur le coût du cluster. Pour obtenir des informations sur les tarifs, consultez la [page produit Amazon DocumentDB](https://aws.amazon.com//documentdb/pricing). |
### Métriques de latence
| Métrique | Description |
| --- | --- |
| DBClusterReplicaLagMaximum | Le délai maximal, en millisecondes, entre l'instance principale et chaque instance Amazon DocumentDB du cluster. |
| DBClusterReplicaLagMinimum | Durée minimale du retard, millisecondes, entre l'instance principale et chaque instance de réplica dans le cluster. |
| DBInstanceReplicaLag | La durée du retard, en millisecondes, lors de la réplication des mises à jour à partir de l'instance principale vers une instance de réplica. |
| ReadLatency | Durée moyenne par I/O opération sur le disque. |
| WriteLatency | Durée moyenne, en millisecondes, nécessaire à chaque opération sur le disque. I/O |
### NVMe-métriques d'instance soutenues
| Métrique | Description |
| --- | --- |
| NVMeStorageCacheHitRatio | Pourcentage de demandes traitées par le cache hiérarchisé. |
| FreeNVMeStorage | La quantité de stockage éphémère NVMe disponible. |
| ReadIOPSNVMeStorage | Nombre moyen d' I/O opérations de lecture du disque vers le stockage éphémère NVMe . |
| ReadLatencyNVMeStorage | Durée moyenne par I/O opération de lecture sur disque pour le stockage éphémère NVMe . |
| ReadThroughputNVMeStorage | Nombre moyen d'octets lus sur le disque par seconde pour le stockage éphémère NVMe . |
| WriteIOPSNVMeStorage | Nombre moyen d' I/O opérations d'écriture sur disque dans le stockage éphémère NVMe . |
| WriteLatencyNVMeStorage | Durée moyenne par I/O opération d'écriture sur disque pour le stockage éphémère NVMe . |
| WriteThroughputNVMeStorage | Nombre moyen d'octets écrits sur le disque par seconde pour le stockage éphémère NVMe . |
### Métriques des opérations
| Métrique | Description |
| --- | --- |
| DocumentsDeleted | Le nombre de documents supprimés sur une période d'une minute. |
| DocumentsInserted | Le nombre de documents insérés au cours d'une période d'une minute. |
| DocumentsReturned | Le nombre de documents renvoyés sur une période d'une minute. |
| DocumentsUpdated | Le nombre de documents mis à jour sur une période d'une minute. |
| OpcountersCommand | Le nombre de commandes émises au cours d'une période d'une minute. |
| OpcountersDelete | Nombre d'opérations de suppression effectuées au cours d'une période d'une minute. |
| OpcountersGetmore | Le nombre de getmores émis sur une période d'une minute. |
| OpcountersInsert | Nombre d'opérations d'insertion effectuées au cours d'une période d'une minute. |
| OpcountersQuery | Le nombre de requêtes émises au cours d'une période d'une minute. |
| OpcountersUpdate | Nombre d'opérations de mise à jour effectuées au cours d'une période d'une minute. |
| TransactionsStarted | Le nombre de transactions démarrées sur une instance au cours d'une période d'une minute. |
| TransactionsCommitted | Le nombre de transactions validées sur une instance au cours d'une période d'une minute. |
| TransactionsAborted | Le nombre de transactions abandonnées sur une instance au cours d'une période d'une minute. |
| TTLDeletedDocuments | Le nombre de documents supprimés par a sur une TTLMonitor période d'une minute. |
### Métriques de débit
| Métrique | Description |
| --- | --- |
| NetworkReceiveThroughput | Quantité de débit réseau reçue des clients par chaque instance du cluster de base de données, en octets par seconde. Ce débit n'inclut pas le trafic réseau entre les instances du cluster et le volume de cluster. |
| NetworkThroughput | Le débit réseau, en octets par seconde, reçu et transmis aux clients par chaque instance du cluster Amazon DocumentDB. Ce débit n'inclut pas le trafic réseau entre les instances du cluster et le volume de cluster. |
| NetworkTransmitThroughput | Quantité de débit réseau envoyée aux clients par chaque instance du cluster, en octets par seconde. Ce débit n'inclut pas le trafic réseau entre les instances du cluster et le volume de cluster. |
| ReadIOPS | Nombre moyen d' I/O opérations de lecture sur disque par seconde. Amazon DocumentDB signale les IOPS en lecture et en écriture séparément, à intervalles d'une minute. |
| ReadThroughput | Nombre moyen d’octets lus sur le disque par seconde. |
| StorageNetworkReceiveThroughput | Le débit réseau, en octets par seconde, reçu du volume de stockage du cluster Amazon DocumentDB par chaque instance du cluster. |
| StorageNetworkTransmitThroughput | Le débit réseau, en octets par seconde, envoyé au volume de stockage du cluster Amazon DocumentDB par chaque instance du cluster. |
| StorageNetworkThroughput | Le débit réseau, en octets par seconde, reçu et envoyé au volume de stockage du cluster Amazon DocumentDB par chaque instance du cluster Amazon DocumentDB. |
| VolumeReadIOPs | Nombre moyen d' I/O opérations de lecture facturées à partir d'un volume de cluster, signalées à intervalles de 5 minutes. Les opérations lues facturées sont calculées au niveau du volume de cluster, regroupées à partir de toutes les instances du cluster, puis rapportées par intervalles de 5 minutes. La valeur est calculée en prenant la valeur de la métrique des opérations de lecture sur une période de 5 minutes. Vous pouvez déterminer la quantité d'opérations lues facturées par seconde en prenant la valeur de la métrique des opérations de lecture facturées et en la divisant par 300 secondes. Par exemple, si le résultat `VolumeReadIOPs` renvoie 13 686, le nombre d'opérations de lecture facturées par seconde est de 45 (13 686/300 = 45,62). Vous cumulez les opérations de lecture facturées pour les requêtes qui demandent des pages de base de données non présentes dans le cache des tampons et qui doivent, par conséquent, être chargées depuis le stockage. Il se peut que vous constatiez des pics dans les opérations de lecture facturées, car les résultats des requêtes sont lus à partir du stockage, puis chargés dans le cache des tampons. |
| VolumeWriteIOPs | Nombre moyen d' I/O opérations d'écriture facturées à partir d'un volume de cluster, indiqué à intervalles de 5 minutes. Les opérations lues facturées sont calculées au niveau du volume de cluster, regroupées à partir de toutes les instances du cluster, puis rapportées par intervalles de 5 minutes. La valeur est calculée en prenant la valeur de la métrique des opérations en écriture sur une période de 5 minutes. Vous pouvez déterminer la quantité d'opérations lues facturées par seconde en prenant la valeur de la métrique des opérations en écriture facturées et en la divisant par 300 secondes. Par exemple, si le `VolumeWriteIOPs` renvoie 13 686, le nombre d'opérations d'écriture facturées par seconde est de 45 (13 686/300 = 45,62). Notez que `VolumeReadIOPs` les `VolumeWriteIOPs` métriques sont calculées par la couche de stockage DocumentDB et qu'elles sont également IOs effectuées par l'instance principale et par l'instance de réplique. Les données sont agrégées toutes les 20 à 30 minutes, puis rapportées à intervalles de 5 minutes, émettant ainsi le même point de données pour la métrique au cours de la période. Si vous recherchez une métrique à corréler à vos opérations d'insertion sur un intervalle d'une minute, vous pouvez utiliser la métrique WriteIops au niveau de l'instance. La métrique est disponible dans l'onglet de surveillance de votre instance principale Amazon DocumentDB. |
| WriteIOPS | Nombre moyen d' I/O opérations d'écriture sur disque par seconde. Lorsqu'ils sont utilisés au niveau du cluster, WriteIOPs ils sont évalués sur toutes les instances du cluster. Les IOPS de lecture et d'écriture sont signalées séparément et à des intervalles d'une minute. |
| WriteThroughput | Nombre moyen d’octets écrits sur le disque par seconde. |
### Métriques du système
| Métrique | Description |
| --- | --- |
| AvailableMVCCIds | Un compteur qui indique le nombre d'opérations d'écriture restantes disponibles avant d'atteindre zéro. Lorsque ce compteur atteint zéro, votre cluster passe en mode lecture seule jusqu'à ce IDs qu'il soit récupéré et recyclé. Le compteur diminue à chaque opération d'écriture et augmente à mesure que la collecte des déchets recycle l'ancien IDs MVCC. |
| BufferCacheHitRatio | Pourcentage de demandes traitées par le cache de tampon. |
| DiskQueueDepth | Nombre d' I/O opérations en attente d'écriture ou de lecture sur le disque. |
| EngineUptime | Temps d'exécution de l'instance, en secondes. |
| IndexBufferCacheHitRatio | Pourcentage de demandes d'index traitées par le cache tampon. Vous pouvez constater un pic supérieur à 100 % pour la métrique juste après la suppression d'un index, d'une collection ou d'une base de données. Cela sera automatiquement corrigé au bout de 60 secondes. Cette limitation sera corrigée lors d'une future mise à jour du correctif. |
| LongestActiveGCRuntime | Durée en secondes du processus de collecte des déchets actif le plus long. Il est mis à jour toutes les minutes et suit uniquement les opérations actives, à l'exception des processus terminés dans le délai d'une minute. |
### Métriques de l'instance T3
| Métrique | Description |
| --- | --- |
| CPUCreditUsage | Le nombre de crédits CPU dépensés pendant la période de mesure. |
| CPUCreditBalance | Le nombre de crédits CPU accumulés par une instance. Ce solde diminue lorsque les crédits UC sont dépensés plus rapidement qu’ils ne sont gagnés. |
| CPUSurplusCreditBalance | Le nombre de crédits CPU excédentaires dépensés pour maintenir les performances du processeur lorsque la valeur du CPUCredit solde est nulle. |
| CPUSurplusCreditsCharged | Le nombre de crédits CPU excédentaires dépassant le nombre maximum de crédits CPU pouvant être gagnés sur une période de 24 heures, et entraînant ainsi des frais supplémentaires. Pour plus d'informations, consultez la section [Surveillance des crédits de votre processeur](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-monitoring-cpu-credits.html). |
## Visualisation CloudWatch des données
Vous pouvez consulter les CloudWatch données Amazon à l'aide de la CloudWatch console, de la console Amazon DocumentDB AWS Command Line Interface (AWS CLI) ou de l' CloudWatch API.
------
#### [ Using the AWS Management Console ]
Pour consulter CloudWatch les métriques à l'aide de la console de gestion Amazon DocumentDB, procédez comme suit.
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. Dans le panneau de navigation, choisissez **Clusters**.
**Astuce**
Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-menu-icon.png)) dans le coin supérieur gauche de la page.
1. Dans la boîte de navigation Clusters, vous verrez la colonne **Cluster Identifier**. Vos instances sont répertoriées sous des clusters, comme dans la capture d'écran ci-dessous.
![\[Tableau des clusters indiquant comment une instance est imbriquée sous un cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/choose-clusters.png)
1. Dans la liste des instances, choisissez le nom de l'instance pour laquelle vous souhaitez obtenir des métriques.
1. Sur la page de résumé de l'instance qui s'affiche, choisissez l'onglet **Monitoring** pour afficher les représentations graphiques des métriques de votre instance Amazon DocumentDB. Étant donné qu'un graphique doit être généré pour chaque métrique, le remplissage **CloudWatch**des graphiques peut prendre quelques minutes.
L'image suivante montre les représentations graphiques de deux CloudWatch métriques dans la console Amazon DocumentDB, et`WriteIOPS`. `ReadIOPS`
![\[Deux graphiques linéaires représentant les métriques WriteIops et CloudWatch ReadiOps dans la console Amazon DocumentDB.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/cw-metrics-con.png)
------
#### [ Using the CloudWatch Management Console ]
Pour consulter CloudWatch les métriques à l'aide CloudWatch de la console de gestion, procédez comme suit.
1. Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à l'adresse. [https://console.aws.amazon.com/cloudwatch](https://console.aws.amazon.com/cloudwatch)
1. Dans le panneau de navigation, sélectionnez **Métriques**. Ensuite, dans la liste des noms de service, choisissez **DocDB**.
1. Choisissez une dimension métrique (par exemple, **Cluster Metrics**).
1. L'onglet **Toutes les métriques** affiche toutes les métriques pour cette dimension dans **DocDB**.
1. Pour trier le tableau, utilisez l’en-tête de colonne.
1. Pour représenter graphiquement une métrique, cochez la case en regard de la métrique. Pour sélectionner toutes les métriques, cochez la case dans la ligne d’en-tête du tableau.
1. Pour filtrer par métrique, passez le curseur sur le nom de la métrique et sélectionnez la flèche déroulante à côté du nom de la métrique. Choisissez ensuite **Ajouter à la recherche**, comme indiqué dans l'image ci-dessous.
![\[L'onglet Toutes les métriques répertorie les métriques, avec une liste déroulante qui apparaît pour le nom d'une métrique.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/cloudwatch-filter-metrics.png)
------
#### [ Using the AWS CLI ]
Pour afficher CloudWatch les données d'Amazon DocumentDB, utilisez l' CloudWatch `get-metric-statistics`opération avec les paramètres suivants.
**Parameters**
+ **--namespace** — Obligatoire. L'espace de nom du service pour lequel vous voulez les métriques CloudWatch . Pour Amazon DocumentDB, cela doit être le cas. `AWS/DocDB`
+ **--metric-name** — Obligatoire. Nom de la métrique pour laquelle vous souhaitez obtenir des données.
+ **--start-time** — Obligatoire. L'horodatage qui détermine le premier point de données à renvoyer.
La valeur spécifiée est inclusive ; les résultats incluent des points de données avec l'horodatage spécifié. L'horodatage doit être au format ISO 8601 UTC (par exemple, 2016-10-03T23:00:00Z).
+ **--end-time** — Obligatoire. L'horodatage qui détermine le dernier point de données à renvoyer.
La valeur spécifiée est inclusive ; les résultats incluent des points de données avec l'horodatage spécifié. L'horodatage doit être au format ISO 8601 UTC (par exemple, 2016-10-03T23:00:00Z).
+ **--period** — Obligatoire. La granularité, en secondes, des points de données renvoyés. Pour les métriques avec une résolution standard, une période peut se réduire à une seule minute (60 secondes) et doit être un multiple de 60. Pour les métriques haute résolution qui sont collectées à des intervalles de moins d'une minute, la période peut être 1, 5, 10, 30, 60, ou tout multiple de 60.
+ **--dimensions**— Facultatif. Si la métrique contient plusieurs dimensions, vous devez inclure une valeur pour chaque dimension. CloudWatch traite chaque combinaison unique de dimensions comme une métrique distincte. Vous ne pouvez pas récupérer les statistiques d'une combinaison de dimensions qui n'a pas été spécifiquement publiée. Vous devez spécifier les mêmes dimensions que celles utilisées lorsque les mesures ont été créées.
+ **--statistics**— Facultatif. Statistiques de la métrique, autres que des percentiles. Pour les statistiques sur les centiles, utilisez `ExtendedStatistics`. En appelant `GetMetricStatistics`, vous devez spécifier `Statistics` ou `ExtendedStatistics`, mais pas les deux.
**Valeurs autorisées :**
+ `SampleCount`
+ `Average`
+ `Sum`
+ `Minimum`
+ `Maximum`
+ **--extended-statistics**— Facultatif. Les statistiques sur les `percentile`. Spécifiez des valeurs comprises entre p0.0 et p100. En appelant `GetMetricStatistics`, vous devez spécifier `Statistics` ou `ExtendedStatistics`, mais pas les deux.
+ **--unit**— Facultatif. L'unité pour une métrique donnée. Les métriques peuvent être exprimées en unités multiples. Le fait de ne pas fournir une unité entraîne le renvoi de toutes les unités. Si vous spécifiez uniquement une unité que la métrique ne rapporte pas, les résultats de l'appel sont null.
**Valeurs possibles :**
+ `Seconds`
+ `Microseconds`
+ `Milliseconds`
+ `Bytes`
+ `Kilobytes`
+ `Megabytes`
+ `Gigabytes`
+ `Terabytes`
+ `Bits`
+ `Kilobytes`
+ `Megabits`
+ `Gigabits`
+ `Terabits`
+ `Percent`
+ `Count`
+ `Bytes/Second`
+ `Kilobytes/Second`
+ `Megabytes/Second`
+ `Gigabytes/Second`
+ `Terabytes/Second`
+ `Bits/Second`
+ `Kilobits/Second`
+ `Megabits/Second`
+ `Gigabits/Second`
+ `Terabits/Second`
+ `Count/Second`
+ `None`
**Example**
L'exemple suivant trouve la `CPUUtilization` maximale pour une période de 2 heures en prélevant un échantillon toutes les 60 secondes.
Pour Linux, macOS ou Unix :
```
aws cloudwatch get-metric-statistics \
--namespace AWS/DocDB \
--dimensions \
Name=DBInstanceIdentifier,Value=docdb-2019-01-09-23-55-38 \
--metric-name CPUUtilization \
--start-time 2019-02-11T05:00:00Z \
--end-time 2019-02-11T07:00:00Z \
--period 60 \
--statistics Maximum
```
Pour Windows :
```
aws cloudwatch get-metric-statistics ^
--namespace AWS/DocDB ^
--dimensions ^
Name=DBInstanceIdentifier,Value=docdb-2019-01-09-23-55-38 ^
--metric-name CPUUtilization ^
--start-time 2019-02-11T05:00:00Z ^
--end-time 2019-02-11T07:00:00Z ^
--period 60 ^
--statistics Maximum
```
Le résultat de cette opération ressemble à ce qui suit :
```
{
"Label": "CPUUtilization",
"Datapoints": [
{
"Unit": "Percent",
"Maximum": 4.49152542374361,
"Timestamp": "2019-02-11T05:51:00Z"
},
{
"Unit": "Percent",
"Maximum": 4.25000000000485,
"Timestamp": "2019-02-11T06:44:00Z"
},
********* some output omitted for brevity *********
{
"Unit": "Percent",
"Maximum": 4.33333333331878,
"Timestamp": "2019-02-11T06:07:00Z"
}
]
}
```
------
## Dimensions d'Amazon DocumentDB
Les métriques d'Amazon DocumentDB sont qualifiées par les valeurs du compte ou de l'opération. Vous pouvez utiliser la CloudWatch console pour récupérer les données Amazon DocumentDB filtrées selon l'une des dimensions du tableau suivant.
| Dimension | Description |
| --- | --- |
| DBClusterIdentifier | Filtre les données que vous demandez pour un cluster Amazon DocumentDB spécifique. |
| DBClusterIdentifier, Role | Filtre les données que vous demandez pour un cluster Amazon DocumentDB spécifique, en agrégeant la métrique par rôle d'instance (WRITER/READER). Par exemple, vous pouvez regrouper des métriques pour toutes les instances READER qui appartiennent à un cluster. |
| DBInstanceIdentifier | Filtre les données que vous demandez pour une instance de base de données spécifique. |
## Surveillance des métriques d'Opcounter
Les métriques Opcounter ont une valeur différente de zéro (généralement \$150) pour les clusters inactifs. Cela est dû au fait qu'Amazon DocumentDB effectue des contrôles de santé périodiques, des opérations internes et des tâches de collecte de métriques.
## Surveillance des connexions à la base de données
Lorsque vous visualisez le nombre de connexions à l'aide de commandes du moteur de base de données`db.runCommand( { serverStatus: 1 })`, par exemple, vous pouvez voir jusqu'à 10 connexions de plus que ce que vous voyez en `DatabaseConnections` entrée CloudWatch. Cela se produit parce qu'Amazon DocumentDB effectue des contrôles de santé périodiques et des tâches de collecte de métriques qui ne sont pas prises en compte. `DatabaseConnections` `DatabaseConnections`représente uniquement les connexions initiées par le client.
# Journalisation des appels d'API Amazon DocumentDB avec AWS CloudTrail
Amazon DocumentDB (compatible avec AWS CloudTrail MongoDB) est intégré à un service qui fournit un enregistrement des actions effectuées par les utilisateurs, les rôles ou un service dans AWS Amazon DocumentDB (compatible avec MongoDB). CloudTrail capture tous les appels AWS CLI d'API pour Amazon DocumentDB sous forme d'événements, y compris les appels depuis la console Amazon DocumentDB et les appels de code vers le SDK Amazon DocumentDB. Si vous créez un suivi, vous pouvez activer la diffusion continue d' CloudTrail événements vers un compartiment Amazon S3, y compris des événements pour Amazon DocumentDB. Si vous ne configurez pas de suivi, vous pouvez toujours consulter les événements les plus récents sur la CloudTrail console dans **Historique des événements**. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande envoyée à Amazon DocumentDB (avec compatibilité avec MongoDB), l'adresse IP à partir de laquelle la demande a été effectuée, l'auteur de la demande, la date à laquelle elle a été faite, ainsi que d'autres informations.
**Important**
Pour certaines fonctionnalités de gestion, Amazon DocumentDB utilise une technologie opérationnelle partagée avec Amazon Relational Database Service (Amazon RDS). Les appels à la console Amazon DocumentDB et à l'API sont enregistrés en tant qu'appels passés à l'API Amazon RDS. AWS CLI
Pour en savoir plus AWS CloudTrail, consultez le [guide de AWS CloudTrail l'utilisateur](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
## Informations Amazon DocumentDB dans CloudTrail
CloudTrail est activé sur votre compte Compte AWS lorsque vous créez le compte. **Lorsqu'une activité a lieu dans Amazon DocumentDB (compatible avec MongoDB), cette activité est enregistrée dans un CloudTrail événement avec d'autres événements de AWS service dans l'historique des événements.** Vous pouvez consulter, rechercher et télécharger les événements récents dans votre Compte AWS. Pour plus d'informations, consultez la section [Affichage des événements à l'aide de l'historique des CloudTrail événements](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Pour un enregistrement continu des événements de votre entreprise Compte AWS, y compris des événements relatifs à Amazon DocumentDB (avec compatibilité avec MongoDB), créez une trace. Un suivi permet CloudTrail de fournir des fichiers journaux à un compartiment Amazon S3. Par défaut, lorsque vous créez un journal d’activité dans la console, il s’applique à toutes les régions Régions AWS. Le journal de suivi consigne les événements de toutes les régions dans la partition AWS , et il livre les fichiers journaux dans le compartiment Amazon S3 de votre choix. En outre, vous pouvez configurer d'autres AWS services pour analyser plus en détail les données d'événements collectées dans les CloudTrail journaux et agir en conséquence. Pour plus d’informations, consultez les rubriques suivantes dans le *AWS CloudTrail Guide de l’utilisateur* :
+ [Présentation de la création d’un journal d’activité](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail Services et intégrations pris en charge](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configuration des notifications Amazon SNS pour CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Réception de fichiers CloudTrail journaux provenant de plusieurs régions](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)
+ [Réception de fichiers CloudTrail journaux provenant de plusieurs comptes](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Chaque événement ou entrée du journal contient des informations sur la personne qui a généré la demande. Les informations relatives à l’identité permettent de déterminer les éléments suivants :
+ Si la demande a été effectuée avec les informations d’identification utilisateur racine ou .
+ Si la demande a été effectuée avec les informations d’identification de sécurité temporaires d’un rôle ou d’un utilisateur fédéré.
+ Si la demande a été faite par un autre AWS service.
Pour plus d’informations, consultez la section [Élément userIdentity CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
# Profilage des opérations Amazon DocumentDB
Vous pouvez utiliser le profileur d'Amazon DocumentDB (compatible avec MongoDB) pour enregistrer le temps d'exécution et les détails des opérations effectuées sur votre cluster. Le profileur est utile pour surveiller les opérations les plus lentes sur votre cluster afin de vous aider à améliorer les performances des requêtes individuelles et les performances globales du cluster.
Par défaut, la fonction de profileur est désactivée. Lorsqu'il est activé, le profileur enregistre les opérations qui prennent plus de temps qu'une valeur de seuil définie par le client (par exemple, 100 ms) dans Amazon Logs. CloudWatch Les détails consignés incluent la commande profilée, l'heure, le récapitulatif du plan et les métadonnées du client. Une fois les opérations enregistrées dans CloudWatch Logs, vous pouvez utiliser CloudWatch Logs Insights pour analyser, surveiller et archiver vos données de profilage Amazon DocumentDB. Les requêtes courantes sont fournies dans la section [Requêtes courantes](#profiling.common-queries).
Lorsque cette option est activée, le profileur utilise des ressources supplémentaires de votre cluster. Nous vous recommandons de commencer avec une valeur de seuil élevée (par exemple, 500 ms) et de réduire progressivement la valeur pour identifier les opérations lentes. Démarrer avec une valeur de seuil de 50 ms peut entraîner des problèmes de performances sur votre cluster pour les applications à haut débit. Le profileur est activé au niveau du cluster et fonctionne sur toutes les instances et bases de données d'un cluster. Amazon DocumentDB enregistre les opérations dans Amazon CloudWatch Logs dans la mesure du possible.
Bien qu'Amazon DocumentDB n'impose aucun frais supplémentaire pour activer le profileur, les tarifs standard vous sont facturés pour l'utilisation des journaux. CloudWatch Pour plus d'informations sur la tarification des CloudWatch journaux, consultez [ CloudWatch les tarifs Amazon](https://aws.amazon.com/cloudwatch/pricing/).
**Topics**
+ [Opérations prises en charge](#profiling.supported-commands)
+ [Limitations](#profiling.limitations)
+ [Activation du profileur](#profiling.enable-profiling)
+ [Désactivation du profileur](#profiling.disable-profiling)
+ [Désactivation de l'exportation des journaux du profileur](#profiling.disabling-logs-export)
+ [Accès aux journaux de votre profileur](#profiling.accessing)
+ [Requêtes courantes](#profiling.common-queries)
## Opérations prises en charge
Le profileur Amazon DocumentDB prend en charge les opérations suivantes :
+ `aggregate`
+ `count`
+ `delete`
+ `distinct`
+ `find` (OP\$1QUERY et commande)
+ `findAndModify`
+ `insert`
+ `update`
## Limitations
Le profileur de requêtes lent ne peut émettre des journaux de profilage que si l'ensemble des résultats de la requête peut tenir dans un seul lot et si le jeu de résultats est inférieur à 16 Mo (taille BSON maximale). Les ensembles de résultats supérieurs à 16 Mo sont automatiquement divisés en plusieurs lots.
La plupart des pilotes ou des interpréteurs de commandes peuvent définir une taille de lot par défaut faible. Vous pouvez spécifier la taille du lot dans le cadre de votre requête. Afin de capturer des journaux de requêtes lents, nous recommandons une taille de lot supérieure à la taille de votre jeu de résultats attendu. Si vous n'êtes pas sûr de la taille du jeu de résultats ou si elle varie, vous pouvez également définir la taille du lot sur un grand nombre (par exemple, 100 000).
Cependant, l'utilisation d'une taille de lot plus importante signifie que davantage de résultats devront être extraits de la base de données avant qu'une réponse ne soit envoyée au client. Pour certaines requêtes, cela peut entraîner des délais plus longs avant que vous n'obteniez des résultats. Si vous ne prévoyez pas de consommer l'ensemble des résultats, il est possible que vous dépensiez davantage I/Os pour traiter la requête et rejeter le résultat.
## Activation du profileur Amazon DocumentDB
L'activation du profileur sur un cluster est un processus en trois étapes. Assurez-vous que toutes les étapes sont terminées, sinon les journaux de profilage ne seront pas envoyés à CloudWatch Logs. Le profileur est défini au niveau du cluster et est effectué sur l'ensemble des bases de données et des instances du cluster.
**Pour activer le profileur sur un cluster**
1. Etant donné que vous ne pouvez pas modifier un groupe de paramètres de cluster par défaut, veillez à disposer d'un groupe de paramètres de cluster personnalisé disponible. Pour de plus amples informations, veuillez consulter [Création de groupes de paramètres de cluster Amazon DocumentDB](cluster_parameter_groups-create.md).
1. À l'aide d'un groupe de paramètres de cluster personnalisé disponible, modifiez les paramètres suivants : `profiler`, `profiler_threshold_ms` et `profiler_sampling_rate`. Pour de plus amples informations, veuillez consulter [Modification des groupes de paramètres du cluster Amazon DocumentDB](cluster_parameter_groups-modify.md).
1. Créez ou modifiez votre cluster pour utiliser le groupe de paramètres de cluster personnalisé et pour permettre l'exportation `profiler` des CloudWatch journaux vers Logs.
Les sections suivantes montrent comment implémenter ces étapes à l'aide AWS Management Console des et AWS Command Line Interface (AWS CLI).
------
#### [ Using the AWS Management Console ]
1. Avant de commencer, créez un cluster Amazon DocumentDB et un groupe de paramètres de cluster personnalisé si vous n'en avez pas déjà un. Pour plus d’informations, consultez [Création de groupes de paramètres de cluster Amazon DocumentDB](cluster_parameter_groups-create.md) et [Création d'un cluster Amazon DocumentDB](db-cluster-create.md).
1. À l'aide d'un groupe de paramètres de cluster personnalisé disponible, modifiez les paramètres suivants. Pour de plus amples informations, veuillez consulter [Modification des groupes de paramètres du cluster Amazon DocumentDB](cluster_parameter_groups-modify.md).
+ `profiler`— Active ou désactive le profilage des requêtes. Les valeurs autorisées sont `enabled ` et `disabled`. La valeur par défaut est `disabled`. Pour activer le profilage, définissez la valeur sur `enabled`.
+ `profiler_threshold_ms`— Lorsque `profiler` ce paramètre est défini sur`enabled`, toutes les commandes qui prennent plus de temps ` profiler_threshold_ms` sont enregistrées CloudWatch. Les valeurs autorisées sont `[50-INT_MAX]`. La valeur par défaut est `100`.
+ `profiler_sampling_rate`— La fraction des opérations lentes qui doivent être profilées ou enregistrées. Les valeurs autorisées sont `[0.0-1.0]`. La valeur par défaut est `1.0`.
1. Modifiez votre cluster pour utiliser le groupe de paramètres de cluster personnalisé et configurez les exportations du journal du profileur pour qu'elles soient publiées sur Amazon CloudWatch.
1. Dans le panneau de navigation, choisissez **Clusters** pour ajouter votre groupe de paramètres personnalisé à un cluster.
1. Cliquez sur le bouton situé à gauche du nom du cluster auquel vous souhaitez associer votre groupe de paramètres. Sélectionnez **Actions**, puis **Modify (Modifier)** pour modifier votre cluster.
1. Sous **Cluster options (Options de cluster)**, choisissez le groupe de paramètres personnalisé à partir de l'étape ci-dessus pour l'ajouter à votre cluster.
1. Sous **Exportations de journaux**, sélectionnez les **journaux Profiler** à publier sur Amazon CloudWatch.
1. Sélectionnez **Continuer** pour afficher un résumé de vos modifications.
1. Après vérification de vos modifications, vous pouvez les appliquer immédiatement ou au cours de la fenêtre de maintenance suivante sous **Scheduling of modifications (Planification des modifications)**.
1. Choisissez **Modify cluster (Modifier le cluster)** pour mettre à jour votre cluster avec votre nouveau groupe de paramètres.
------
#### [ Using the AWS CLI ]
La procédure suivante active le profileur sur toutes les opérations prises en charge pour le cluster `sample-cluster`.
1. Avant de commencer, vérifiez qu'un groupe de paramètres de cluster personnalisé est disponible en exécutant la commande suivante et en examinant la sortie d'un groupe de paramètres de cluster qui ne contient pas la valeur `default` dans son nom et qui comprend `docdb3.6` comme famille de groupes de paramètres. Si vous ne disposez pas d'un groupe de paramètres de cluster autre que par défaut, veuillez consulter [Création de groupes de paramètres de cluster Amazon DocumentDB](cluster_parameter_groups-create.md).
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName,DBParameterGroupFamily]'
```
Dans la sortie suivante, seul `sample-parameter-group ` répond à ces deux critères.
```
[
[
"default.docdb3.6",
"docdb3.6"
],
[
"sample-parameter-group",
"docdb3.6"
]
]
```
1. À l'aide de votre groupe de paramètres de cluster personnalisé, modifiez les paramètres suivants :
+ `profiler`— Active ou désactive le profilage des requêtes. Les valeurs autorisées sont `enabled ` et `disabled`. La valeur par défaut est `disabled`. Pour activer le profilage, définissez la valeur sur `enabled`.
+ `profiler_threshold_ms`— Lorsque `profiler` ce paramètre est défini sur`enabled`, toutes les commandes `profiler_threshold_ms` prennent plus de temps que ce qui est enregistré CloudWatch. Les valeurs autorisées sont `[50-INT_MAX]`. La valeur par défaut est `100`.
+ `profiler_sampling_rate`— La fraction des opérations lentes qui doivent être profilées ou enregistrées. Les valeurs autorisées sont `[0.0-1.0]`. La valeur par défaut est `1.0`.
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters ParameterName=profiler,ParameterValue=enabled,ApplyMethod=immediate \
ParameterName=profiler_threshold_ms,ParameterValue=100,ApplyMethod=immediate \
ParameterName=profiler_sampling_rate,ParameterValue=0.5,ApplyMethod=immediate
```
1. Modifiez votre cluster Amazon DocumentDB afin qu'il utilise le groupe de paramètres de cluster `sample-parameter-group` personnalisé de l'étape précédente et qu'il définisse le paramètre `--enable-cloudwatch-logs-exports` sur. `profiler`
Le code suivant modifie le cluster `sample-cluster` pour utiliser celui `sample-parameter-group` de l'étape précédente et ajoute `profiler` aux exportations de CloudWatch journaux activées.
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--db-cluster-parameter-group-name sample-parameter-group \
--cloudwatch-logs-export-configuration '{"EnableLogTypes":["profiler"]}'
```
Le résultat de cette opération ressemble à ceci.
```
{
"DBCluster": {
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2020-04-07T02:05:12.479Z",
"Endpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "3.6.0",
"LatestRestorableTime": "2020-04-08T22:08:59.317Z",
"Port": 27017,
"MasterUsername": "test",
"PreferredBackupWindow": "02:00-02:30",
"PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"HostedZoneId": "ABCDEFGHIJKLM",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"DBClusterArn": "arn:aws:rds:us-east-1::cluster:sample-cluster",
"AssociatedRoles": [],
"ClusterCreateTime": "2020-01-10T22:13:38.261Z",
"EnabledCloudwatchLogsExports": [
"profiler"
],
"DeletionProtection": true
}
}
```
------
## Désactivation du profileur Amazon DocumentDB
Pour désactiver le profileur, vous devez désactiver à la fois le `profiler` paramètre et l'exportation des `profiler` CloudWatch journaux vers Logs.
### Désactivation du profileur
Vous pouvez désactiver le `profiler` paramètre à l'aide du AWS Management Console ou AWS CLI, comme suit.
------
#### [ Using the AWS Management Console ]
La procédure suivante utilise le AWS Management Console pour désactiver Amazon DocumentDB`profiler`.
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. Dans le panneau de navigation, choisissez **Groupes de paramètres**. Choisissez ensuite le nom du groupe de paramètres de cluster sur lequel vous souhaitez désactiver le profileur.
1. Sur la page **Cluster parameters (Paramètres de cluster)** qui s'affiche, sélectionnez le bouton situé à gauche du paramètre `profiler` et choisissez **Modifier**.
1. Dans la boîte de dialogue **Modify profiler (Modifier le profileur)**, choisissez `disabled` dans la liste.
1. Choisissez **Modifier le paramètre de cluster**.
------
#### [ Using the AWS CLI ]
Pour désactiver `profiler` sur un cluster à l'aide de l' AWS CLI, modifiez le cluster comme illustré ci-dessous.
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters ParameterName=profiler,ParameterValue=disabled,ApplyMethod=immediate
```
------
## Désactivation de l'exportation des journaux du profileur
Vous pouvez désactiver l'exportation `profiler` des CloudWatch journaux vers Logs en utilisant le AWS Management Console ou AWS CLI, comme suit.
------
#### [ Using the AWS Management Console ]
La procédure suivante utilise le AWS Management Console pour désactiver l'exportation des journaux vers Amazon DocumentDB vers. CloudWatch
1. [Ouvrez la console Amazon DocumentDB à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Clusters**. Choisissez le bouton à gauche du nom du cluster pour lequel vous souhaitez désactiver l'exportation des journaux.
1. Dans le menu **Actions**, choisissez **Modify (Modifier)**.
1. Faites défiler la page jusqu'à la section **Log exports (Exportations de journaux)**, puis choisissez **Profiler logs (Journaux du profileur)**.
1. Sélectionnez **Continuer**.
1. Vérifiez vos modifications, puis choisissez quand cette modification devra être appliquée à votre cluster :
+ **Appliquer pendant la fenêtre de maintenance planifiée suivante**
+ **Appliquer immédiatement**
1. Choisissez **Modifier le cluster**.
------
#### [ Using the AWS CLI ]
Le code suivant modifie le cluster `sample-cluster ` et désactive les journaux du CloudWatch profileur.
**Example**
Pour Linux, macOS ou Unix :
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--cloudwatch-logs-export-configuration '{"DisableLogTypes":["profiler"]}'
```
Pour Windows :
```
aws docdb modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--cloudwatch-logs-export-configuration '{"DisableLogTypes":["profiler"]}'
```
Le résultat de cette opération ressemble à ceci.
```
{
"DBCluster": {
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2020-04-08T02:05:17.266Z",
"Endpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "3.6.0",
"LatestRestorableTime": "2020-04-09T05:14:44.356Z",
"Port": 27017,
"MasterUsername": "test",
"PreferredBackupWindow": "02:00-02:30",
"PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"HostedZoneId": "ABCDEFGHIJKLM",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"DBClusterArn": "arn:aws:rds:us-east-1::cluster:sample-cluster",
"AssociatedRoles": [],
"ClusterCreateTime": "2020-01-10T22:13:38.261Z",
"DeletionProtection": true
}
}
```
------
## Accès aux journaux de votre profileur Amazon DocumentDB
Suivez ces étapes pour accéder aux journaux de votre profil sur Amazon CloudWatch.
1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Assurez-vous que vous vous trouvez dans la même région que votre cluster Amazon DocumentDB.
1. Dans le panneau de navigation, sélectionnez **Logs** (Journaux).
1. Pour rechercher les journaux de profileur de votre cluster, dans la liste, choisissez `/aws/docdb/yourClusterName/profiler`.
Les événements d'audit pour chacune de vos instances sont disponibles sous chacun des noms d'instance respectifs.
## Requêtes courantes
Voici quelques requêtes courantes que vous pouvez utiliser pour analyser vos commandes profilées. Pour plus d'informations sur CloudWatch Logs Insights, consultez [Analyser les données des CloudWatch journaux avec Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) et [Sample Queries](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax-examples.html).
### Obtenez les 10 opérations les plus lentes sur une collection spécifiée
```
filter ns="test.foo" | sort millis desc | limit 10
```
### Obtenez toutes les opérations de mise à jour sur une collection qui a pris plus de 60 ms
```
filter millis > 60 and op = "update"
```
### Réalisez les 10 opérations les plus lentes du mois dernier
```
sort millis desc | limit 10
```
### Obtenir toutes les requêtes avec un récapitulatif du plan COLLSCAN
```
filter planSummary="COLLSCAN"
```
# Surveillance avec Performance Insights
Performance Insights complète les fonctionnalités de surveillance existantes d'Amazon DocumentDB pour illustrer les performances de votre cluster et vous aider à analyser les problèmes qui l'affectent. Le tableau de bord Performance Insights vous permet de visualiser le chargement de la base de données et de filtrer le chargement en fonction des temps d'attente, des instructions de requête, des hôtes ou des applications.
**Note**
Performance Insights est uniquement disponible pour les clusters basés sur des instances Amazon DocumentDB 3.6, 4.0, 5.0 et 8.0.
**En quoi est-ce utile ?**
+ Visualisez les performances de la base de données : visualisez la charge pour déterminer quand et où elle se trouve sur la base de données
+ Déterminer la cause de la charge sur la base de données : déterminez les requêtes, les hôtes et les applications qui contribuent à la charge sur votre instance
+ Déterminez à quel moment votre base de données est chargée : zoomez sur le tableau de bord Performance Insights pour vous concentrer sur des événements spécifiques ou effectuez un zoom arrière pour examiner les tendances sur une période plus longue
+ Alerte concernant le chargement de la base de données : accédez automatiquement aux nouvelles mesures de charge de base de données, depuis CloudWatch lesquelles vous pouvez surveiller les mesures de charge de la base de données ainsi que d'autres mesures Amazon DocumentDB et définir des alertes à leur sujet
**Quelles sont les limites d'Amazon DocumentDB Performance Insights ?**
+ Performance Insights dans les régions AWS GovCloud (USA Est) et AWS GovCloud (USA Ouest) ne sont pas disponibles
+ Performance Insights for Amazon DocumentDB conserve jusqu'à 7 jours de données de performance
+ Les requêtes de plus de 1 024 octets ne sont pas agrégées dans Performance Insights
**Topics**
+ [Concepts de Performance Insights](performance-insights-concepts.md)
+ [Activation et désactivation de Performance Insights](performance-insights-enabling.md)
+ [Configuration des politiques d’accès pour Performance Insights](performance-insights-policies.md)
+ [Analyse des métriques à l’aide du tableau de bord de Performance Insights](performance-insights-analyzing.md)
+ [Récupération de métriques avec l’API Performance Insights](performance-insights-metrics.md)
+ [Statistiques CloudWatch Amazon pour Performance Insights](performance-insights-cloudwatch.md)
+ [Performance Insights pour les contre-métriques](performance-insights-counter-metrics.md)
# Concepts de Performance Insights
**Topics**
+ [Sessions actives en moyenne](#performance-insights-concepts-sessions)
+ [Dimensions](#performance-insights-concepts-dimensions)
+ [vCPU maximum](#performance-insights-concepts-maxvcpu)
## Sessions actives en moyenne
Database load (DB load) (Charge de la base de données, ou charge DB) mesure le niveau d'activité de votre base de données. La métrique clé de Performance Insights est `DB Load`, qui est collectée toutes les secondes. L'unité de la `DBLoad` métrique est le nombre *moyen de sessions actives (AAS)* pour une instance Amazon DocumentDB.
Une session *active* est une connexion qui a soumis un travail à l'instance Amazon DocumentDB et qui attend une réponse. Par exemple, si vous soumettez une requête à une instance Amazon DocumentDB, la session de base de données est active pendant que l'instance traite la requête.
Pour obtenir les sessions actives en moyenne, Performance Insights échantillonne le nombre de sessions exécutant simultanément une requête. L'AAS correspond au nombre total de sessions divisé par le nombre total d'échantillons. Le tableau suivant présente cinq exemples consécutifs d'une requête en cours d'exécution.
| Exemple | Nombre de sessions exécutant la requête | AAS | Calcul |
| --- | --- | --- | --- |
| 1 | 2 | 2 | 2 sessions / 1 échantillon |
| 2 | 0 | 1 | 2 sessions / 2 échantillons |
| 3 | 4 | 2 | 6 sessions / 3 échantillons |
| 4 | 0 | 1.5 | 6 sessions / 4 échantillons |
| 5 | 4 | 2 | 10 sessions / 5 échantillons |
Dans l'exemple précédent, la charge de base de données pour l'intervalle de temps compris entre 1 et 5 est de 2 AAS. Une augmentation de la charge de base de données signifie que, en moyenne, un plus grand nombre de sessions s'exécutent sur la base de données.
## Dimensions
La métrique `DB Load` est différente des autres métriques de série chronologique, car vous pouvez la décomposer en sous-composants appelés dimensions. Vous pouvez considérer les dimensions comme des catégories pour les différentes caractéristiques de la métrique `DB Load`. Lorsque vous diagnostiquez des problèmes de performances, les dimensions les plus utiles sont les **états d'attente** et la **première requête**.
**états d'attente**
Un *état d'attente* oblige une instruction de requête à attendre qu'un événement spécifique se produise avant de pouvoir continuer à s'exécuter. Par exemple, une instruction de requête peut attendre qu'une ressource verrouillée soit déverrouillée. En combinant les états `DB Load` d'attente, vous pouvez obtenir une image complète de l'état de la session. Voici les différents états d'attente d'Amazon DocumentDB :
| État d'attente d'Amazon DocumentDB | Description de l'état d'attente |
| --- | --- |
| Loquet | L'état d'attente Latch se produit lorsque la session attend de mettre en page le pool de mémoire tampon. Les entrées et sorties fréquentes du pool de mémoire tampon peuvent se produire plus souvent lorsque le système traite fréquemment des requêtes volumineuses, que des collections sont scannées ou lorsque le pool de mémoire tampon est trop petit pour gérer l'ensemble de travail. |
| CPU | L'état d'attente du processeur se produit lorsque la session est en attente sur le processeur. |
| CollectionLock | L'état d' CollectionLock attente se produit lorsque la session attend de verrouiller la collection. Ces événements se produisent lorsque des opérations DDL sont effectuées sur la collection. |
| DocumentLock | L'état d' DocumentLock attente se produit lorsque la session attend de verrouiller un document. Un nombre élevé d'écritures simultanées sur le même document contribuera à augmenter le nombre d'états d' DocumentLockattente sur ce document. |
| SystemLock | L'état d' SystemLock attente se produit lorsque la session est en attente sur le système. Cela peut se produire en cas de requêtes fréquentes et longues, de transactions de longue durée ou de forte simultanéité sur le système. |
| E/S | L'état d'attente d'E/S se produit lorsque la session en attente d'E/S est terminée. |
| BufferLock | L'état d' BufferLock attente se produit lorsque la session attend d'obtenir un verrou sur une page partagée dans la mémoire tampon. BufferLockles états d'attente peuvent être prolongés si d'autres processus maintiennent des curseurs ouverts sur les pages demandées. |
| LowMemThrottle | L'état d' LowMemThrottle attente se produit lorsque la session est en attente en raison d'une forte pression de mémoire sur l'instance Amazon DocumentDB. Si cet état persiste pendant une longue période, envisagez de redimensionner l'instance pour fournir de la mémoire supplémentaire. Pour plus d'informations, consultez [Resource Governor](https://docs.aws.amazon.com/documentdb/latest/developerguide/how-it-works.html). |
| BackgroundActivity | L'état d' BackgroundActivity attente se produit lorsque la session attend des processus internes du système. |
| Autre | L'autre état d'attente est un état d'attente interne. Si cet état persiste pendant une longue période, pensez à mettre fin à cette requête. Pour plus d'informations, voir [Comment rechercher et mettre fin aux requêtes bloquées ou de longue durée ?](https://docs.aws.amazon.com/documentdb/latest/developerguide/user_diagnostics.html#user_diagnostics-query_terminating.html) |
**Requêtes les plus fréquentes**
Alors que les états d'attente indiquent les goulots d'étranglement, les requêtes les plus fréquentes indiquent les requêtes qui contribuent le plus à la charge de la base de données. Par exemple, de nombreuses requêtes peuvent être en cours d'exécution sur la base de données, mais une seule d'entre elles peut consommer 99 % de la charge de la base de données. Dans ce cas, la charge élevée peut indiquer un problème avec la requête.
## vCPU maximum
Dans le tableau de bord, le graphique **Database load** (Charge de base de données)collecte, regroupe et affiche les informations de session. Pour voir si les sessions actives dépassent l’utilisation maximale de l’UC, examinez leur relation sur la ligne **Max vCPU** (UC virtuelle max). La valeur **maximale de vCPU** est déterminée par le nombre de cœurs de vCPU (processeur virtuel) pour votre instance Amazon DocumentDB.
Si la charge de la base de données est souvent au-dessus de la ligne **Max vCPU** (UC virtuelle max)et que l’état d’attente principal est CPU, cela signifie que l’UC est surchargée. Dans ce cas, vous souhaiterez peut-être limiter les connexions à l'instance, régler les requêtes impliquant une charge CPU élevée ou envisager une classe d'instance plus importante. Quel que soit leur état d’attente, les instances élevées et régulières indiquent que des problèmes de goulots d’étranglement ou de conflits de ressources devront peut-être être résolus. Cela peut être vrai même si la charge de la base de données ne dépasse pas la ligne **Max vCPU** (UC virtuelle max).
# Activation et désactivation de Performance Insights
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
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
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
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
```
------
# Configuration des politiques d’accès pour Performance Insights
Pour accéder à Performance Insights, vous devez disposer des autorisations appropriées d' Gestion des identités et des accès AWS (IAM). Vous disposez des options suivantes pour accorder l'accès :
+ Attachez la politique gérée par `AmazonRDSPerformanceInsightsReadOnly` à un jeu d'autorisations ou à un rôle.
+ Créez une politique IAM personnalisée et attachez-la à un jeu d'autorisations ou à un rôle.
En outre, si vous avez spécifié une clé gérée par le client lorsque vous avez activé Performance Insights, assurez-vous que les utilisateurs de votre compte disposent des autorisations `kms:Decrypt` et `kms:GenerateDataKey` sur la clé KMS.
**Note**
[Pour la gestion encryption-at-rest des AWS KMS clés et des groupes de sécurité, Amazon DocumentDB utilise une technologie opérationnelle partagée avec Amazon RDS.](https://aws.amazon.com/rds)
## Associer la RDSPerformance InsightsReadOnly politique Amazon à un IAM principal
`AmazonRDSPerformanceInsightsReadOnly`est une politique AWS gérée qui donne accès à toutes les opérations en lecture seule de l'API Performance Insights d'Amazon DocumentDB. Actuellement, toutes les opérations de cette API sont en lecture seule. Si vous attachez `AmazonRDSPerformanceInsightsReadOnly` à un jeu d'autorisations ou à un rôle, le destinataire peut utiliser Performance Insights avec d'autres fonctions de la console.
## Création d’une politique IAM personnalisée pour Performance Insights
Pour les utilisateurs qui ne bénéficient pas d'un accès à la politique `AmazonRDSPerformanceInsightsReadOnly`, vous pouvez accorder l'accès à Performance Insights en créant ou modifiant une politique IAM gérée par l'utilisateur. Lorsque vous associez la politique à un ensemble d'autorisations ou à un rôle, le destinataire peut utiliser Performance Insights.
**Créer une stratégie personnalisée**
1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Dans le panneau de navigation, choisissez **Politiques**.
1. Choisissez **Create Policy** (Créer une politique).
1. Sur la page **Créer une stratégie**, choisissez l'onglet JSON.
1. Copiez et collez le texte suivant, en le *us-east-1* remplaçant par le nom de votre AWS région et *111122223333* par votre numéro de compte client.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "rds:DescribeDBInstances",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "rds:DescribeDBClusters",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "pi:DescribeDimensionKeys",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:GetDimensionKeyDetails",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:GetResourceMetadata",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:GetResourceMetrics",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:ListAvailableResourceDimensions",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:ListAvailableResourceMetrics",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
}
]
}
```
------
1. Choisissez **Examiner une politique**.
1. Indiquez un nom pour la stratégie et éventuellement une description, puis choisissez **Créer une stratégie**.
Vous pouvez désormais attacher la politique à un jeu d’autorisations ou à un rôle. La procédure suivante suppose que vous disposez déjà d’un utilisateur à cette fin.
**Pour attacher la politique à un utilisateur**
1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Dans le panneau de navigation, choisissez **utilisateurs**.
1. Choisissez un utilisateur existant dans la liste.
**Important**
Pour utiliser Performance Insights, assurez-vous d'avoir accès à Amazon DocumentDB en plus de la politique personnalisée. [Par exemple, la politique **AmazonDocDBReadOnlyAccess**prédéfinie fournit un accès en lecture seule à Amazon DocDB. Pour plus d'informations, consultez Gérer l'accès à l'aide de politiques.](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAM.html#security_iam_access-manage)
1. Sur la page **Récapitulatif**, choisissez **Ajouter des autorisations**.
1. Choisissez **Attacher directement les stratégies existantes**. Pour **Recherche**, tapez les premiers caractères du nom de votre stratégie, comme illustré ci-après.
![\[Choisissez une politique\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/pi-add-permissions.png)
1. Choisissez votre stratégie, puis sélectionnez **Suivant : Vérification**.
1. Choisissez **Add permissions**.
## Configuration d'une AWS KMS politique pour Performance Insights
Performance Insights utilise un AWS KMS key pour chiffrer les données sensibles. Lorsque vous activez Performance Insights via l'API ou la console, vous disposez des options suivantes :
+ Choisissez la valeur par défaut Clé gérée par AWS.
Amazon DocumentDB utilise le Clé gérée par AWS pour votre nouvelle instance de base de données. Amazon DocumentDB crée un Clé gérée par AWS pour votre AWS compte. Votre AWS compte possède un identifiant Amazon DocumentDB différent Clé gérée par AWS pour chaque AWS région.
+ Choisissez une clé gérée par le client.
Si vous spécifiez une clé gérée par le client, les utilisateurs de votre compte qui appellent l’API Performance Insights ont besoin des autorisations `kms:Decrypt` et `kms:GenerateDataKey` sur la clé KMS. Vous pouvez configurer ces autorisations via des politiques IAM. Toutefois, nous vous recommandons de gérer ces autorisations via votre politique de clé KMS. Pour plus d'informations, veuillez consulter [Utilisation des stratégies de clé dans AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html).
**Example**
L'exemple de politique de clé suivant montre comment ajouter des instructions à votre politique KMS. Ces instructions permettent d’accéder à Performance Insights. Selon la manière dont vous utilisez le AWS KMS, vous souhaiterez peut-être modifier certaines restrictions. Avant d'ajouter des instructions à votre politique, supprimez tous les commentaires.
# Analyse des métriques à l'aide du tableau de bord de Performance Insights
Le tableau de bord de Performance Insights contient des informations sur les performances des bases de données qui vous aideront à analyser et à résoudre les problèmes de performances. Sur la page principale du tableau de bord, vous pouvez consulter les informations relatives au chargement de la base de données (charge de base de données). Vous pouvez « découper » le chargement de la base de données en fonction de dimensions telles que les états d'attente ou les requêtes.
**Topics**
+ [Présentation du tableau de bord Performance Insights](performance-insights-dashboard-overview.md)
+ [Ouverture du tableau de bord de Performance Insights](performance-insights-dashboard-opening.md)
+ [Analyse du chargement de la base de données par états d'attente](performance-insights-analyzing-db-load.md)
+ [Vue d'ensemble de l'onglet Requêtes les plus fréquentes](performance-insights-top-queries.md)
+ [Zoom sur le graphique de charge de la base de données](performance-insights-zoom-db-load.md)
# Présentation du tableau de bord Performance Insights
Le tableau de bord est le moyen le plus simple d’interagir avec Performance Insights. L'exemple suivant montre le tableau de bord d'une instance Amazon DocumentDB. Par défaut, le tableau de bord de Performance Insights affiche les données pour l'heure précédente.
![\[Tableau de bord Performance Insights indiquant l'utilisation du processeur et la charge de la base de données au fil du temps pour une instance Amazon DocumentDB.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/overview-dashboard.png)
Le tableau de bord est divisé entre les parties suivantes :
1. **Indicateurs de comptage** : affiche les données relatives à des indicateurs de performance spécifiques.
1. **Charge de base de données** — Indique comment la charge de base de données se compare à la capacité de l'instance de base de données, telle que représentée par la **ligne Max vCPU**.
1. **Dimensions supérieures** — Affiche les dimensions supérieures qui contribuent à la charge de la base de données. Ces dimensions incluent `waits``queries`,`hosts`,`databases`, et`applications`.
**Topics**
+ [Graphique Counter Metrics (Métriques de compteur)](#performance-insights-overview-metrics)
+ [Graphique Database Load (Charge de la base de données)](#performance-insights-overview-db-load-chart)
+ [Tableau des dimensions principales](#performance-insights-overview-top-dimensions)
## Graphique Counter Metrics (Métriques de compteur)
Grâce aux métriques de compteur, vous pouvez personnaliser le tableau de bord de Performance Insights de sorte à inclure jusqu’à 10 graphiques supplémentaires. Ces graphiques présentent une sélection de dizaines de métriques du système d'exploitation. Vous pouvez établir des corrélations entre ces informations et la charge de la base de données pour identifier et analyser les problèmes de performances.
Le graphique **Counter Metrics** (Métriques de compteur) affiche les données des compteurs de performances.
![\[Tableau des indicateurs de mesure montrant l'utilisation du processeur au fil du temps.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/counter-metrics.png)
Pour modifier les compteurs de performance, choisissez **Gérer les métriques**. Vous pouvez sélectionner plusieurs **métriques du système d'exploitation**, comme indiqué dans la capture d'écran suivante. Pour afficher les détails relatifs à une métrique, passez la souris sur le nom de la métrique.
![\[Interface de sélection des métriques du tableau de bord Performance Insights avec options de métriques du système d'exploitation.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/overview-os-metrics.png)
## Graphique Database Load (Charge de la base de données)
Le graphique **de charge de la base** de données montre comment l'activité de la base de données se compare à la capacité de l'instance telle que représentée par la **ligne Max vCPU**. Par défaut, le graphique en courbes empilées représente la charge de la base de données sous forme de sessions actives en moyenne par unité de temps. La charge de la base de données est découpée (groupée) par états d’attente.
![\[Graphique de charge de la base de données indiquant le nombre moyen de sessions actives au fil du temps, avec un pic d'utilisation du processeur vers la fin.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/database-load.png)
**Charge de base de données tranchée par dimensions**
Vous pouvez afficher la charge sous la forme de sessions actives regroupées par dimensions prises en charge. L'image suivante montre les dimensions de l'instance Amazon DocumentDB.
![\[Graphique illustrant le chargement de la base de données avec les différentes options « Slice by » affichées dans une liste déroulante.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/database-load-sliced.png)
**Détails de charge de base de données pour un élément de dimension**
Pour afficher les détails d’un élément de charge de base de données dans une dimension, passez la souris sur le nom d’élément. L'image suivante montre les détails d'une instruction de requête.
![\[Diagramme à barres montrant le chargement de la base de données avec des détails supplémentaires affichés lorsque vous passez le pointeur sur le nom d'un élément.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/database-load-details.png)
Pour afficher les détails d’un élément pour la période sélectionnée dans la légende, survolez cet élément.
![\[Diagramme à barres montrant le chargement de la base de données avec des détails supplémentaires affichés lorsque vous survolez une barre avec le pointeur de la souris.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/database-load-hover.png)
## Tableau des dimensions principales
Le **tableau des dimensions supérieures répartit** la charge de base de données selon différentes dimensions. Une dimension est une catégorie ou « tranche » qui représente l’une des différentes caractéristiques de la charge de la base de données. Si la dimension est query, **Top queries** affiche les instructions de requête qui contribuent le plus à la charge de la base de données.
Choisissez l’un des onglets de dimension suivants.
![\[L'onglet Dimensions des requêtes les plus fréquentes affiche les deux principales requêtes.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/top-dimensions.png)
Le tableau suivant fournit une brève description de chaque onglet.
| Onglet | Description |
| --- | --- |
| Principaux éléments d’attente | Événement pour lequel le backend de la base de données attend |
| Requêtes les plus fréquentes | Les instructions de requête en cours d'exécution |
| Principaux hôtes | L'adresse IP et le port de l'hôte du client connecté |
| Principales bases de données | Nom de la base de données à laquelle le client est connecté |
| Principales applications | Nom de l’application connectée à la base de données |
Pour savoir comment analyser les requêtes à l'aide de l'onglet **Requêtes les plus** fréquentes, voir[Vue d'ensemble de l'onglet Requêtes les plus fréquentes](performance-insights-top-queries.md).
# Ouverture du tableau de bord de Performance Insights
**Pour consulter le tableau de bord Performance Insights dans la console de AWS gestion, procédez comme suit :**
1. Ouvrez la console Performance Insights à l'adresse [https://console.aws.amazon.com/docdb/](https://console.aws.amazon.com/docdb/home#performance-insights).
1. Choisissez une instance de base de données. Le tableau de bord Performance Insights est affiché pour cette instance Amazon DocumentDB.
Pour les instances Amazon DocumentDB sur lesquelles Performance Insights est activé, vous pouvez également accéder au tableau de bord en choisissant l'élément **Sessions** dans la liste des instances. Sous **Activité actuelle**, l’élément **Sessions** affiche la charge de base de données dans les sessions actives moyennes lors des cinq dernières minutes. La barre affiche visuellement le chargement. Lorsque la barre est vide, l'instance est inactive. La barre se remplit de bleu à mesure que le chargement augmente. Lorsque la charge dépasse le nombre de virtual CPUs (vCPUs) sur la classe d'instance, la barre devient rouge, ce qui indique un goulot d'étranglement potentiel.
![\[La page Clusters présente un cluster régional Amazon DocumentDB ainsi que le processeur et l'activité actuelle de chaque instance de cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/opening-clusters.png)
1. (Facultatif) Choisissez un intervalle de temps différent en sélectionnant un bouton dans le coin supérieur droit. Par exemple, pour modifier l'intervalle à 1 heure, sélectionnez 1 **heure**.
![\[Boutons d'intervalle de temps allant de cinq minutes à une semaine.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/opening-time.png)
Dans la capture d'écran suivante, l'intervalle de chargement de la base de données est de 1 heure.
![\[Diagramme à barres montrant la charge de base de données mesurée en moyenne par sessions actives.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/opening-db-load.png)
1. Pour actualiser automatiquement vos données, activez l'option **Actualisation automatique**.
![\[Le bouton d'actualisation automatique activé apparaît à côté des boutons d'intervalle de temps.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/opening-auto-refresh.png)
Le tableau de bord Performance Insight s'actualise automatiquement avec de nouvelles données. Le taux de rafraîchissement dépend de la quantité de données affichées :
+ Si vous choisissez 5 minutes, les données seront actualisées toutes les 5 secondes.
+ 1 heure se réactualise toutes les minutes.
+ 5 heures se réactualise toutes les minutes.
+ 24 heures se réactualise toutes les 5 minutes.
+ 1 semaine se réactualise toutes les heures.
# Analyse du chargement de la base de données par états d'attente
Si le graphique **de charge de base de données (charge de base de données)** indique un goulot d'étranglement, vous pouvez savoir d'où vient la charge. Pour ce faire, examinez le tableau des principaux éléments de charge en dessous du graphique **Database load (Charge de la base de données)**. Choisissez un élément en particulier, comme une requête ou une application, pour accéder à cet élément et en voir les détails.
La charge de base de données regroupée par temps d'attente et par requêtes les plus fréquentes fournit généralement le meilleur aperçu des problèmes de performances. L’affichage de la charge de la base de données en fonction de l’attente indique s’il existe des goulots d’étranglement liés aux ressources ou à des actions simultanées dans la base de données. Dans ce cas, l'onglet **Principales requêtes** du tableau des éléments à charger le plus souvent indique quelles requêtes sont à l'origine de cette charge.
Votre flux de travail standard pour diagnostiquer les problèmes de performances se présente comme suit :
1. Dans le graphique **Database load (Charge de la base de données)**, regardez s’il existe des incidents de charge de base de données qui dépassent la ligne **Max CPU (CPU max)**.
1. Si c’est le cas, observez le graphique **Database load (Charge de la base de données)** et identifiez le ou les états d’attente qui sont les principaux responsables.
1. Identifiez les requêtes de synthèse à l'origine de la charge en identifiant les requêtes figurant dans l'onglet **Requêtes** les plus fréquentes du tableau des éléments de chargement les plus importants qui contribuent le plus à ces états d'attente. Vous pouvez les identifier à l'aide de la colonne **Load by Wait (AAS)**.
1. Choisissez l'une de ces requêtes de synthèse dans l'onglet **Principales requêtes** pour la développer et voir les requêtes enfants qui la composent.
Vous pouvez également voir quels hôtes ou quelles applications contribuent le plus à la charge en sélectionnant les **meilleurs hôtes** ou **les meilleures applications**, respectivement. Les noms des applications sont spécifiés dans la chaîne de connexion à l'instance Amazon DocumentDB. `Unknown`indique que le champ d'application n'a pas été spécifié.
Par exemple, dans le tableau de bord suivant, les temps d'attente **du processeur** représentent la majeure partie de la charge de base de données. La sélection de la première requête sous **Principales requêtes** permet d'étendre le graphique de charge de la base de données afin de se concentrer sur la charge la plus importante apportée par la requête sélectionnée.
![\[Tableau de charge de la base de données indiquant le pic d'utilisation du processeur. L'onglet Principales requêtes correspondant affiche les requêtes qui contribuent le plus aux états d'attente.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/db-load-1.png)
![\[Tableau de charge de la base de données indiquant le pic d'utilisation du processeur pour la requête qui contribue le plus aux états d'attente. L'onglet Principales requêtes correspondant affiche les requêtes secondaires de cette requête.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/db-load-2.png)
# Vue d'ensemble de l'onglet Requêtes les plus fréquentes
Par défaut, l'onglet **Requête principale** affiche les requêtes qui contribuent le plus à la charge de la base de données. Vous pouvez analyser le texte de la requête pour affiner vos requêtes.
**Topics**
+ [Résumés de requêtes](#performance-insights-top-queries-digests)
+ [Load by waits (AAS) [Charge par attentes (AAS)]](#performance-insights-top-queries-aas)
+ [Affichage des informations détaillées sur les requêtes](#performance-insights-top-queries-query-info)
+ [Accès au texte d'une requête de déclaration](#performance-insights-top-queries-accessing-text)
+ [Afficher et télécharger le texte d'une requête de relevé](#performance-insights-top-queries-viewing-downloading)
## Résumés de requêtes
Un *résumé de requête* est un composite de plusieurs requêtes réelles qui sont structurellement similaires mais qui peuvent avoir des valeurs littérales différentes. Le récapitulatif remplace les valeurs codées en dur par un point d’interrogation. Par exemple, un résumé de requête peut ressembler à ceci :
```
{"find":"customerscollection","filter":{"FirstName":"?"},"sort":{"key":{"$numberInt":"?"}},"limit":{"$numberInt":"?"}}
```
Ce récapitulatif peut inclure les requêtes enfant suivantes :
```
{"find":"customerscollection","filter":{"FirstName":"Karrie"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
{"find":"customerscollection","filter":{"FirstName":"Met"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
{"find":"customerscollection","filter":{"FirstName":"Rashin"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
```
Pour voir les instructions de requête littérales dans un résumé, sélectionnez la requête, puis le symbole plus (`+`). Dans la capture d'écran suivante, la requête sélectionnée est un récapitulatif.
![\[Le tableau des requêtes les plus fréquentes présente un résumé détaillé des requêtes avec une requête enfant sélectionnée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/top-queries-literal.png)
**Note**
Un résumé de requête regroupe des instructions de requête similaires, mais ne supprime pas les informations sensibles.
## Load by waits (AAS) [Charge par attentes (AAS)]
Dans les **requêtes les plus** importantes, la colonne **Load by waits (AAS)** illustre le pourcentage de charge de base de données associé à chaque élément de charge maximale. Cette colonne reflète la charge de cet élément selon le groupe actuellement sélectionné dans le **graphique de charge de la base** de données. Par exemple, vous pouvez regrouper le graphique **DB Load (Charge de la base de données)** par états d'attente. Dans ce cas, la dimension, la segmentation et le code de couleurs de la barre **DB Load by Waits (Charge de base de données par attente)** représentent la proportion du temps d’un état d’attente donné auquel cette requête contribue. Cette barre indique également les états d’attente qui affectent la requête sélectionnée.
![\[Diagramme à barres illustrant la charge de la base de données groupée par état d'attente du processeur, des E/S et du latch. Le tableau correspondant indique les principales requêtes basées sur le chargement par attente.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/top-queries-aas.png)
## Affichage des informations détaillées sur les requêtes
Dans la table des **requêtes Top**, vous pouvez ouvrir une *instruction* de synthèse pour afficher ses informations. Les informations s’affichent dans le volet inférieur.
![\[Le tableau des requêtes les plus fréquentes présente une instruction de requête sélectionnée et ses informations de requête ci-dessous.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/top-queries-detailed.png)
Les types d'identificateurs (IDs) suivants sont associés aux instructions de requête :
1. **ID de requête de support** : valeur de hachage de l'ID de requête. Cette valeur sert uniquement à référencer un ID de requête lorsque vous travaillez avec AWS Support. AWS Support n'a pas accès à votre requête ni au texte IDs de votre requête.
1. **Support Digest ID** : valeur de hachage de l'ID digest. Cette valeur sert uniquement à référencer un identifiant de résumé lorsque vous travaillez avec AWS Support. AWS Support n'a pas accès à votre résumé ni au texte IDs de votre requête.
## Accès au texte d'une requête de déclaration
Par défaut, chaque ligne du tableau des **requêtes les plus** fréquentes affiche 500 octets de texte de requête pour chaque instruction de requête. Lorsqu'une instruction de synthèse dépasse 500 octets, vous pouvez afficher plus de texte en ouvrant l'instruction dans le tableau de bord Performance Insights. Dans ce cas, la longueur maximale de la requête affichée est de 1 Ko. Si vous consultez un énoncé de requête complet, vous pouvez également choisir **Télécharger**.
## Afficher et télécharger le texte d'une requête de relevé
Dans le tableau de bord Performance Insights, vous pouvez consulter ou télécharger le texte de la requête.
**Pour afficher davantage de texte de requête dans le tableau de bord Performance Insights**
1. Ouvrez la console Amazon DocumentDB à l'adresse suivante : [https://console.aws.amazon.com/docdb/](https://console.aws.amazon.com/docdb/)
1. Dans le panneau de navigation, choisissez **Performance Insights**.
1. Choisissez une instance de base de données. Le tableau de bord de Performance Insights s'affiche pour cette instance de base de données.
Les instructions de requête dont le texte est supérieur à 500 octets ressembleront à l'image suivante :
![\[Le tableau des requêtes les plus fréquentes avec une requête enfant sélectionnée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/top-queries-statement.png)
1. Consultez la section des informations sur la requête pour voir une plus grande partie du texte de la requête.
![\[La section Informations sur la requête affiche le texte intégral de la requête sélectionnée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/top-queries-query-text.png)
Le tableau de bord Performance Insights peut afficher jusqu'à 1 Ko pour chaque instruction de requête complète.
**Note**
Pour copier ou télécharger l'instruction de requête, désactivez les bloqueurs de fenêtres contextuelles.
# Zoom sur le graphique de charge de la base de données
Vous pouvez utiliser d'autres fonctions de l'interface utilisateur Performance Insights pour vous aider à analyser les données de performance.
**Click-and-Drag Zoomer**
Dans l'interface Performance Insights, vous pouvez sélectionner une petite portion du graphique de charge et faire un zoom avant sur les détails.
![\[Diagramme à barres illustrant le chargement de la base de données, dont une partie est surlignée pour permettre de zoomer.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/pi-zoom-1.png)
Faites un zoom avant sur une portion du graphique de charge, choisissez l'heure de début et faites glisser jusqu'à la fin de la période souhaitée. Lorsque vous faites ceci, la zone sélectionnée est mise en évidence. Lorsque vous relâchez la souris, le graphique de charge zoome sur la zone sélectionnée et le tableau des **principaux *éléments*** est recalculé.
![\[Graphique à barres de charge de la base de données montrant la partie agrandie, avec le tableau des temps d'attente supérieurs correspondant ci-dessous.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/pi-zoom-2.png)
# Récupération de métriques avec l’API Performance Insights
Lorsque l'API Performance Insights est activée, elle fournit une visibilité sur les performances des instances. Amazon CloudWatch Logs fournit la source officielle pour les mesures de surveillance des ventes pour AWS les services.
Performance Insights offre une vue spécifique au domaine de la charge de base de données mesurée en tant que moyenne des sessions actives (AAS). Cette métrique est présentée aux consommateurs de l’API sous la forme d’un ensemble de données de série chronologique bidimensionnel. La dimension temporelle des données fournit les données de charge de la base de données pour chaque point temporel de la plage de temps interrogée. Chaque point dans te temps décompose la charge globale par rapport aux dimensions demandées, par exemple, `Query`, `Wait-state`, `Application` ou `Host`, mesurée à ce point dans le temps.
Amazon DocumentDB Performance Insights surveille votre instance de base de données Amazon DocumentDB afin que vous puissiez analyser et résoudre les problèmes liés aux performances de la base de données. Vous pouvez consulter les données de Performance Insights dans AWS Management Console. Performance Insights fournit également une API publique qui vous permet d’interroger vos propres données. Vous pouvez utiliser l’API pour effectuer les opérations suivantes :
+ Déchargement des données dans une base de données
+ Ajout de données Performance Insights aux tableaux de bord de surveillance existants
+ Création d’outils de surveillance
Pour utiliser l'API Performance Insights, activez Performance Insights sur l'une de vos instances Amazon DocumentDB. Pour plus d’informations sur l’activation de Performance Insights, consultez [Activation et désactivation de Performance Insights](performance-insights-enabling.md). Pour de plus amples informations sur l'API Performance Insights, veuillez consulter la [Référence d'API Performance Insights](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html).
L’API Performance Insights fournit les opérations suivantes.
****
| Action Performance Insights | AWS CLI commande | Description |
| --- | --- | --- |
| [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/describe-dimension-keys.html](https://docs.aws.amazon.com/cli/latest/reference/pi/describe-dimension-keys.html) | Récupère les N premières clés de dimension d'une mesure sur une période spécifique. |
| [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/get-dimension-key-details.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-dimension-key-details.html) | Récupère les attributs du groupe de dimensions spécifié pour une instance de base de données ou une source de données. Par exemple, si vous spécifiez un ID de requête et si les détails de la dimension sont disponibles, le texte intégral de la dimension `db.query.statement` associée à cet ID est `GetDimensionKeyDetails` extrait. Cette opération est utile car elle `GetResourceMetrics` `DescribeDimensionKeys` ne permet pas de récupérer un texte d'instruction de requête volumineux. |
| [GetResourceMetadata](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetadata.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metadata.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metadata.html) | Récupérez les métadonnées de différentes fonctions. Par exemple, les métadonnées peuvent indiquer qu’une fonction est activée ou désactivée sur une instance de base de données spécifique. |
| [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html) | Récupère les métriques Performance Insights d’un ensemble de sources de données, au cours d’une période. Vous pouvez fournir des groupes de dimensions et des dimensions spécifiques, ainsi que des critères d’agrégation et de filtrage, pour chaque groupe. |
| [ListAvailableResourceDimensions](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceDimensions.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-dimensions.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-dimensions.html) | Récupérez les dimensions pouvant être interrogées pour chaque type de métrique spécifié sur une instance spécifiée. |
| [ListAvailableResourceMetrics](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceMetrics.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-metrics.html) | Récupérez toutes les métriques disponibles des types de métriques spécifiés pouvant être interrogés pour une instance de base de données spécifiée. |
**Topics**
+ [AWS CLI pour Performance Insights](#performance-insights-metrics-CLI)
+ [Récupération de métriques de série chronologique](#performance-insights-metrics-time-series)
+ [AWS CLI exemples de Performance Insights](#performance-insights-metrics-api-examples)
## AWS CLI pour Performance Insights
Vous pouvez consulter les données de Performance Insights à l’aide d AWS CLI. Vous pouvez obtenir de l’aide sur les commandes AWS CLI relatives à Performance Insights en saisissant le code suivant sur la ligne de commande.
```
aws pi help
```
Si ce n'est pas le AWS CLI cas, reportez-vous à la section [Installation de l'interface de ligne de AWS commande](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) dans le *guide de AWS CLI l'utilisateur* pour plus d'informations sur son installation.
## Récupération de métriques de série chronologique
L'opération `GetResourceMetrics` récupère une ou plusieurs métriques de série chronologique à partir des données de Performance Insights. `GetResourceMetrics` exige une métrique et une période, et renvoie une réponse contenant la liste des points de données.
Par exemple, les AWS Management Console utilisations `GetResourceMetrics` pour remplir le graphique **Counter Metrics** et le graphique de **charge de base** de données, comme indiqué dans l'image suivante.
![\[Graphiques Counter Metrics (Métriques de compteur) et Database Load (Charge de base de données)\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/perf-insights-api-charts.png)
Toutes les métriques renvoyées par `GetResourceMetrics` sont des métriques de série chronologique standard, à l’exception de `db.load`. Elle apparaît dans le graphique **Database Load** (Charge de base de données). La métrique `db.load` est différente des autres métriques de série chronologique, car vous pouvez la décomposer en sous-composants appelés *dimensions*. Dans l’image précédente, `db.load` est décomposé et regroupé en fonction des états d’attente qui constituent `db.load`.
**Note**
`GetResourceMetrics` peut également renvoyer la métrique `db.sampleload`, mais la métrique `db.load` est appropriée dans la plupart des cas.
Pour plus d’informations sur les métriques de compteur renvoyées par `GetResourceMetrics`, consultez [Performance Insights pour les contre-métriques](performance-insights-counter-metrics.md).
Les calculs suivants sont pris en charge pour les métriques :
+ Moyenne – Moyenne de la métrique sur une période. Ajoutez `.avg` au nom de la métrique.
+ Minimum – Valeur minimale de la métrique sur une période. Ajoutez `.min` au nom de la métrique.
+ Maximum – Valeur maximale de la métrique sur une période. Ajoutez `.max` au nom de la métrique.
+ Somme – Somme des valeurs de la métrique sur une période. Ajoutez `.sum` au nom de la métrique.
+ Nombre échantillon – Nombre de fois où la métrique a été collectée sur une période. Ajoutez `.sample_count` au nom de la métrique.
Par exemple, supposons qu’une métrique soit collectée pendant 300 secondes (5 minutes) et qu’elle soit collectée une fois toutes les minutes. Les valeurs pour chaque minute sont 1, 2, 3, 4 et 5. Dans ce cas, les calculs suivants sont renvoyés :
+ Moyenne – 3
+ Minimum – 1
+ Maximum – 5
+ Somme – 15
+ Nombre échantillon – 5
Pour plus d'informations sur l'utilisation de la `get-resource-metrics` AWS CLI commande, consultez [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html).
Pour l’option `--metric-queries`, spécifiez une ou plusieurs requêtes pour lesquelles vous souhaitez obtenir les résultats. Chaque requête se compose d’un paramètre `Metric` obligatoire et des paramètres `GroupBy` et `Filter` facultatifs. Voici un exemple de spécification de l’option `--metric-queries`.
```
{
"Metric": "string",
"GroupBy": {
"Group": "string",
"Dimensions": ["string", ...],
"Limit": integer
},
"Filter": {"string": "string"
...}
```
## AWS CLI exemples de Performance Insights
Les exemples suivants montrent comment utiliser AWS CLI for Performance Insights.
**Topics**
+ [Récupération de métriques de compteur](#performance-insights-metrics-api-examples.CounterMetrics)
+ [Récupération de la charge moyenne de la base de données pour les états d'attente les plus élevés](#performance-insights-metrics-api-examples.DBLoadAverage)
+ [Récupération de la charge moyenne de la base de données pour la meilleure requête](#performance-insights-metrics-api-examples.topquery)
+ [Récupération de la charge moyenne de base de données filtrée par requête](#performance-insights-metrics-api-examples.DBLoadAverageByQuery)
### Récupération de métriques de compteur
L’image suivante illustre deux graphiques de métriques de compteur dans AWS Management Console.
![\[Graphiques Counter Metrics (Métriques de compteur).\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/performance-insights/perf-insights-api-counters-charts.png)
L'exemple suivant décrit comment collecter les mêmes données utilisées par AWS Management Console pour générer les deux graphiques Counter Metrics (Métriques de compteur).
Pour Linux, macOS ou Unix :
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 60 \
--metric-queries '[{"Metric": "os.cpuUtilization.user.avg" },
{"Metric": "os.cpuUtilization.idle.avg"}]'
```
Pour Windows :
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 60 ^
--metric-queries '[{"Metric": "os.cpuUtilization.user.avg" },
{"Metric": "os.cpuUtilization.idle.avg"}]'
```
Vous pouvez également simplifier la lecture d'une commande en spécifiant un fichier pour l'option `--metrics-query`. L’exemple suivant utilise un fichier nommé query.json pour l’option. Le contenu du fichier est le suivant.
```
[
{
"Metric": "os.cpuUtilization.user.avg"
},
{
"Metric": "os.cpuUtilization.idle.avg"
}
]
```
Exécutez la commande suivante pour utiliser le fichier.
Pour Linux, macOS ou Unix :
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 60 \
--metric-queries file://query.json
```
Pour Windows :
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 60 ^
--metric-queries file://query.json
```
L'exemple précédent spécifie les valeurs suivantes pour les options :
+ `--service-type`— `DOCDB` pour Amazon DocumentDB
+ `--identifier` : ID de ressource de l’instance de base de données
+ `--start-time` et `--end-time` : valeurs `DateTime` conformes à l’ISO 8601 pour la période à interroger, avec plusieurs formats pris en charge
L’interrogation se déroule pendant un intervalle d’une heure :
+ `--period-in-seconds` – `60` pour une requête toutes les minutes
+ `--metric-queries` : tableau de deux requêtes s’appliquant chacune à une métrique.
Le nom de la métrique utilise des points pour classifier la métrique dans une catégorie utile, l’élément final étant une fonction. Dans l’exemple, la fonction est `avg` pour chaque requête. Comme pour Amazon CloudWatch, les fonctions prises en charge sont `min``max`,`total`, et`avg`.
La réponse ressemble à ce qui suit.
```
{
"AlignedStartTime": "2022-03-13T08:00:00+00:00",
"AlignedEndTime": "2022-03-13T09:00:00+00:00",
"Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
"MetricList": [
{
"Key": {
"Metric": "os.cpuUtilization.user.avg"
},
"DataPoints": [
{
"Timestamp": "2022-03-13T08:01:00+00:00", //Minute1
"Value": 3.6
},
{
"Timestamp": "2022-03-13T08:02:00+00:00", //Minute2
"Value": 2.6
},
//.... 60 datapoints for the os.cpuUtilization.user.avg metric
{
"Key": {
"Metric": "os.cpuUtilization.idle.avg"
},
"DataPoints": [
{
"Timestamp": "2022-03-13T08:01:00+00:00",
"Value": 92.7
},
{
"Timestamp": "2022-03-13T08:02:00+00:00",
"Value": 93.7
},
//.... 60 datapoints for the os.cpuUtilization.user.avg metric
]
}
] //end of MetricList
} //end of response
```
La réponse contient les éléments `Identifier`, `AlignedStartTime` et `AlignedEndTime`. Étant donné que la valeur de `--period-in-seconds` était définie sur `60`, les heures de début et de fin ont été arrondies à la minute près. Si `--period-in-seconds` était défini sur `3600`, les heures de début et de fin auraient été arrondies à l’heure près.
L’élément `MetricList` dans la réponse comporte un certain nombre d’entrées, chacune associée à une entrée `Key` et `DataPoints`. Chaque élément `DataPoint` comporte une entrée `Timestamp` et `Value`. Chaque liste `Datapoints` répertorie 60 points de données, car les requêtes sont exécutées toutes les minutes pendant une heure, avec `Timestamp1/Minute1`, `Timestamp2/Minute2`, etc. jusqu’à `Timestamp60/Minute60`.
Étant donné que la requête s’applique à deux métriques de compteur différentes, contient deux élément `MetricList`.
### Récupération de la charge moyenne de la base de données pour les états d'attente les plus élevés
L'exemple suivant est la même requête que celle AWS Management Console utilisée pour générer un graphique linéaire à aires empilées. Cet exemple extrait le résultat de la `db.load.avg` dernière heure en divisant la charge en fonction des sept premiers états d'attente. La commande est identique à la commande de la rubrique [Récupération de métriques de compteur](#performance-insights-metrics-api-examples.CounterMetrics). Le contenu du fichier query.json est cependant différent :
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.wait_state", "Limit": 7 }
}
]
```
Exécutez la commande suivante.
Pour Linux, macOS ou Unix :
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 60 \
--metric-queries file://query.json
```
Pour Windows :
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 60 ^
--metric-queries file://query.json
```
L'exemple indique la métrique de `db.load.avg` et a `GroupBy` des sept premiers états d'attente. Pour plus de détails sur les valeurs valides pour cet exemple, consultez [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html)le manuel *Performance Insights API Reference.*
La réponse ressemble à ce qui suit.
```
{
"AlignedStartTime": "2022-04-04T06:00:00+00:00",
"AlignedEndTime": "2022-04-04T06:15:00+00:00",
"Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
"MetricList": [
{//A list of key/datapoints
"Key": {
//A Metric with no dimensions. This is the total db.load.avg
"Metric": "db.load.avg"
},
"DataPoints": [
//Each list of datapoints has the same timestamps and same number of items
{
"Timestamp": "2022-04-04T06:01:00+00:00",//Minute1
"Value": 0.0
},
{
"Timestamp": "2022-04-04T06:02:00+00:00",//Minute2
"Value": 0.0
},
//... 60 datapoints for the total db.load.avg key
]
},
{
"Key": {
//Another key. This is db.load.avg broken down by CPU
"Metric": "db.load.avg",
"Dimensions": {
"db.wait_state.name": "CPU"
}
},
"DataPoints": [
{
"Timestamp": "2022-04-04T06:01:00+00:00",//Minute1
"Value": 0.0
},
{
"Timestamp": "2022-04-04T06:02:00+00:00",//Minute2
"Value": 0.0
},
//... 60 datapoints for the CPU key
]
},//... In total we have 3 key/datapoints entries, 1) total, 2-3) Top Wait States
] //end of MetricList
} //end of response
```
Dans cette réponse, il y a trois entrées dans le`MetricList`. Il y a une entrée pour le total`db.load.avg`, et trois entrées chacune pour le résultat `db.load.avg` divisé en fonction de l'un des trois premiers états d'attente. Comme il existait une dimension de regroupement (contrairement au premier exemple), il doit y avoir une clé pour chaque regroupement de la métrique. Un seul élément Key peut être associé à chaque métrique, comme dans le cas d’utilisation de la métrique de compteur de base.
### Récupération de la charge moyenne de la base de données pour la meilleure requête
L'exemple suivant regroupe `db.wait_state` les 10 principales instructions de requête. Il existe deux groupes différents pour les instructions de requête :
+ `db.query`— L'instruction de requête complète, telle que `{"find":"customers","filter":{"FirstName":"Jesse"},"sort":{"key":{"$numberInt":"1"}}}`
+ `db.query_tokenized`— L'instruction de requête tokenisée, telle que `{"find":"customers","filter":{"FirstName":"?"},"sort":{"key":{"$numberInt":"?"}},"limit":{"$numberInt":"?"}}`
Lors de l'analyse des performances d'une base de données, il peut être utile de considérer les instructions de requête dont les paramètres ne diffèrent que comme un élément logique. Vous pouvez donc utiliser `db.query_tokenized` lors de l’interrogation. Cependant, en particulier lorsque cela vous intéresse`explain()`, il est parfois plus utile d'examiner des instructions de requête complètes avec des paramètres. Il existe une relation parent-enfant entre les requêtes tokenisées et les requêtes complètes, plusieurs requêtes complètes (enfants) étant regroupées sous la même requête tokenisée (parent).
La commande illustrée dans cet exemple est identique à la commande de la rubrique [Récupération de la charge moyenne de la base de données pour les états d'attente les plus élevés](#performance-insights-metrics-api-examples.DBLoadAverage). Le contenu du fichier query.json est cependant différent :
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.query_tokenized", "Limit": 10 }
}
]
```
L'exemple suivant utilise `db.query_tokenized`.
Pour Linux, macOS ou Unix :
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 3600 \
--metric-queries file://query.json
```
Pour Windows :
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 3600 ^
--metric-queries file://query.json
```
Cet exemple montre des requêtes de plus d'une heure, avec une minute period-in-seconds.
L'exemple indique la métrique de `db.load.avg` et a `GroupBy` des sept premiers états d'attente. Pour plus de détails sur les valeurs valides pour cet exemple, consultez [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html)le manuel *Performance Insights API Reference.*
La réponse ressemble à ce qui suit.
```
{
"AlignedStartTime": "2022-04-04T06:00:00+00:00",
"AlignedEndTime": "2022-04-04T06:15:00+00:00",
"Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
"MetricList": [
{//A list of key/datapoints
"Key": {
"Metric": "db.load.avg"
},
"DataPoints": [
//... 60 datapoints for the total db.load.avg key
]
},
{
"Key": {//Next key are the top tokenized queries
"Metric": "db.load.avg",
"Dimensions": {
"db.query_tokenized.db_id": "pi-1064184600",
"db.query_tokenized.id": "77DE8364594EXAMPLE",
"db.query_tokenized.statement": "{\"find\":\"customers\",\"filter\":{\"FirstName\":\"?\"},\"sort\":{\"key\":{\"$numberInt\":\"?\"}},\"limit\"
:{\"$numberInt\":\"?\"},\"$db\":\"myDB\",\"$readPreference\":{\"mode\":\"primary\"}}"
}
},
"DataPoints": [
//... 60 datapoints
]
},
// In total 11 entries, 10 Keys of top tokenized queries, 1 total key
] //End of MetricList
} //End of response
```
Cette réponse comporte 11 entrées `MetricList` (1 au total, 10 requêtes les plus tokenisées), chaque entrée en comptant 24 par heure. `DataPoints`
Pour les requêtes tokenisées, chaque liste de dimensions comporte trois entrées :
+ `db.query_tokenized.statement`— L'instruction de requête tokenisée.
+ `db.query_tokenized.db_id `— L'identifiant synthétique que Performance Insights génère pour vous. Cet exemple renvoie l’ID synthétique `pi-1064184600`.
+ `db.query_tokenized.id` – ID de la requête dans Performance Insights.
Dans le AWS Management Console, cet ID est appelé Support ID. Il est nommé ainsi parce que l'ID est une donnée que le AWS Support peut examiner pour vous aider à résoudre un problème lié à votre base de données. AWS prend très au sérieux la sécurité et la confidentialité de vos données, et presque toutes les données sont stockées cryptées avec votre AWS KMS key. Par conséquent, personne à l'intérieur ne AWS peut consulter ces données. Dans l’exemple précédent, `tokenized.statement` et `tokenized.db_id` sont tous les deux stockés sous forme chiffrée. Si vous rencontrez un problème avec votre base de données, le AWS Support peut vous aider en faisant référence à l'ID de support.
Lors de l’interrogation, il peut s’avérer utile de spécifier une entrée `Group` dans `GroupBy`. Toutefois, pour contrôler les données renvoyées de manière plus précise, spécifier la liste des dimensions. Par exemple, si `db.query_tokenized.statement` est le seul élément nécessaire, un attribut `Dimensions` peut être ajouté au fichier query.json.
```
[
{
"Metric": "db.load.avg",
"GroupBy": {
"Group": "db.query_tokenized",
"Dimensions":["db.query_tokenized.statement"],
"Limit": 10
}
}
]
```
### Récupération de la charge moyenne de base de données filtrée par requête
La requête d’API correspondante illustrée dans cet exemple est identique à la commande de la rubrique [Récupération de la charge moyenne de la base de données pour la meilleure requête](#performance-insights-metrics-api-examples.topquery). Le contenu du fichier query.json est cependant différent :
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.wait_state", "Limit": 5 },
"Filter": { "db.query_tokenized.id": "AKIAIOSFODNN7EXAMPLE" }
}
]
```
Dans cette réponse, toutes les valeurs sont filtrées en fonction de la contribution de la requête tokenisée AKIAIOSFODNN7 EXAMPLE spécifiée dans le fichier query.json. Les clés peuvent également suivre un ordre différent de celui d'une requête sans filtre, car ce sont les cinq premiers états d'attente qui ont affecté la requête filtrée.
# Statistiques CloudWatch Amazon pour Performance Insights
Performance Insights publie automatiquement les statistiques sur Amazon CloudWatch. Les mêmes données peuvent être consultées à partir de Performance Insights, mais l'ajout des métriques CloudWatch facilite l'ajout CloudWatch d'alarmes. ainsi que l'ajout des métriques à des tableaux de bord CloudWatch existants.
| Métrique | Description |
| --- | --- |
| DBLoad | Le nombre de sessions actives pour Amazon DocumentDB. Vous souhaitez généralement obtenir les données relatives au nombre moyen de sessions actives. Dans Performance Insights, ces données sont interrogées sous la forme `db.load.avg`. |
| DBLoadCPU | Le nombre de sessions actives où le type d'état d'attente est CPU. Dans Performance Insights, ces données sont demandées et filtrées en fonction `db.load.avg` du type d'état d'attente. `CPU` |
| DBLoadNon processeur | Le nombre de sessions actives où le type d'état d'attente n'est pas CPU. |
**Note**
Ces métriques ne sont publiées CloudWatch que si l'instance de base de données est chargée.
Vous pouvez examiner ces métriques à l'aide de la CloudWatch console, de ou de l' CloudWatchAPI. AWS CLI
Par exemple, vous pouvez obtenir les statistiques de la `DBLoad` métrique en exécutant la [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html)commande.
```
aws cloudwatch get-metric-statistics \
--region ap-south-1 \
--namespace AWS/DocDB \
--metric-name DBLoad \
--period 360 \
--statistics Average \
--start-time 2022-03-14T8:00:00Z \
--end-time 2022-03-14T9:00:00Z \
--dimensions Name=DBInstanceIdentifier,Value=documentdbinstance
```
Cet exemple génère une sortie similaire à la suivante.
```
{
"Datapoints": [
{
"Timestamp": "2022-03-14T08:42:00Z",
"Average": 1.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:24:00Z",
"Average": 2.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:54:00Z",
"Average": 6.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:36:00Z",
"Average": 5.7,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:06:00Z",
"Average": 4.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:00:00Z",
"Average": 5.2,
"Unit": "None"
}
],
"Label": "DBLoad"
}
```
Vous pouvez utiliser la fonction mathématique des `DB_PERF_INSIGHTS` métriques de la CloudWatch console pour interroger les métriques des compteurs Amazon DocumentDB Performance Insights. La `DB_PERF_INSIGHTS` fonction inclut également la `DBLoad` métrique à des intervalles inférieurs à la minute. Vous pouvez définir des CloudWatch alarmes sur ces métriques. Pour plus de détails sur la création d'une alarme, voir [Créer une alarme sur les indicateurs de compteur Performance Insights à partir d'une AWS base de données](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarm_database_performance_insights.html).
Pour plus d'informations CloudWatch, consultez [Qu'est-ce qu'Amazon CloudWatch ?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) dans le *guide de CloudWatch l'utilisateur Amazon*.
# Performance Insights pour les contre-métriques
Les contre-métriques sont des mesures du système d'exploitation figurant dans le tableau de bord Performance Insights. Vous pouvez établir des corrélations entre ces informations et la charge de la base de données pour identifier et analyser les problèmes de performances.
## Compteurs de système d’exploitation Performance Insights
Les compteurs de système d'exploitation suivants sont disponibles avec Amazon DocumentDB Performance Insights.
| Compteur | Type | Métrique |
| --- | --- | --- |
| actif | memory | os.memory.active |
| buffers | memory | os.memory.buffers |
| mis en cache | memory | os.memory.cached |
| dirty | memory | os.memory.dirty |
| free | memory | os.memory.free |
| inactive | memory | os.memory.inactive |
| mapped | memory | os.memory.mapped |
| pageTables | memory | os.memory.pageTables |
| slab | memory | os.memory.slab |
| total | memory | os.memory.total |
| writeback | memory | os.memory.writeback |
| idle | cpuUtilization | os.cpuUtilization.idle |
| system | cpuUtilization | os.cpuUtilization.system |
| total | cpuUtilization | os.cpuUtilization.total |
| user | cpuUtilization | os.cpuUtilization.user |
| wait | cpuUtilization | os.cpuUtilization.wait |
| one | loadAverageMinute | os. loadAverageMinute.un |
| fifteen | loadAverageMinute | os. loadAverageMinute.quinze |
| five | loadAverageMinute | os. loadAverageMinute.cinq |
| mis en cache | swap | os.swap.cached |
| free | swap | os.swap.free |
| dans | swap | os.swap.in |
| out | swap | os.swap.out |
| total | swap | os.swap.total |
| rx | network | os.network.rx |
| tx | network | os.network.tx |
| num VCPUs | general | os.general.num VCPUs |