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 suddividono l'utilizzo in base alle entità a cui accedi o alle voci dell'indice che vengono scritte o eliminate man mano che le entità vengono modificate.
Key Visualizer può fornire informazioni sui pattern di utilizzo su larga scala. Gli utilizzi di Key Visualizer includono:
- Risolvere i 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 dei dati esistente. In ogni iterazione, puoi utilizzare Key Visualizer per individuare i problemi causati dal tuo 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 in che modo un aumento improvviso del traffico influisce sulla latenza.
- Controlla se i 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 di indice per fare previsioni migliori sui pattern di carico di lavoro.
Idoneità alla scansione
Ogni scansione di Key Visualizer copre un periodo di due ore. Una scansione per un determinato periodo è disponibile per i database con un traffico superiore a 3000 operazioni su documenti in un determinato minuto del periodo.
L'idoneità alla scansione dipende completamente dall'attività del database. Non dipende dalla quantità o dal tipo di dati nel database.
Scansioni di Key Visualizer
L'immagine seguente mostra una scansione di Key Visualizer. Ogni scansione include una mappa di calore che mostra i pattern di accesso o le metriche sul rendimento per un gruppo di chiavi di entità o chiavi di indice nel tempo.
Condivisione degli URL di scansione
Puoi condividere o aggiungere ai preferiti l'URL di una scansione di Key Visualizer. L'URL aprirà la stessa analisi di Key Visualizer e selezionerà la stessa metrica. Questo URL è valido fino alla scadenza della durata dei dati della scansione.
Mappe termiche
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 elevato è "caldo" e viene visualizzato 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 analisi. Consulta la Guida introduttiva all'utilizzo di Key Visualizer e la sezione Esplorazione delle mappe di calore.
Bucket di chiavi
Key Visualizer suddivide tutte le chiavi del database in un massimo di 1000 intervalli contigui, con approssimativamente lo stesso numero di chiavi e operazioni/s in ogni intervallo. Questi intervalli sono noti come bucket di chiavi.
Key Visualizer utilizza le op/s totali di un database per suddividere i bucket di chiavi in modo che ogni bucket acquisisca all'incirca lo stesso numero di op/s con una dimensione minima prevista di 50 op/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 riporta la maggior parte delle metriche come medie per ogni bucket di chiavi o come valori massimi all'interno di ogni bucket di chiavi.
Metriche
Per le chiavi delle entità nelle scansioni di Key Visualizer sono disponibili le seguenti metriche:
| Metriche | Descrizione |
|---|---|
| Metriche relative alle attività | |
| Op/s | Numero medio di operazioni sulle entità al secondo. Equivale approssimativamente alla somma di scritture, ricerche e query al secondo. Questa metrica può indicare quali chiavi sono attive. |
| Operazioni di scrittura/s | Numero medio di operazioni sulle entità al secondo per scritture ed eliminazioni. |
| Op/s di ricerca | Numero medio di operazioni sulle 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 scritture ed eliminazioni 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 coda scrittura | Latenza massima di scrittura o eliminazione osservata nei dati elaborati nel bucket. |
| Latenza coda ricerca | Latenza massima di ricerca osservata nei 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 dell'indice al secondo. |
Medie di rendimento
Le metriche sulla latenza media calcolano una media sulle chiavi del 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 Visualizzatore di indicatori chiave mostri una serie di metriche, non mostra ogni singola metrica che può influire sul rendimento della modalità Datastore. Ad esempio:
- I problemi di rete tra la tua applicazione e Google Cloud potrebbero non essere visibili. Potrebbero essere visualizzati come bande verticali in tutte le chiavi in Visualizzatore chiavi, che fornisce solo suggerimenti su 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 un URL di scansione di Key Visualizer ai preferiti o lo condividi, l'URL ha una durata massima di 14 giorni.
Passaggi successivi
- Scopri come iniziare a utilizzare Key Visualizer.
- Comprendi i pattern delle chiavi delle entità o i pattern delle chiavi di indice che potresti visualizzare nelle mappe termiche di Key Visualizer.
- Scopri come esplorare una mappa di calore in dettaglio.