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 di indice 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:
- Risoluzione dei problemi di prestazioni. Key Visualizer ti aiuta a identificare i problemi di prestazioni nel database causati da hotspot provenienti da chiavi di entità o indice sequenziali o da improvvisi aumenti del traffico.
- Comprendere meglio come accedere ai dati archiviati in modalità Datastore.
- Progettare in modo iterativo 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 tuomodello dei datii.
Per raggiungere questi obiettivi, Key Visualizer può aiutarti a completare le seguenti attività:
- Controlla se le tue letture o scritture creano hotspot in intervalli di entità specifici.
- Scopri in che modo un improvviso aumento del traffico influisce sulla latenza.
- Verifica se i pattern di accesso sono bilanciati nel database.
- Controlla la struttura delle chiavi di indice per identificare le definizioni di indice che causano problemi di caricamento dell'indice.
- Utilizza la visualizzazione delle chiavi di indice per fare previsioni migliori sui pattern dei carichi 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 traffico superiore a 3000 operazioni sui documenti in un determinato minuto di quel 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 heatmap che mostra i pattern di accesso o le metriche di rendimento per un gruppo di chiavi di entità o chiavi di indice nel tempo.
Condivisione degli URL di scansione
Puoi condividere o salvare nei preferiti l'URL di una scansione di Key Visualizer. L'URL aprirà la stessa scansione di Key Visualizer e selezionerà la stessa metrica. Questo URL è valido fino alla scadenza della durata dei dati di 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 un massimo di 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 chiaro. I valori più alti sono mostrati in bianco.
Diversi tipi di utilizzo generano diversi pattern visivi all'interno della mappa di calore, il che può consentire di diagnosticare i problemi a colpo d'occhio. Consulta Pattern di mappa termica per le chiavi delle entità o Pattern di mappa termica per le chiavi degli indici per alcuni esempi di pattern comuni.
Key Visualizer fornisce strumenti per aiutarti a comprendere i dati in ogni scansione. Consulta Guida introduttiva all'utilizzo di Key Visualizer ed Esplorare le mappe di calore.
Bucket di chiavi
Key Visualizer divide tutte le chiavi nel database in un massimo di 1000 intervalli contigui, con un numero approssimativamente uguale di chiavi e operazioni al secondo in ogni intervallo. Questi intervalli sono noti come bucket di chiavi.
Key Visualizer utilizza le operazioni/secondo totali di un database per dividere i bucket di chiavi in modo che ogni bucket acquisisca all'incirca lo stesso numero di operazioni/secondo con una dimensione minima prevista di 50 operazioni/secondo per bucket di chiavi. Per i database con un numero totale di operazioni al secondo più elevato, i bucket di chiavi possono acquisire più di 50 operazioni al secondo ciascuno. I database con meno di 50 operazioni/s generano scansioni con un singolo bucket di chiavi.
Key Visualizer riporta la maggior parte delle metriche come medie in ogni bucket di chiavi o come valori massimi in ogni bucket di chiavi.
Metriche
Per le chiavi delle entità nelle scansioni di Key Visualizer sono disponibili le seguenti metriche:
| Metriche | Descrizione |
|---|---|
| Metriche sull'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 più richieste. |
| Operazioni di scrittura/sec | Numero medio di operazioni di entità al secondo per scritture ed eliminazioni. |
| Operazioni di ricerca al secondo | Numero medio di operazioni di entità al secondo per le ricerche. |
| Query al secondo | Numero medio di operazioni di 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 coda di scrittura | Latenza massima di scrittura o eliminazione osservata all'interno dei dati elaborati nel bucket. |
| Latenza di coda della ricerca | Latenza di ricerca massima osservata all'interno dei dati elaborati nel bucket. |
| Latenza finale della query | Latenza massima osservata delle query all'interno dei dati elaborati nel bucket. |
Per le chiavi di indice nelle scansioni di Key Visualizer è disponibile la seguente metrica:
| Metriche | Descrizione |
|---|---|
| Operazioni di scrittura indice/sec. | Numero medio di scritture di indice al secondo. |
Medie del rendimento
Le metriche di latenza media calcolano la media delle chiavi nel bucket di chiavi. Poiché questa misurazione viene eseguita a 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 visualizza ogni singola metrica che può influire sul rendimento della modalità Datastore. Ad esempio:
- I problemi di rete tra l'applicazione e Google Cloud potrebbero non essere visibili. Potrebbero apparire come bande verticali in tutte le chiavi di Key Visualizer, fornendo 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 avvii Key Visualizer il 19 dicembre alle 12:45, l'ora di inizio più recente 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 scansione di Key Visualizer, l'URL ha una durata massima di 14 giorni.
Passaggi successivi
- Scopri come iniziare a utilizzare Key Visualizer.
- Comprendi i pattern delle chiavi di entità o i pattern delle chiavi di indice che potresti visualizzare nelle mappe termiche di Key Visualizer.
- Scopri come esplorare in dettaglio una mappa termica.