Guida introduttiva all'utilizzo di Key Visualizer

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

Requisiti di edizione e modalità

Questo documento si applica all'edizione Standard di Firestore in modalità Native.

Prima di iniziare

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

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore di Service Usage (roles/serviceusage.serviceUsageAdmin), che contiene l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

Abilitare l'API

Ruoli obbligatori

Assicurati che al tuo account sia concesso uno dei seguenti ruoli IAM:

  • Cloud Datastore Owner
  • Cloud Datastore Key Visualizer Viewer
  • 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.

Visualizzare una scansione per un periodo di tempo

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.

Per avviare Key Visualizer:

  1. Nella Google Cloud console, 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 scansioni 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à alla scansione. Non puoi selezionare intervalli di tempo che non soddisfano i requisiti di idoneità alla scansione o che sono ancora in fase di elaborazione. L'elaborazione delle due scansioni più recenti del giorno richiede un po' di tempo prima che siano disponibili.

    2. Seleziona Tutti i dati dei documenti o Tutti i dati degli indici 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 Operazioni/s per le chiavi dei documenti e nella metrica Operazioni di scrittura dell'indice/s per le chiavi degli indici.

Per confrontare le metriche o cercare correlazioni tra i dati, puoi visualizzare più metriche di Key Visualizer contemporaneamente. Consulta Trovare le connessioni tra metriche diverse.

Visualizzare una panoramica delle attività

Per visualizzare una panoramica delle 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 sono presenti differenze significative nel pattern di utilizzo per diversi intervalli di chiavi:

  • Gli intervalli mostrati in colori scuri hanno poca o nessuna attività.
  • Gli intervalli in colori vivaci hanno un'attività significativamente maggiore.
  • L'intervallo bianco brillante al centro ha un'attività molto elevata.

Esempio di scansione di Key Visualizer

Scansione delle chiavi dei documenti

La metrica Operazioni/s misura il numero di richieste al secondo per ogni intervallo di chiavi. Questa metrica è la somma delle richieste di scrittura, ricerca e query. Per impostazione predefinita, Key Visualizer mostra questa metrica quando apri una mappa termica.

Dopo aver acquisito un'idea dell'attività complessiva nel database, puoi continuare l'indagine esaminando altre metriche e concentrandoti sugli intervalli di chiavi che potrebbero causare problemi. Scopri di più.

Scansione delle chiavi degli indici

La metrica Operazioni di scrittura dell'indice/s in una determinata cella misura le scritture di indici medie al secondo all'interno dell'intervallo di tempo di 10 secondi e dell'intervallo di chiavi corrispondenti.

Passaggi successivi