Explorer les cartes de densité

Cette page explique comment analyser la carte de densité d'une analyse Key Visualizer afin d'identifier la source d'un problème de performances de Firestore.

Avant de lire cette page, vous devez avoir étudié la présentation de Key Visualizer. Vous pouvez également :

découvrir comment ouvrir une analyse Key Visualizer ;
Consultez des exemples courants de modèles de clés de document ou de modèles de clés d'index.

Régler la luminosité

Dans les cartes de densité de Key Visualizer, les couleurs foncées indiquent des valeurs normales ou faibles, et les couleurs vives représentent des valeurs élevées. Vous pouvez ajuster l'échelle de couleurs pour vous aider à voir les motifs sur la carte de densité.

Gardez à l'esprit que pour la plupart des métriques, Key Visualizer identifie les valeurs "élevées" et "faibles" en s'appuyant uniquement sur l'utilisation de votre base de données. Par exemple, si vous effectuez 20 lectures par seconde dans une plage de clés spécifique et 1 lecture par seconde dans d'autres plages, Key Visualizer utilisera une couleur vive pour la première plage. Les couleurs vives n'indiquent pas nécessairement un problème.

Pour régler les couleurs utilisées pour différentes valeurs, utilisez les boutons +/- situés de chaque côté de l'icône Régler la luminosité. Lorsque vous augmentez la luminosité, vous diminuez la plage des valeurs représentées par chaque couleur ; à l'inverse, lorsque vous réduisez la luminosité, vous augmentez cette plage.

Pour rétablir le paramètre par défaut, cliquez sur l'icône Régler la luminosité.

Faire un zoom avant sur des périodes et des plages de clés

Lorsque vous ouvrez une carte de densité, elle affiche des valeurs pour la période incluse dans l'analyse et pour la plage de clés actives dans votre base de données. Si vous remarquez un problème au cours d'une période spécifique ou dans une plage de clés en particulier, vous pouvez effectuer un zoom avant afin de l'examiner plus en détail.

Vous pouvez effectuer un zoom avant ou arrière de différentes manières :

Faites défiler la carte de densité vers le haut ou le bas.
Cliquez sur le bouton Zoom rectangulaire, puis faites glisser le pointeur de la souris tout en maintenant le bouton enfoncé pour sélectionner une zone à agrandir.
Maintenez la touche Shift enfoncée, puis faites glisser le pointeur de la souris tout en maintenant le bouton enfoncé pour sélectionner une zone à agrandir.
Revenez à la zone précédente de la carte de densité en appuyant sur la touche Backspace ou Delete.
Effectuez un zoom arrière pour afficher l'intégralité de la table en cliquant sur le bouton Réinitialiser le zoom ou en appuyant sur la touche R.

Afficher le détail par préfixe de clé

La section suivante explique comment explorer en détail à l'aide d'une analyse de clé de document à titre d'exemple. Dans le cas de clés d'index, le préfixe devient un groupe de clés d'index.

Sur le côté gauche d'une carte de densité, Key Visualizer organise les clés en fonction de la hiérarchie de votre base de données. Vous pouvez ainsi afficher le détail des données pour des plages de clés spécifiques.

Pour afficher le détail des données de la carte de densité pour un groupe de clés qui partagent un préfixe commun, procédez comme suit :

Déplacez le curseur sur l'un des niveaux de la hiérarchie des clés affichée à gauche de la carte de densité.

Key Visualizer met en surbrillance la zone de la carte de densité qui affiche ce niveau de la hiérarchie. Cet outil indique également le préfixe de toutes les clés de ce niveau.
Cliquez sur le niveau de la hiérarchie des clés que vous voulez examiner.

Key Visualizer effectue un zoom avant sur ce niveau de la hiérarchie.
Cliquez sur un autre niveau de la hiérarchie des clés pour augmenter le facteur de zoom, ou appuyez sur la touche Backspace ou Delete pour revenir à la zone précédente.

Épingler des informations détaillées sur une métrique

Lorsque vous déplacez le curseur sur une carte de densité, Key Visualizer affiche une info-bulle contenant des informations détaillées sur la métrique située sous le curseur. Vous pouvez épingler cette info-bulle en cliquant sur la carte de densité. Les info-bulles épinglées affichent plus de détails sur la métrique. En épinglant une info-bulle, il est également plus facile d'en effectuer une capture d'écran ou de copier des informations à partir de celle-ci.

Changer de métriques

Par défaut, lorsque vous ouvrez une analyse Key Visualizer, elle affiche la métrique Opérations/S pour les clés de document, ce qui vous donne un aperçu de votre modèle d'utilisation. Pour passer à une autre métrique, cliquez sur la liste déroulante Métrique située au-dessus de la carte de densité, puis sur la métrique que vous souhaitez afficher.

Dans le cas des clés d'index, il affiche la métrique Opérations d'écriture d'index/s qui donne un aperçu de l'utilisation des clés d'index.

Pour obtenir une description de chaque métrique, reportez-vous à la page Métriques de Key Visualizer.

Rechercher des connexions entre différentes métriques pour les clés de document

Vous pouvez afficher plusieurs métriques simultanément dans Key Visualizer afin d'effectuer des comparaisons ou de rechercher des corrélations entre des métriques. Par exemple, vous pouvez vérifier si certains hotspots de la carte de densité Ops/s (Opérations par seconde) sont corrélés à une latence élevée dans votre carte de densité Latence en écriture moyenne.

Pour afficher plusieurs métriques et leurs valeurs en même temps, cliquez sur Afficher le panneau d'informations dans l'angle supérieur droit. Une liste de métriques s'affiche alors dans un volet à droite de l'analyse.

Exemple illustrant le volet "Multimetric" pour une analyse

Pour examiner plusieurs métriques en même temps, utilisez les outils suivants du volet "Multimetric" (Multimétrique) :

Pour afficher ou masquer les cartes de densité miniatures de toutes les métriques, cliquez sur Expand All ou Collapse All en haut à droite.
Pour afficher la carte de densité d'une métrique spécifique, cliquez sur le nom de la métrique.
Pour masquer la carte de densité d'une métrique, cliquez à nouveau sur le nom de la métrique.
Pour afficher la carte de densité d'une métrique dans la fenêtre principale, cliquez sur la flèche située à gauche de la barre de titre de la métrique.
Passez la souris sur une carte de densité miniature pour afficher l'activité correspondante dans la vue principale.

Pour comparer différentes métriques d'un bucket de clés au même moment, vous pouvez épingler une valeur dans une analyse, puis basculer vers une autre métrique :

Désignez un point d’intérêt sur la grande carte de densité de la fenêtre principale.
Cliquez pour épingler l'info-bulle. Les valeurs affichées dans le volet latéral restent associées au bucket de clés et au moment que vous avez épinglés.
Pour afficher une métrique dans la grande carte de densité, cliquez sur la flèche pleine à gauche de cette métrique. Tous les détails de cette métrique sont alors affichés dans l'info-bulle de la fenêtre principale.

Étapes suivantes

Apprenez à reconnaître les modèles clés de documents ou à indexer les modèles clés.
Informez-vous sur les métriques que vous pouvez afficher dans une carte de densité.