Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Patrones de mapa de calor para las claves de documentos
En esta página, se muestran ejemplos de los patrones que podrías ver en un mapa de calor de Key Visualizer. Estos patrones pueden ayudarte a solucionar problemas de rendimiento específicos.
Uso distribuido de manera uniforme
Si en un mapa de calor se muestra una mezcla detallada de colores oscuros y brillantes, significa que las lecturas y escrituras están distribuidas de manera uniforme en la base de datos. Es probable que este mapa de calor represente un patrón de uso efectivo de Firestore.
Claves secuenciales
Un mapa de calor con una sola línea diagonal brillante puede indicar una base de datos que usa claves estrictamente crecientes o decrecientes. Las claves secuenciales son un antipatrón que puede crear hotspots.
Para obtener más información sobre los hotspots, consulta la página de prácticas recomendadas.
Cuando identifiques los puntos críticos, es posible que observes latencias elevadas correspondientes cuando compares una métrica de Ops/s con una métrica de latencia.
Aumento repentino del tráfico
Un mapa de calor con un rango de claves que cambia de forma repentina de un color oscuro a uno brillante indica un aumento repentino en la carga. Si el tráfico de Ops aumenta más rápido de lo que Firestore puede ajustar la escala de los recursos automáticamente, es posible que veas métricas de latency elevadas correspondientes.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (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)"]]
