Cette page présente l'outil de diagnostic de Key Visualizer pour Firestore en mode Datastore.
Qu'est-ce que Key Visualizer ?
Key Visualizer est un outil qui vous aide à analyser votre mode Datastore les schémas d'utilisation. Il génère des rapports visuels qui détaillent votre utilisation en fonction les entités auxquelles vous accédez ou indexent les entrées écrites ou supprimées en tant que entités sont modifiées.
Key Visualizer fournit des informations sur les modes d'utilisation à grande échelle. Les utilisations de Key Visualizer incluent :
- La résolution des problèmes liés aux performances Key Visualizer vous aide à identifier des problèmes de performances dans votre base de données par des hotspots à partir de clés d'index ou d'entités séquentielles, ou d'augmentations soudaines du trafic.
- Une meilleure compréhension des moyens d'accéder aux données stockées en mode Datastore.
- La conception itérative d'un modèle de données ou l'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 liés à votre modèle de données.
Pour atteindre ces objectifs, Key Visualizer peut vous aider à effectuer les tâches suivantes :
- Vérifiez si vos lectures ou écritures créent des hotspots sur des plages d'entités spécifiques.
- Découvrez comment une augmentation soudaine du trafic affecte la latence.
- Vérifiez si vos modèles d'accès sont équilibrés au sein de votre base de données.
- Vérifiez la structure des clés d'index pour identifier les définitions d'index qui provoquent des problèmes de chargement d'index.
- Utilisez la visualisation des clés d'index pour améliorer les prédictions de modèles de charge de travail.
Critères d'éligibilité pour l'analyse
Chaque analyse Key Visualizer porte sur une période de deux heures. Une analyse pour une période donnée est disponible pour les bases de données dont le trafic dépasse 3000 opérations de document par minute dans cette période.
Les critères d'éligibilité pour l'analyse dépendent entièrement de l'activité de la base de données. Elle ne dépend pas de la quantité de données ni du type de données figurant dans votre base de données.
Analyses de Key Visualizer
L'image suivante montre une analyse de Key Visualizer. Chaque analyse comprend une carte de densité qui montre les modèles d'accès ou les métriques de performances d'un groupe de clés d'entité ou de clés d'index au fil du temps.
Partager les URL d'analyse
Vous pouvez partager ou ajouter aux favoris l'URL d'une analyse Key Visualizer. L'URL ouvre la même analyse Key Visualizer et sélectionne la même métrique. Cette URL est valide jusqu'à l'expiration de la durée d'analyse.
Cartes de densité
La carte de densité constitue le cœur d'une analyse Key Visualizer. Elle représente la valeur d’une métrique dans le temps, ventilée jusqu'à 1000 buckets de clés contigus.
Pour une carte de densité des clés d'entité, l'axe des abscisses représente le temps et l'axe des ordonnées les clés d'entité. Pour une carte de densité des clés d'index, l'axe des abscisses représente le temps et l'axe des ordonnées les clés d'index.
Chaque analyse Key Visualizer pour Firestore en mode Datastore couvre deux heures d'activité divisées en segments de 10 secondes.
Une valeur faible d'une métrique est considérée comme "froide" et apparaît en couleur sombre. Une valeur élevée est considérée comme "chaude" et apparaît sous la forme d'une couleur vive. Les valeurs les plus élevées apparaissent en blanc.
Sur la carte de densité, différents types d'utilisation génèrent des modèles visuels différents, ce qui permet de diagnostiquer les problèmes en un coup d'œil. Voir Modèles de carte de densité pour les clés d'entité ou les motifs de carte de densité pour l'index clés pour obtenir des exemples de modèles 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 clés
Key Visualizer divise toutes les clés de votre base de données en à 1 000 plages contiguës, avec à peu près le même nombre de clés opérations/opérations dans chaque plage. Ces plages sont appelées des buckets de clés.
Key Visualizer utilise le nombre total d'opérations/s d'une base de données pour diviser les buckets de clés. de sorte que chaque bucket capture à peu près le même nombre d'opérations/s avec un minimum de 50 Ops/s par bucket de clés. Bases de données avec un total d'opérations/s plus élevé, les buckets clés peuvent capturer chacun plus de 50 opérations/s. Les bases de données avec moins de 50 opérations/s entraînent des analyses avec un seul bucket de clés.
Dans chaque bucket de clés, Key Visualizer enregistre la plupart des métriques en tant que moyennes ou en tant que valeurs maximales.
Métriques
Les métriques suivantes sont disponibles pour les clés d'entité dans les analyses Key Visualizer:
| Métriques | Description |
|---|---|
| Données d'activités | |
| Ops/s (Opérations/s) | Nombre moyen d'opérations d'entité par seconde. Environ égal à la somme des écritures, des recherches et des requêtes par seconde. Cette métrique peut indiquer quelles clés sont actives. |
| Write ops/s (Opérations d'écriture/s) | Nombre moyen d'opérations d'entité par seconde pour les écritures et les suppressions. |
| Lookup ops/s (Opérations de recherche/s) | Nombre moyen d'opérations d'entité par seconde pour les recherches. |
| Query ops/s (Opérations de requête/s) | Nombre moyen d'opérations d'entités par seconde pour les requêtes. |
| Statistiques relatives aux performances | |
| Latence d'écriture moyenne | Latence moyenne d'écriture et de suppression pour les données traitées dans le bucket. |
| Latence de recherche moyenne | Latence moyenne des recherches effectuées pour les données traitées dans le bucket. |
| Latence moyenne des requêtes | Latence moyenne des requêtes effectuées pour les données traitées dans le bucket. |
| Latence de queue d'écriture | Latence d'écriture ou de suppression maximale observée pour les données traitées dans le bucket. |
| Latence de queue de recherche | Latence de recherche maximale constatée pour les données traitées dans le bucket. |
| Latence de queue de requête | Latence observée maximale des requêtes pour les données traitées dans le bucket. |
La métrique suivante est disponible pour les clés d'index dans les analyses Key Visualizer:
| Métriques | Description |
|---|---|
| Opérations d'écriture d'index/s | Nombre moyen d'écritures d'index par seconde. |
Moyennes de performances
Les métriques de latence moyenne utilisent une moyenne des clés du bucket de clés. Cette mesure étant effectuée au niveau de la couche de stockage, la latence signalée ici peut être inférieure à la latence totale observée par un appel d'API.
Limites
Bien que Key Visualizer présente différentes métriques, celles susceptibles d'affecter les performances du mode Datastore ne sont pas toutes affichées. Exemple :
- Les problèmes réseau entre votre application et Google Cloud peuvent ne pas être visibles. Ils peuvent apparaître 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.
Durée de vie des données
Les données collectées par Key Visualizer pour Firestore en mode Datastore 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 ancienne que vous pouvez choisir est le 5 décembre à 13h00.
Cette limite signifie également que, si vous partagez ou ajoutez à vos favoris l'URL d'une analyse Key Visualizer, celle-ci a une durée de vie maximale de 14 jours.
Étape suivante
- Lisez la présentation Premiers pas avec Key Visualizer.
- Comprendre les modèles de clé d'entité ou la clé d'index des modèles que vous pouvez voir sur les cartes de densité Key Visualizer.
- Découvrez comment explorer les cartes de densité en profondeur.