Guida introduttiva all'utilizzo di Key Visualizer

Questa pagina descrive come utilizzare Key Visualizer per verificare la presenza di problemi di prestazioni correlati ai tuoi pattern di utilizzo di Firestore.

Prima di iniziare

Per utilizzare Key Visualizer per Firestore, devi abilitare l'API Firestore Key Visualizer.

Abilita l'API

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.get
  • datastore.keyVisualizerScans.list
  • datastore.databases.getMetadata
  • resourcemanager.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:

  1. Nella console Google Cloud, vai alla pagina Database.

    Vai a Database

  2. Seleziona il database richiesto dall'elenco dei database.

  3. Nel menu di navigazione, fai clic su Key Visualizer.

  4. Seleziona un intervallo di tempo e una metrica dalle analisi di Key Visualizer disponibili:

    1. 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.

    2. Seleziona Tutti i dati del documento o Tutti i dati dell'indice come origine.

    3. Fai clic su Aggiorna.

  5. 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 dei documenti 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.

Esempio di analisi di Key Visualizer

Scansione dei tasti dei documenti

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