Panoramica di Key Visualizer

Questa pagina fornisce una panoramica dello strumento di diagnostica Key Visualizer per Firestore in modalità Datastore.

Che cos'è Key Visualizer?

Key Visualizer è uno strumento che consente di analizzare i pattern di utilizzo della modalità Datastore. Genera report visivi che analizzano l'utilizzo in base a Le entità a cui accedi o le voci di indicizzazione scritte o eliminate come vengono modificate.

Key Visualizer può fornire insight sui pattern di utilizzo su larga scala. Gli utilizzi di Key Visualizer includono:

  • Risoluzione dei problemi di prestazioni. Il visualizzatore delle chiavi ti aiuta a identificare i problemi di prestazioni nel database causati da hotspot di chiavi di indice o entità sequenziali o da aumenti improvvisi del traffico.
  • Comprendere meglio come accedi ai dati archiviati in Modalità Datastore.
  • Progettazione iterativa di un modello dei dati o miglioramento della progettazione di un modello di dati esistente modello dei dati. In ogni iterazione, puoi controllare Key Visualizer per individuare i problemi causate dal modello dei dati.

Per raggiungere questi obiettivi, Key Visualizer può aiutarti a completare le seguenti attività:

  • Controlla se le letture o le scritture creano hotspot in intervalli di entità specifici.
  • Scopri come un improvviso aumento del traffico influisce sulla latenza.
  • Controlla se i tuoi pattern di accesso sono bilanciati nel database.
  • Controlla la struttura delle chiavi dell'indice per identificare le definizioni degli indici che causano problemi di caricamento.
  • Utilizza la visualizzazione delle chiavi indice per previsioni migliori dei pattern dei carichi di lavoro.

Idoneità alla scansione

Ogni scansione di Key Visualizer copre un periodo di due ore. Una scansione per un determinato ciclo è disponibile per i database con traffico superiore a 3000 operazioni sui documenti in un determinato minuto di quel periodo.

L'idoneità della scansione dipende completamente dall'attività del database. Non dipende sulla quantità o sul tipo di dati nel database.

Scansioni di Key Visualizer

L'immagine seguente mostra una scansione di Key Visualizer. Ogni scansione include mappa termica che mostra pattern di accesso o metriche delle prestazioni per un gruppo di chiavi di entità o di indice nel tempo.

Esempio di scansione di Key Visualizer

Condivisione degli URL di scansione

Puoi condividere o aggiungere ai preferiti l'URL di una scansione di Key Visualizer. L'URL si aprirà eseguire la stessa scansione di Key Visualizer e selezionare la stessa metrica. Questo URL è valido fino alla scadenza della durata della scansione dei dati.

Heatmaps

L'aspetto fondamentale di una scansione di Key Visualizer è la mappa termica, che mostra il valore di una metrica nel corso del tempo, suddiviso in fino a 1000 bucket di chiavi contigui.

Per una mappa termica delle chiavi di entità, l'asse x della mappa termica rappresenta il tempo, mentre l'asse y rappresenta le chiavi di entità. Per una mappa termica delle chiavi di indice, l'asse x della mappa termica rappresenta il tempo, mentre l'asse y rappresenta le chiavi di indice.

Ogni scansione di Key Visualizer per Firestore in modalità Datastore copre due ore di attività suddivise in segmenti di 10 secondi.

Un valore basso per una metrica è considerato "freddo" e viene visualizzato con un colore scuro. Un valore alto è "hot", ed è appare con un colore brillante. I valori più alti sono mostrati in bianco.

Tipi di utilizzo diversi generano pattern visivi diversi all'interno della mappa di calore, il che può consentire di diagnosticare i problemi a colpo d'occhio. Per esempi di alcuni pattern comuni, consulta Pattern di mappa termica per le chiavi delle entità o Pattern di mappa termica per le chiavi di indice.

Key Visualizer fornisce strumenti per aiutarti a comprendere i dati di ogni scansione. Consulta la guida introduttiva a Key Visualizer e Esplorazione delle mappe termiche.

Bucket di chiavi

Key Visualizer divide tutte le chiavi del tuo database in a 1000 intervalli contigui, con all'incirca lo stesso numero di chiavi e operazioni in ogni intervallo. Questi intervalli sono noti come bucket di chiavi.

Key Visualizer usa le operazioni totali di un database per dividere i bucket di chiavi in modo che ogni bucket acquisisca all'incirca lo stesso numero di operazioni con un di 50 operazioni/s per bucket di chiavi. Per i database con un numero di operazioni/s totale più elevato, i bucket di chiavi possono acquisire più di 50 operazioni/s ciascuno. I database con meno di 50 op/s generano scansioni con un singolo bucket di chiavi.

Key Visualizer genera report sulla maggior parte delle metriche come medie per ciascun bucket chiave valori massimi all'interno di ciascun bucket di chiavi.

Metriche

Per le chiavi delle entità nelle scansioni di Key Visualizer sono disponibili le seguenti metriche:

Metriche Descrizione
Metriche delle attività
Operazioni/s Numero medio di operazioni sulle entità al secondo. Equivale approssimativamente alla somma di scritture, ricerche e query al secondo. Questa metrica può indicare le chiavi attive.
Operazioni di scrittura/s Numero medio di operazioni sulle entità al secondo per scritture ed eliminazioni.
Operazioni di ricerca/s Numero medio di operazioni di entità al secondo per le ricerche.
Query al secondo Numero medio di operazioni sulle entità al secondo per le query.
Metriche sul rendimento
Latenza di scrittura media Latenza media per le operazioni di scrittura ed eliminazione all'interno dei dati elaborati nel bucket.
Latenza media di ricerca Latenza media per le ricerche all'interno dei dati elaborati nel bucket.
Latenza media delle query Latenza media per le query all'interno dei dati elaborati nel bucket.
Latenza di scrittura coda Latenza massima di scrittura o eliminazione osservata all'interno dei dati elaborati nel bucket.
Latenza coda di ricerca Latenza massima di ricerca osservata all'interno dei dati elaborati nel bucket.
Latenza coda query Latenza massima della query osservata nei dati elaborati nel bucket.

Per le chiavi di indice nelle scansioni di Key Visualizer è disponibile la seguente metrica:

Metriche Descrizione
Operazioni di scrittura indice/s Numero medio di scritture sull'indice al secondo.

Medie di rendimento

Le metriche di latenza media hanno una media delle chiavi nel bucket di chiavi. Poiché questa misurazione viene eseguita a livello di livello di archiviazione, la latenza riportata qui potrebbe essere inferiore alla latenza totale riscontrata da una chiamata API.

Limiti

Sebbene Key Visualizer mostri una serie di metriche, non mostra ogni un'unica metrica che può influire sulle prestazioni della modalità Datastore. Ad esempio:

  • I problemi di rete tra la tua applicazione e Google Cloud potrebbero non essere visibile. Potrebbero essere mostrati in formato verticale bande su tutti i tasti in Key Visualizer, che fornisce solo suggerimenti quando si sono verificati i problemi.

Durata dei dati

I dati raccolti da Key Visualizer per Firestore in modalità Datastore vengono eliminati dopo 14 giorni.

I dati di Key Visualizer sono disponibili per gli ultimi 14 giorni. Ad esempio, se lo lanci il 19 dicembre alle 12:45, la prima ora di inizio che puoi scegliere per un intervallo di tempo di 2 ore è il 5 dicembre alle 13:00.

Questo limite significa anche che se aggiungi ai preferiti o condividi l'URL di una chiave Scansione del visualizzatore. L'URL dura al massimo 14 giorni.

Passaggi successivi