Questa pagina descrive come analizzare la mappa termica in una scansione di Key Visualizer per identificare la fonte di un problema di prestazioni di Firestore in modalità Datastore.
Prima di leggere questa pagina, è necessario acquisire familiarità con la panoramica di Key Visualizer. Ti consigliamo inoltre di:
- Scopri come aprire una scansione di Key Visualizer.
- Consulta esempi di pattern di chiavi di entità o pattern di chiavi 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 di colori per aiutarti a vedere gli schemi nella mappa di calore.
Tieni presente che, per la maggior parte delle metriche, Key Visualizer identifica i valori "alti" e "bassi" in base esclusivamente all'utilizzo del database. Ad esempio, se effettui 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 vivaci non indicano necessariamente un problema.
Per regolare i colori utilizzati per valori diversi, utilizza i pulsanti + / - ai lati dell'icona Regola luminosità brightness_6. Quando aumenti la luminosità, riduci l'intervallo di valori rappresentati da ciascun colore; quando la diminuisci, aumenti l'intervallo di valori.
Per reimpostare la luminosità sull'impostazione predefinita, fai clic sull'icona Regola luminositàbrightness_6 .
Aumentare lo zoom su periodi di tempo e intervalli chiave
Quando apri una mappa di calore, vengono visualizzati i valori relativi al periodo di tempo incluso nella scansione e all'intervallo di chiavi attive nel database. Se noti un problema durante un periodo di tempo specifico o in un intervallo specifico di chiavi, puoi aumentare lo zoom per esaminarlo più da vicino.
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 crop, 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 di calore premendo il tasto
Backspace
oDelete
. - Diminuisci lo zoom per visualizzare l'intera tabella facendo clic sul pulsante Reimposta zoom
zoom_out_map o premendo il tasto
R
.
Visualizzazione in dettaglio per prefisso chiave
La sezione seguente descrive come eseguire un'analisi dettagliata utilizzando come esempio una ricerca delle chiavi delle entità. In caso di chiavi di indice, il prefisso diventa gruppo di chiavi di indice.
Sul lato sinistro di una mappa termica, Key Visualizer organizza le chiavi in base alla gerarchia del database. Puoi utilizzarlo per visualizzare in dettaglio i dati relativi a intervalli specifici di chiavi.
Per visualizzare in dettaglio i dati della mappa di calore per un gruppo di chiavi che condividono un prefisso comune:
Passa il cursore sopra uno dei livelli nella gerarchia delle chiavi visualizzata a sinistra della mappa di calore.
Key Visualizer evidenzia l'area della mappa termica che mostra questo livello della gerarchia. Mostra anche 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 delle chiavi per aumentare ulteriormente lo zoom o premi il tasto
Backspace
oDelete
per tornare all'area precedente.
Fissare i dettagli di una metrica
Quando passi il cursore sopra una mappa termica, Key Visualizer mostra una descrizione comando che contiene dettagli sulla metrica sotto il cursore. Puoi bloccare questa suggerimento facendo clic sulla mappa termica. Le descrizioni comando bloccate mostrano più dettagli sulla metrica. Se blocchi una descrizione comando, puoi anche acquisire più facilmente uno screenshot della descrizione comando o copiare le informazioni al suo interno.
Metriche di passaggio
Per impostazione predefinita, quando apri una scansione di Key Visualizer viene visualizzata la metrica Ops/s per le chiavi delle entità, che fornisce una panoramica del pattern di utilizzo. Per passare a un'altra metrica, fai clic sull'elenco a discesa Metrica sopra la mappa termica e poi sulla metrica che vuoi visualizzare.
Nel caso delle chiavi di indice, viene visualizzata la metrica Oper. di scrittura dell'indice/s che fornisce una panoramica dell'utilizzo delle chiavi di indice.
Per le descrizioni di ogni metrica, consulta Metriche principali del Visualizzatore.
Trovare connessioni tra metriche diverse per le chiavi delle entità
Puoi visualizzare più metriche contemporaneamente in Visualizzatore di indicatori principali quando vuoi confrontarle o trovare correlazioni tra loro. Ad esempio, potresti voler verificare se gli hotspot nella mappa termica Ops/s sono correlati a una latenza elevata nella mappa termica Latenza media scrittura.
Per visualizzare contemporaneamente più metriche e i relativi valori, fai clic su Mostra riquadro informazioni nell'angolo in alto a destra. Viene visualizzato un elenco di metriche in un riquadro a destra della scansione.
Per esaminare più metriche contemporaneamente, utilizza i seguenti strumenti nel riquadro delle metriche multiple:
Per mostrare o nascondere le mappe di calore in miniatura per tutte le metriche, fai clic su
Expand All
oCollapse All
in alto a destra.Per visualizzare la mappa di calore di una singola metrica, fai clic sul nome della metrica.
Per nascondere la mappa di calore di una singola metrica, fai di nuovo clic sul nome della metrica.
Per visualizzare la mappa di calore di una metrica nella finestra principale, fai clic sulla freccia solida all'estremità sinistra della barra del titolo della metrica.
Passa il mouse sopra una miniatura della mappa termica per visualizzare l'attività corrispondente nella visualizzazione principale.
Per confrontare metriche diverse per un bucket di chiavi nello stesso istante, puoi bloccare un valore in una scansione e passare a una metrica diversa nello stesso istante:
- Posiziona il cursore del mouse su una posizione di interesse nella mappa termica grande nella finestra principale.
- Fai clic per bloccare la descrizione comando. I valori nel riquadro laterale rimangono fissi al bucket della chiave e al punto in tempo che hai fissato.
- Per visualizzare una metrica nella mappa di calore grande, fai clic sulla freccia solida a sinistra corrispondente alla metrica. La descrizione comando nella finestra principale mostra i dettagli completi della metrica.
Passaggi successivi
- Scopri come riconoscere i pattern di chiavi delle entità o i pattern di chiavi degli indici.
- Scopri le metriche che puoi visualizzare in una mappa termica.