Esplorazione delle mappe termiche

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.

Prima di leggere questa pagina, è necessario acquisire familiarità con la panoramica di Key Visualizer. Ti consigliamo inoltre di:

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à . 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à .

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 , 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 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 sezione seguente descrive come eseguire un'analisi dettagliata utilizzando come esempio una scansione delle chiavi dei documenti. 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:

  1. 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.

    Esempio di un'area evidenziata in una mappa termica per un gruppo di chiavi

  2. Fai clic sul livello della gerarchia delle chiavi che vuoi esaminare.

    Key Visualizer aumenta lo zoom su questo livello della gerarchia.

    Esempio di aumento dello zoom di un livello della gerarchia delle chiavi

  3. Fai clic su un altro livello della gerarchia delle chiavi per aumentare ulteriormente lo zoom o premi il tasto Backspace o Delete 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 Op/s per le chiavi dei documenti, che fornisce una panoramica del tuo 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 dei documenti

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.

Esempio che mostra il riquadro multimetrica for_a_scan

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 o Collapse 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.

    La Freccia sinistra mostra una metrica nella finestra principale

  • 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:

  1. Posiziona il cursore del mouse su una posizione di interesse nella mappa termica grande nella finestra principale.
  2. 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.
  3. 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