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