Présentation de Key Visualizer

Cette page présente l'outil de diagnostic Key Visualizer pour Firestore.

Qu'est-ce que Key Visualizer ?

Key Visualizer est un outil qui vous aide à analyser vos modèles d'utilisation de Firestore. Il génère des rapports visuels qui ventilent votre utilisation en fonction des documents auxquels vous accédez.

Key Visualizer fournit des insights sur les modèles d'utilisation à grande échelle. Voici quelques cas d'utilisation de Key Visualizer:

  • Résolution des problèmes de performances Key Visualizer aide à identifier les problèmes de performances de votre base de données causés par les hotspots associés aux clés de document séquentielles ou par des augmentations soudaines du trafic.
  • mieux comprendre comment accéder aux données stockées dans Firestore ;
  • Conception itérative d'un modèle de données ou amélioration de la conception d'un modèle de données existant À chaque itération, vous pouvez vérifier Key Visualizer pour détecter les problèmes que votre modèle de données entraîne.

Pour atteindre ces objectifs, Key Visualizer peut vous aider à effectuer les tâches suivantes:

  • Vérifiez si vos lectures ou écritures créent des zones cliquables sur des plages de documents spécifiques.
  • Observez l'impact d'une augmentation soudaine du trafic sur la latence.
  • Vérifiez si vos modèles d'accès sont équilibrés dans votre base de données.

Éligibilité à la recherche

Chaque analyse Key Visualizer couvre une période de deux heures. Une analyse est disponible pour une période donnée pour les bases de données dont le trafic dépasse 3 000 opérations de document au cours d'une période donnée.

L'éligibilité des analyses dépend entièrement de l'activité de la base de données. Cela ne dépend pas de la quantité de données, ni du type de données dans votre base de données.

Analyses de Key Visualizer

L'image suivante montre une analyse Key Visualizer. Chaque analyse inclut une carte de densité qui montre les modèles d'accès ou les métriques de performances d'un groupe de clés de documents au fil du temps.

Exemple d'analyse Key Visualizer

Partager des URL d'analyse

Vous pouvez partager l'URL d'une analyse Key Visualizer ou l'ajouter à vos favoris. L'URL ouvre la même analyse Key Visualizer et sélectionne la même métrique. Cette URL est valide jusqu'à ce que la durée des données d'analyse expire.

Cartes de densité

La carte de densité est le cœur d'une analyse Key Visualizer. Elle montre la valeur d'une métrique au fil du temps, divisée par tranche de 1 000 buckets de clés contigus. L'axe x de la carte de densité représente le temps, tandis que l'axe y représente les clés du document. Chaque analyse de Key Visualizer pour Firestore couvre deux heures d'activité divisées en segments de 10 secondes.

Une valeur basse pour une métrique est considérée comme une couleur sombre. Une valeur élevée est "chaude" et apparaît comme une couleur vive. Les valeurs les plus élevées apparaissent en blanc.

Les différents types d'utilisation génèrent différents modèles visuels sur la carte de densité, ce qui permet de diagnostiquer les problèmes en un coup d'œil. Consultez la section Modèles de carte de densité pour des exemples courants.

Key Visualizer fournit des outils pour vous aider à comprendre les données de chaque analyse. Consultez les pages Premiers pas avec Key Visualizer et Explorer les cartes de densité.

Buckets de clés

Key Visualizer divise toutes les clés de votre base de données en 1 000 plages contigus, avec à peu près le même nombre de clés dans chaque plage. Ces plages sont appelées des buckets de clés.

Key Visualizer enregistre la plupart des métriques sous forme de moyennes sur chaque bucket de clés ou de valeurs maximales dans chaque bucket de clés.

Statistiques

Les métriques suivantes sont disponibles dans les analyses Key Visualizer pour Firestore:

Statistiques Description
Statistiques d'activité
Opérations/s Nombre moyen d'opérations sur un document par seconde. Correspond à la somme des écritures, des recherches et des requêtes par seconde. Cette métrique peut indiquer les clés qui sont populaires.
Opérations d'écriture/s Nombre moyen d'opérations sur les documents par seconde pour les écritures et les suppressions.
Opérations de recherche/s Nombre moyen d'opérations de document par seconde pour les recherches.
Opérations de requête/s Nombre moyen d'opérations documentées par seconde pour les requêtes.
Statistiques de performances
Latence moyenne en écriture Latence moyenne des opérations d'écriture et de suppression dans les données traitées du bucket
Latence de recherche moyenne Latence moyenne des recherches effectuées au sein des données traitées dans le bucket
Latence moyenne des requêtes Latence moyenne des requêtes dans les données traitées du bucket
Latence de queue en écriture Latence maximale d'écriture ou de suppression observée dans les données traitées du bucket.
Latence de la recherche de queue Latence de recherche maximale observée dans les données traitées du bucket.
Latence de la queue de requête Latence maximale des requêtes observées dans les données traitées du bucket.

Moyennes des performances

Les métriques de latence moyenne utilisent une moyenne sur les clés du bucket de clés. Étant donné que cette mesure est effectuée au niveau de la couche de stockage, la latence signalée ici peut être inférieure à la latence totale subie par un appel d'API.

Limites

Bien que Key Visualizer affiche diverses métriques, il n'affiche pas chaque métrique pouvant affecter les performances de Firestore. Exemple:

  • Les problèmes de réseau entre votre application et Google Cloud peuvent ne pas être visibles. Elles peuvent s'afficher sous forme de bandes verticales sur toutes les clés dans Key Visualizer, ce qui vous donne uniquement des indications sur le moment où les problèmes se sont produits.

  • Les problèmes de performances causés par les index peuvent ne pas être visibles. Aucune métrique ne permet de mesurer directement les performances d'écriture d'un index. Les index affectent toutefois les statistiques de latence.

Durée de vie des données

Les données collectées par Key Visualizer pour Firestore sont supprimées au bout de 14 jours.

Les données Key Visualizer sont disponibles pour les 14 derniers jours. Par exemple, si vous lancez Key Visualizer le 19 décembre à 12h45, l'heure de début la plus proche que vous pouvez définir pour une période de deux heures est le 5 décembre à 13h.

Cette limite signifie également que si vous ajoutez ou ajoutez à vos favoris l'URL d'une analyse Key Visualizer, sa durée de vie maximale est de 14 jours.

Étape suivante