Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Modèles de cartes de densité pour les clés de document
Cette page présente des exemples de modèles que vous pourriez voir dans une carte de densité Key Visualizer. Ces modèles peuvent vous aider à résoudre des problèmes de performances spécifiques.
Utilisation homogène
Si une carte de densité affiche un mélange finement granuleux de couleurs sombres et lumineuses, les lectures et les écritures sont réparties de manière homogène dans la base de données. Cette carte de densité représente probablement un modèle d'utilisation efficace pour Firestore.
Clés séquentielles
Une carte de densité avec une seule ligne brillante en diagonale peut indiquer une base de données qui utilise des clés strictement croissantes ou décroissantes. Les clés séquentielles sont des anti-modèles qui peuvent créer des hotspots.
Pour en savoir plus sur les hotspots, consultez la page des bonnes pratiques.
Dans le hotspotting, vous pouvez observer des latences élevées correspondantes lorsque vous comparez une métrique Ops/s à une métrique de latence.
Augmentation soudaine du trafic
Une carte de densité avec une plage de clés qui passe soudainement d'une couleur sombre à claire indique un pic soudain de charge. Si le trafic Ops augmente plus rapidement que Firestore ne peut procéder à l'autoscaling des ressources, vous pouvez voir des métriques latency élevées.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/25 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/25 (UTC)."],[],[],null,["# Heatmap patterns for document keys\n==================================\n\nThis page shows examples of patterns that you might see in a Key Visualizer\nheatmap. These patterns can help you troubleshoot specific performance\nissues.\n\nEvenly distributed usage\n------------------------\n\nIf a heatmap shows a fine-grained mix of dark and bright colors, then reads and\nwrites are evenly distributed throughout the database. This heatmap\nlikely represents an effective usage pattern for Firestore. \n\nSequential keys\n---------------\n\nA heatmap with a single bright diagonal line can indicate a database that uses\nstrictly increasing or decreasing keys. Sequential keys\nare an anti-pattern that can create hotspots.\nTo learn more about hotspots, see the\n[best practices page](/firestore/docs/best-practices#high_read_write_and_delete_rates_to_a_narrow_document_range).\n\nWhen hotspotting, you might observe corresponding elevated latencies\nwhen you compare a `Ops/s` metric with a latency metric. \n\nSudden traffic increase\n-----------------------\n\nA heatmap with a key range that suddenly changes from dark to bright indicates\na sudden spike in load. If `Ops` traffic increases faster than\nFirestore can auto-scale resources, you might see\ncorresponding elevated `latency` metrics. \n\nWhat's next\n-----------\n\n- Learn how to [get started with Key Visualizer](./keyvis-getting-started).\n- Find out how to [explore a heatmap in detail](./keyvis-exploring-heatmaps).\n- Read about the [metrics you can view in a heatmap](./key-visualizer#metrics).\n- Learn about [index key patterns](/firestore/docs/keyvis-patterns-index)"]]
