Panoramica di Key Visualizer
Questa pagina fornisce una panoramica dello strumento di diagnostica Key Visualizer per Firestore.
Che cos'è Key Visualizer?
Key Visualizer è uno strumento che consente di analizzare i pattern di utilizzo di Firestore. Genera report visivi che suddividono l'utilizzo in base ai documenti a cui accedi o indicizza le voci scritte o eliminate quando i documenti vengono modificati.
Key Visualizer può fornire insight sui modelli di utilizzo su larga scala. Key Visualizer può essere utilizzato da:
- Risoluzione dei problemi di prestazioni. Key Visualizer ti aiuta a identificare i problemi di prestazioni nel database causati da hotspot provenienti da chiavi sequenziali di documenti o di indice o da aumenti improvvisi del traffico.
- Comprendere meglio come si accede ai dati archiviati in Firestore.
- Progettare iterativamente un modello dei dati o migliorare la progettazione di un modello dei dati esistente. In ogni iterazione, puoi controllare 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à:
- Verifica se le operazioni di lettura o scrittura creano hotspot su intervalli di documenti specifici.
- Scopri come un improvviso aumento del traffico influisce sulla latenza.
- Verifica se i pattern di accesso sono bilanciati in tutto il database.
- Controlla la struttura delle chiavi di indice per identificare le definizioni dell'indice che causano problemi di carico dell'indice.
- Utilizza la visualizzazione delle chiavi di indice per eseguire previsioni migliori dei pattern dei carichi di lavoro.
Idoneità alla scansione
Ogni scansione di Key Visualizer copre un periodo di due ore. È disponibile una scansione per un determinato periodo per i database con traffico che supera le 3000 operazioni sui documenti in ogni minuto di quel periodo.
L'idoneità alla scansione dipende completamente dall'attività del database. Non dipende dalla quantità di dati o dal tipo di dati presenti nel database.
Scansioni di Key Visualizer
La seguente immagine mostra una scansione di Key Visualizer. Ogni analisi include una mappa termica che mostra i pattern di accesso o le metriche sulle prestazioni per un gruppo di chiavi di documenti o di indice nel tempo.
Condivisione di 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 di scansione.
Mappe termiche
Il nucleo di una scansione di Key Visualizer è la mappa termica, che mostra il valore di una metrica nel tempo, suddiviso in un massimo di 1000 bucket di chiavi contigui.
Per una mappa termica delle chiavi di documento, l'asse x della mappa termica rappresenta il tempo e l'asse y rappresenta le chiavi dei documenti, mentre per una mappa termica delle chiavi indice l'asse x della mappa termica rappresenta il tempo e l'asse y rappresenta le chiavi di indice.
Ogni analisi di Key Visualizer per Firestore copre due ore di attività suddivise in segmenti da 10 secondi.
Un valore basso di una metrica viene considerato "freddo" e ha un colore scuro. Un valore alto è "hot" e appare in un colore brillante. I valori più alti vengono visualizzati in bianco.
Diversi tipi di utilizzo generano pattern visivi diversi all'interno della mappa termica, il che può consentire di diagnosticare i problemi a colpo d'occhio. Consulta Pattern della mappa termica per le chiavi dei documenti o Pattern della mappa termica per le chiavi di indice per esempi di alcuni pattern comuni.
Key Visualizer offre strumenti per aiutarti a comprendere i dati in ogni scansione. Consulta le sezioni Introduzione a Key Visualizer ed Esplorazione delle mappe termiche.
Bucket chiave
Key Visualizer suddivide tutte le chiavi del database in un massimo di 1000 intervalli contigui, con all'incirca lo stesso numero di chiavi in ogni intervallo. Questi intervalli sono noti come bucket chiave.
Key Visualizer segnala la maggior parte delle metriche come medie per ciascun bucket di chiavi o come valori massimi all'interno di ciascun bucket di chiavi.
Metriche
Le seguenti metriche sono disponibili per le chiavi dei documenti nelle scansioni di Key Visualizer:
| Metriche | Descrizione |
|---|---|
| Metriche delle attività | |
| Operazioni | Numero medio di operazioni sui documenti al secondo. Approssimativamente uguale alla somma di scritture, ricerche e query al secondo. Questa metrica può indicare quali tasti sono attivi. |
| operazioni di scrittura | Numero medio di operazioni sui documenti al secondo per scritture ed eliminazioni. |
| Operazioni di ricerca | Numero medio di operazioni sui documenti al secondo per le ricerche. |
| Operazioni/s query | Numero medio di operazioni sui documenti al secondo per le query. |
| Metriche sul rendimento | |
| Latenza media di scrittura | 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. |
| Scrittura della latenza di coda | Latenza massima di scrittura o eliminazione osservata all'interno dei dati elaborati nel bucket. |
| Latenza coda di ricerca | Latenza di ricerca massima osservata all'interno dei dati elaborati nel bucket. |
| Latenza coda di query | Latenza massima delle query osservata all'interno dei dati elaborati nel bucket. |
La seguente metrica è disponibile per le chiavi di indice nelle scansioni di Key Visualizer:
| Metriche | Descrizione |
|---|---|
| Operazioni di scrittura indice | Numero medio di scritture di indice al secondo. |
Medie di rendimento
Le metriche di latenza media prendono una media rispetto alle chiavi nel bucket di chiavi. Poiché questa misurazione viene eseguita a livello di archiviazione, la latenza riportata qui potrebbe essere inferiore a quella totale registrata da una chiamata API.
Limiti
Sebbene Key Visualizer mostri una varietà di metriche, non mostra ogni singola metrica che può influire sulle prestazioni di Firestore. Ad esempio:
- I problemi di rete tra la tua applicazione e Google Cloud potrebbero non essere visibili. Potrebbero apparire come bande verticali su tutti i tasti in Key Visualizer, che forniscono solo indizi su quando si sono verificati i problemi.
Durata dei dati
I dati raccolti da Key Visualizer per Firestore vengono eliminati dopo 14 giorni.
I dati di Key Visualizer sono disponibili per gli ultimi 14 giorni. Ad esempio, se avvii Key Visualizer il 19 dicembre alle 12:45, la prima ora di inizio che puoi scegliere per un intervallo di due ore è il 5 dicembre alle 13:00.
Questo limite significa anche che se aggiungi o condividi l'URL per una scansione del visualizzatore chiavi, l'URL ha una durata massima di 14 giorni.
Passaggi successivi
- Scopri come iniziare a utilizzare Key Visualizer.
- Esamina i pattern chiave dei documenti o i pattern delle chiavi di indice che potresti vedere nelle mappe termiche di Key Visualizer.
- Scopri come esplorare una mappa termica in dettaglio.