Cette page présente l'outil de diagnostic Key Visualizer pour Firestore en mode Datastore.
Qu'est-ce que Key Visualizer ?
Key Visualizer est un outil qui vous permet d'analyser vos habitudes d'utilisation du mode Datastore. Il génère des rapports visuels qui détaillent votre utilisation en fonction des entités auxquelles vous accédez, ou des entrées d'index qui sont écrites ou supprimées à mesure que les 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 permet d'identifier les problèmes de performances dans votre base de données causés par les hotspots dus à des clés d'entité ou d'index séquentielles, ou par des 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 inclut une carte de densité qui présente les modèles d'accès ou les métriques de performances pour 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.
Dans le cas d'une carte de densité des clés d'entité, l'axe des abscisses représente le temps et l'axe des ordonnées représente les clés d'entité. Pour une carte de densité des clés d'index, l'axe des abscisses représente le temps, tandis que l'axe des y représente 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. Consultez les sections Modèles de carte de densité pour les clés d'entité ou Modèles de carte de densité pour les clés d'index pour obtenir 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 clés
Key Visualizer divise toutes les clés de votre base de données en jusqu'à 1000 plages contiguës, avec à peu près le même nombre de clés dans chaque plage. Ces plages sont appelées des buckets 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 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é 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.
Étapes suivantes
- Lisez la présentation Premiers pas avec Key Visualizer.
- Comprenez les modèles de clés d'entité ou les modèles de clés d'index que vous pouvez voir dans les cartes de densité Key Visualizer.
- Découvrez comment explorer les cartes de densité en profondeur.