Questa pagina descrive come utilizzare Key Visualizer per verificare la presenza di problemi di prestazioni correlati ai pattern di utilizzo di Firestore in modalità Datastore.
Prima di iniziare
Per utilizzare Key Visualizer per la modalità Datastore, devi abilitare l'API Firestore Key Visualizer.
Ruoli obbligatori
Assicurati che al tuo account venga concesso uno dei seguenti ruoli IAM:
- Proprietario Cloud Datastore
- Visualizzatore Cloud Datastore Key Visualizer
- Editor
- Proprietario
Questi ruoli includono le seguenti autorizzazioni IAM necessarie per accedere a Key Visualizer:
datastore.keyVisualizerScans.getdatastore.keyVisualizerScans.listdatastore.databases.getMetadataresourcemanager.projects.get
Puoi anche definire un ruolo personalizzato con le autorizzazioni richieste.
Visualizzazione di una scansione per un periodo di tempo
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.
Per avviare Key Visualizer:
Nella console Google Cloud, vai alla pagina Database.
Seleziona il database richiesto dall'elenco dei database.
Nel menu di navigazione, fai clic su Key Visualizer.
Seleziona un intervallo di tempo e una metrica dalle analisi di Key Visualizer disponibili:
Fai clic sull'icona a forma di matita in alto a destra. Seleziona una data e un intervallo di tempo.
Le scansioni sono disponibili in base all'idoneità alle scansioni. Non puoi selezionare intervalli di tempo che non soddisfano l'idoneità dell'analisi o che sono ancora in fase di elaborazione. L'elaborazione delle due analisi più recenti della giornata richiederà un po' di tempo prima di essere disponibili.
Seleziona Tutti i dati dell'entità o Tutti i dati dell'indice come origine.
Fai clic su Aggiorna.
Seleziona una metrica da analizzare:
Fai clic sul menu a discesa delle metriche in alto a sinistra e seleziona una metrica da visualizzare. Per impostazione predefinita, Key Visualizer si apre nella metrica Ops/s per le chiavi di entità e nella metrica Index Write Ops/s per le chiavi di indice.
Per confrontare le metriche o cercare correlazioni dei dati, puoi visualizzare insieme più metriche di Key Visualizer. Consulta l'articolo Trovare connessioni tra diverse metriche.
Visualizzare la panoramica di un'attività
Per una panoramica dell'attività durante il periodo di tempo di due ore selezionato, esamina la mappa termica per la metrica predefinita.
L'esempio seguente mostra una mappa termica in cui esistono differenze significative nel modello di utilizzo per diversi intervalli chiave:
- Gli intervalli mostrati con colori scuri hanno poca attività o nessuna.
- Gli intervalli con colori vivaci hanno un'attività significativamente maggiore.
- L'intervallo bianco luminoso al centro ha un'attività molto elevata.
Scansione chiavi entità
La metrica Ops/s misura il numero di richieste al secondo per ogni intervallo di chiavi. Questa metrica è la somma delle richieste di scrittura, ricerca e query. Key Visualizer mostra questa metrica per impostazione predefinita quando apri una mappa termica.
Dopo aver fatto un'idea dell'attività complessiva del database, puoi continuare l'indagine esaminando altre metriche e concentrandoti sugli intervalli chiave che potrebbero causare problemi. Scopri di più.
Scansione chiavi indice
La metrica Operazioni di scrittura indice in una determinata cella misura le scritture medie dell'indice al secondo entro l'intervallo di tempo di 10 secondi e l'intervallo di chiavi corrispondenti.
Passaggi successivi
- Scopri come riconoscere pattern comuni nelle mappe termiche per le chiavi delle entità.
- Scopri come riconoscere pattern comuni nelle mappe termiche per i tasti di indice.
- Scopri come esplorare una mappa termica in modo approfondito.