Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página mostra exemplos de padrões que pode ver num mapa de calor do Key Visualizer. Estes padrões podem ajudar a resolver problemas de desempenho específicos.
Utilização distribuída uniformemente
Se um mapa de calor mostrar uma mistura detalhada de cores escuras e claras, as leituras e as escritas estão distribuídas uniformemente por toda a base de dados. Este mapa de calor representa provavelmente um padrão de utilização eficaz para o modo Datastore.
Teclas sequenciais
Um mapa de calor com uma única linha diagonal brilhante pode indicar uma base de dados que usa chaves estritamente crescentes ou decrescentes. As chaves sequenciais
são um antipadrão que pode criar pontos críticos.
Para saber mais acerca dos pontos ativos, consulte a
página de práticas recomendadas.
Quando identifica pontos críticos, pode observar latências elevadas correspondentes quando compara uma métrica Ops/s com uma métrica de latência.
Aumento súbito do tráfego
Um mapa de calor com um intervalo de chaves que muda subitamente de escuro para claro indica
um pico súbito na carga. Se o tráfego Ops aumentar mais rapidamente do que o modo Datastore consegue dimensionar automaticamente os recursos, pode ver métricas latency elevadas correspondentes.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-20 UTC."],[[["\u003cp\u003eKey Visualizer heatmaps display patterns that can help identify performance issues in your database.\u003c/p\u003e\n"],["\u003cp\u003eEvenly distributed usage, shown by a mix of dark and bright colors, indicates effective Datastore mode usage.\u003c/p\u003e\n"],["\u003cp\u003eSequential keys, shown as a bright diagonal line, are an anti-pattern that can cause hotspots and increased latencies.\u003c/p\u003e\n"],["\u003cp\u003eA sudden shift from dark to bright on a heatmap shows a spike in load, which may cause increased latency if it outpaces Datastore's auto-scaling.\u003c/p\u003e\n"]]],[],null,["# Heatmap patterns for entity keys\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 Datastore mode. \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](/datastore/docs/best-practices#high_readwrite_rates_to_a_narrow_key_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\nDatastore mode 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)"]]
