Esplorazione delle mappe termiche

Questa pagina descrive come analizzare la mappa termica in una scansione di Key Visualizer per identificare l'origine di un problema di prestazioni di Firestore.

Prima di leggere questa pagina, dovresti acquisire familiarità con la panoramica di Key Visualizer. È possibile anche:

Scopri come aprire una scansione di Key Visualizer.
Consulta esempi di pattern chiave di documento o pattern chiave di indice comuni.

Regolazione della luminosità

Le mappe termiche di Key Visualizer utilizzano colori scuri per indicare valori normali o bassi e colori brillanti per indicare valori elevati. Puoi regolare la scala dei colori per vedere i pattern nella mappa termica.

Tieni presente che, per la maggior parte delle metriche, Key Visualizer identifica i valori "alti" e "bassi" in base interamente all'utilizzo del database. Ad esempio, se esegui 20 letture al secondo in un intervallo di chiavi specifico e 1 lettura al secondo in altri intervalli di chiavi, Key Visualizer utilizza un colore brillante per quell'intervallo di chiavi specifico. Tieni presente che i colori brillanti non indicano necessariamente un problema.

Per regolare i colori utilizzati per valori diversi, utilizza i pulsanti + / - ai lati dell'icona Regola luminosità . Quando aumenti la luminosità, diminuisci l'intervallo di valori rappresentato da ogni colore; quando diminuisci la luminosità, aumenti l'intervallo di valori.

Per ripristinare l'impostazione predefinita della luminosità, fai clic sull'icona Regola luminosità .

Aumento dello zoom su periodi di tempo e intervalli chiave

Quando apri una mappa termica, vengono visualizzati i valori per il periodo di tempo incluso nell'analisi e l'intervallo di chiavi attive nel database. Se noti un problema durante un determinato periodo di tempo o in un intervallo specifico di tasti, puoi aumentare lo zoom per esaminare il problema in modo più approfondito.

Esistono diversi modi per aumentare o diminuire lo zoom:

Scorri verso l'alto o verso il basso all'interno della mappa termica.
Fai clic sul pulsante Zoom rettangolare , quindi fai clic e trascina per selezionare un'area da ingrandire.
Tieni premuto il tasto Shift, poi fai clic e trascina per selezionare un'area da ingrandire.
Torna all'area precedente della mappa termica premendo il tasto Backspace o Delete.
Diminuisci lo zoom per visualizzare l'intera tabella facendo clic sul pulsante Reimposta zoom o premendo il tasto R.

Visualizzazione in dettaglio per prefisso chiave

La seguente sezione descrive come visualizzare in dettaglio utilizzando come esempio la scansione delle chiavi di un documento. Nel caso di chiavi di indice, il prefisso cambia nel gruppo di chiavi di indice.

Sul lato sinistro di una mappa termica, Key Visualizer organizza le chiavi in base alla gerarchia del tuo database. Puoi utilizzarla per visualizzare in dettaglio i dati relativi a intervalli specifici di chiavi.

Per visualizzare in dettaglio i dati della mappa termica per un gruppo di chiavi che condividono un prefisso comune:

Sposta il cursore su uno dei livelli della gerarchia dei tasti visualizzati a sinistra della mappa termica.

Key Visualizer evidenzia l'area della mappa termica che mostra questo livello della gerarchia. Mostra inoltre il prefisso della chiave per tutte le chiavi a questo livello.
Fai clic sul livello della gerarchia delle chiavi che vuoi esaminare.

Key Visualizer aumenta lo zoom su questo livello della gerarchia.
Fai clic su un altro livello della gerarchia dei tasti per aumentare ulteriormente lo zoom oppure premi il tasto Backspace o Delete per tornare all'area precedente.

Fissare i dettagli di una metrica

Quando sposti il cursore su una mappa termica, Key Visualizer mostra una descrizione comando contenente i dettagli della metrica che si trova sotto il cursore. Puoi bloccare la descrizione comando facendo clic sulla mappa termica. Le descrizioni comando bloccate mostrano ulteriori dettagli sulla metrica. Il blocco di una descrizione comando semplifica inoltre l'acquisizione di uno screenshot della descrizione comando o la copia delle informazioni da quest'ultima.

Cambio delle metriche

Per impostazione predefinita, quando apri una scansione di Key Visualizer, viene visualizzata la metrica Ops/s per le chiavi dei documenti, che offre una panoramica del tuo pattern di utilizzo. Per passare a una metrica diversa, fai clic sull'elenco a discesa Metrica sopra la mappa termica, poi fai clic sulla metrica da visualizzare.

Nel caso delle chiavi di indice, viene visualizzata la metrica Operazioni di scrittura indice che offre una panoramica dell'utilizzo della chiave di indice.

Per una descrizione di ciascuna metrica, consulta la sezione Metriche di Key Visualizer.

Individuazione di connessioni tra metriche diverse per le chiavi dei documenti

Puoi visualizzare più metriche contemporaneamente in Key Visualizer per confrontare le metriche o trovare correlazioni tra le metriche. Ad esempio, potresti voler verificare se gli hotspot nella mappa termica Ops sono correlati all'elevata latenza nella mappa termica Latenza media di scrittura.

Per visualizzare contemporaneamente più metriche e i relativi valori, fai clic su Mostra riquadro informazioni nell'angolo in alto a destra. In un riquadro a destra dell'analisi viene visualizzato un elenco di metriche.

Esempio di riquadro multimetrico per_a_scan

Per esaminare più metriche contemporaneamente, utilizza i seguenti strumenti nel riquadro multimetrico:

Per mostrare o nascondere le mappe termiche in miniatura per tutte le metriche, fai clic su Expand All o Collapse All in alto a destra.
Per visualizzare la mappa termica di una singola metrica, fai clic sul nome della metrica.
Per nascondere la mappa termica di una singola metrica, fai di nuovo clic sul nome della metrica.
Per visualizzare la mappa termica di una metrica nella finestra principale, fai clic sulla freccia continua sul bordo sinistro della barra del titolo della metrica.
Passa il mouse sopra una mappa termica in miniatura per vedere l'attività corrispondente nella visualizzazione principale.

Per confrontare diverse metriche per un bucket di chiavi nello stesso momento, puoi bloccare un valore in un'analisi e passare a una metrica diversa nello stesso momento:

Posiziona il cursore del mouse su una posizione di interesse sulla mappa termica grande nella finestra principale.
Fai clic per bloccare la descrizione comando. I valori nel riquadro laterale rimangono fissi nel bucket di chiavi e nel momento in cui hai bloccato.
Per visualizzare una metrica nella mappa termica grande, fai clic sulla freccia continua a sinistra relativa a quella metrica. La descrizione comando nella finestra principale mostra i dettagli completi della metrica.

Passaggi successivi

Impara a riconoscere i pattern delle chiavi dei documenti o i pattern delle chiavi di indicizzazione.
Scopri di più sulle metriche che puoi visualizzare in una mappa termica.