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.
# 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)