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 ti aiuta ad analizzare Firestore modelli di utilizzo. Genera report visivi che suddividono l'utilizzo in base ai documenti a cui accedi o alle voci dell'indice che vengono scritte o eliminate man mano che i documenti vengono modificati.
Key Visualizer può fornire informazioni sui pattern di utilizzo su larga scala. Gli utilizzi di Key Visualizer includono:
- Risoluzione dei problemi di prestazioni. Key Visualizer ti aiuta a identificare a causa di problemi di prestazioni del database da hotspot di chiavi sequenziali di documenti o indici oppure aumenti improvvisi del traffico.
- Comprendere meglio come accedi ai dati archiviati in Firestore.
- Progettazione iterativa di un modello di dati o miglioramento della progettazione di un modello di dati esistente. 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 documenti specifici.
- Scopri in che modo un aumento improvviso del traffico influisce sulla latenza.
- Verifica se i pattern di accesso sono bilanciati in tutto il 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à 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 documento o 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 della scansione dei dati.
Heatmaps
Il nucleo di una scansione di Key Visualizer è la mappa termica, che mostra il valore di un metrica nel tempo, suddivisa in un massimo di 1000 contigui bucket chiave.
Per una mappa termica delle chiavi dei documenti, l'asse x della mappa termica rappresenta il tempo, mentre l'asse y rappresenta le chiavi dei documenti. Per una mappa termica delle chiavi degli indici, l'asse x della mappa termica rappresenta il tempo, mentre l'asse y rappresenta le chiavi degli indici.
Ogni analisi di Key Visualizer per Firestore 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 vengono visualizzati 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 dei documenti 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 chiave
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 la dimensione prevista di 50 operazioni/s per bucket di chiavi. Per i database con un numero totale di operazioni più elevato, i bucket chiave possono acquisire più di 50 operazioni ciascuno. I database con meno di 50 operazioni/s generano scansioni con un singolo bucket di chiave.
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 dei documenti nelle scansioni di Key Visualizer sono disponibili le seguenti metriche:
| Metriche | Descrizione |
|---|---|
| Metriche delle attività | |
| Operazioni/s | Numero medio di operazioni sui documenti al secondo. Approssimativamente uguale 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 sui documenti al secondo per scritture ed eliminazioni. |
| Operazioni di ricerca/s | Numero medio di operazioni sui documenti al secondo per le ricerche. |
| Operazioni query | Numero medio di operazioni sui documenti 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 nei 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. |
La seguente metrica è disponibile per le chiavi di indice nelle scansioni di Key Visualizer:
| 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 Key Visualizer mostri una serie di metriche, non mostra ogni singola metrica che può influire sul rendimento di Firestore. Per esempio:
- I problemi di rete tra la tua applicazione e Google Cloud potrebbero non essere visibile. Potrebbero apparire 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 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
- Scopri come iniziare a utilizzare Key Visualizer.
- Comprendere i pattern delle chiavi del documento o la chiave di indice modelli che potresti vedere nelle mappe termiche di Key Visualizer.
- Scopri come esplorare una mappa di calore in dettaglio.