Explorer les cartes de densité

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

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 ;
consulter des exemples de modèles courants dans les cartes de densité Key Visualizer.

Examiner les messages de diagnostic

Si Key Visualizer identifie un problème avec vos modèles d'utilisation de Bigtable, l'analyse Key Visualizer affiche des messages de diagnostic au-dessus de la carte de densité. Cliquez sur l'un de ces messages de diagnostic pour obtenir des informations détaillées sur le problème.

Pour obtenir une description de chaque message de diagnostic, consultez la page Messages de diagnostic de Key Visualizer.

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. Si les couleurs d'une carte de densité sont trop vives ou trop foncées, il peut être difficile de déceler les tendances importantes d'une métrique.

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 que vous faites de cette table. Par exemple, si vous effectuez 20 lectures par seconde dans une plage de lignes spécifique et 1 lecture par seconde dans d'autres plages, Key Visualizer utilisera une couleur vive pour cette plage en particulier, bien que le nombre de 20 lectures par seconde soit faible pour Bigtable. Les métriques Avertissements et Performance sont des exceptions à cette règle. Si ces métriques s'affichent en couleurs vives, cela signifie que Key Visualizer a identifié un problème potentiel.

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.

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

Lorsque vous ouvrez une carte de densité, elle affiche des valeurs pour l'ensemble de la période couverte par l'analyse, ainsi que toute la plage de clés de ligne de votre table. Si vous remarquez un problème au cours d'une période spécifique ou dans une plage de clés de ligne 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é de ligne

Les clés de ligne sont souvent composées d'une hiérarchie de valeurs, chaque valeur étant séparée par un délimiteur. Par exemple, la clé de ligne memusage#1423523569918 contient un identifiant pour toutes les lignes qui enregistrent l'utilisation de la mémoire, suivi d'un horodatage qui identifie un ensemble de données spécifique au sein de ce groupe. Key Visualizer identifie automatiquement ce type de clé de ligne et le décompose en une hiérarchie, ce qui vous permet d'afficher plus rapidement le détail des données pour des plages de clés de ligne spécifiques.

Pour afficher le détail des données de la carte de densité pour un groupe de clés de ligne 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 de ligne 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 ligne de ce niveau.
Cliquez sur le niveau de la hiérarchie des clés de ligne 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 de ligne pour augmenter le facteur de zoom, ou appuyez sur la touche Backspace ou Delete pour revenir à la zone précédente.

Épingler des informations 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.

Basculer entre les métriques

Par défaut, lorsque vous ouvrez une analyse Key Visualizer, celle-ci affiche la métrique Ops (Opérations) qui vous donne un aperçu de votre modèle d'utilisation de la table. Vous pouvez basculer à tout moment vers une autre métrique en cliquant sur la liste déroulante Métrique située au-dessus de la carte de densité, puis en cliquant sur la métrique à afficher. Si un élément de la liste est désactivé, cela signifie que la valeur de cette métrique était toujours égale à zéro.

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

Basculer entre les formats de clé

Par défaut, les clés sont affichées sous la forme d'octets sérialisés. Cela signifie que les caractères imprimables s'affichent sous forme de caractères ASCII, c'est-à-dire de texte. Les caractères non imprimables s'affichent sous la forme d'une série de barres obliques inverses, chacune suivie d'un nombre à trois chiffres. Chaque nombre constitue la représentation octale d'un octet.

Par exemple, une clé contenant à la fois des octets imprimables et des octets non imprimables peut se présenter ainsi :

\360q\364\031\253\735\223xdf\272\022\362\251bn\101

Vous pouvez choisir d'afficher les clés au format hexadécimal au lieu du format texte :

Cliquez sur le bouton Paramètres.
Sous Préférences, choisissez l'option Hexadécimal.
Cliquez sur OK.

Rechercher des connexions entre différentes métriques

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é Opérations coïncident avec des hotspots de la carte Latence, ce qui pourrait indiquer que le nombre d'opérations dans un bucket de clés a provoqué une latence accrue.

Pour afficher plusieurs métriques et leurs valeurs en même temps, cliquez sur Multimetric en haut à droite de l'écran. Une liste de métriques s'affiche alors dans un volet à droite de l'analyse.

Exemple illustrant le volet "Multimetric" (Multimétrique) 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 courants dans les cartes de densité.
Informez-vous sur les métriques que vous pouvez afficher dans une carte de densité.
Identifiez les messages de diagnostic affichés par Key Visualizer.
Découvrez les clés de ligne qui contiennent plusieurs valeurs.