Pattern di mappa termica per le chiavi delle entità
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina mostra esempi di pattern che potresti vedere in una mappa termica di Key Visualizer. Questi pattern possono aiutarti a risolvere problemi specifici di rendimento.
Utilizzo distribuito in modo uniforme
Se una mappa termica mostra un mix granulare di colori scuri e chiari, le letture e le scritture sono distribuite in modo uniforme in tutto il database. Questa mappa termica
probabilmente rappresenta un pattern di utilizzo efficace per la modalità Datastore.
Chiavi sequenziali
Una mappa termica con una sola linea diagonale luminosa può indicare un database che utilizza
chiavi strettamente crescenti o decrescenti. Le chiavi sequenziali
sono un anti-pattern che può creare hotspot.
Per saperne di più sugli hotspot, consulta la
pagina delle best practice.
Quando si verifica un hotspot, potresti osservare latenze elevate corrispondenti
quando confronti una metrica Ops/s con una metrica di latenza.
Aumento improvviso del traffico
Una mappa termica con un intervallo di chiavi che cambia improvvisamente da scuro a chiaro indica
un picco improvviso di carico. Se il traffico Ops aumenta più rapidamente di quanto la modalità Datastore possa scalare automaticamente le risorse, potresti notare un aumento corrispondente delle metriche latency.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-05 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)"]]