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 Cloud Firestore.

Prima di leggere questa pagina, devi 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 vivaci per indicare valori elevati. Puoi regolare la scala di colori per visualizzare i pattern nella mappa termica.

Tieni presente che per la maggior parte delle metriche, Key Visualizer identifica i valori "alti" e "bassi" basandosi interamente sull'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 l'intervallo di chiavi specifico. Tieni presente che i colori vivaci non indicano necessariamente un problema.

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

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

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 periodo di tempo specifico o in un intervallo di chiavi specifico, puoi aumentare lo zoom per esaminare il problema 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 , poi fai clic e trascina per selezionare un'area da ingrandire.
  • Tieni premuto il tasto Shift, quindi 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 sezione seguente descrive come eseguire il drill-down utilizzando come esempio una scansione delle chiavi dei documenti. Nel caso delle chiavi di indice, il prefisso cambia in 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 per intervalli specifici di chiavi.

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

  1. Sposta il cursore su uno dei livelli della gerarchia delle chiavi visualizzata a sinistra della mappa termica.

    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 zoom su 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.

Fissaggio dei dettagli di una metrica

Quando sposti il cursore su una mappa termica, Key Visualizer mostra un tooltip che contiene i dettagli sulla metrica sotto il cursore. Puoi bloccare questo tooltip in posizione facendo clic sulla mappa termica. I tooltip bloccati mostrano maggiori dettagli sulla metrica. La fissazione di un tooltip semplifica anche l'acquisizione di uno screenshot del tooltip o la copia delle informazioni dal tooltip.

Cambio di metriche

Per impostazione predefinita, quando apri un'analisi 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, poi fai clic sulla metrica che vuoi visualizzare.

Nel caso delle chiavi di indice, viene visualizzata la metrica Operazioni di scrittura indice/s, che fornisce una panoramica dell'utilizzo delle chiavi di indice.

Per le descrizioni di ogni metrica, consulta Metriche di Key Visualizer.

Trovare connessioni tra metriche diverse per le chiavi dei documenti

Puoi visualizzare più metriche contemporaneamente in Key Visualizer 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 di scrittura media.

Per visualizzare più metriche e i relativi valori contemporaneamente, 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 multimetrico per una scansione

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 piena sul bordo sinistro della barra del titolo della metrica.

    La Freccia sinistra mostra una metrica nella finestra principale

  • Passa il mouse sopra una mappa termica in miniatura per visualizzare l'attività corrispondente nella visualizzazione principale.

Per confrontare metriche diverse per un bucket chiave nello stesso momento, puoi bloccare un valore in una scansione e poi passare a una metrica diversa nello stesso momento:

  1. Punta verso una posizione di interesse sulla mappa termica grande nella finestra principale.
  2. Fai clic per bloccare il tooltip. I valori nel riquadro laterale rimangono fissi sul bucket di chiavi e sul momento che hai bloccato.
  3. Per visualizzare una metrica nella mappa termica grande, fai clic sulla freccia piena a sinistra della metrica. Il tooltip nella finestra principale mostra i dettagli completi della metrica.

Passaggi successivi