Analizza le statistiche sul rendimento delle query

Questa pagina descrive come utilizzare la dashboard Query Insights per rilevare e analizzare le prestazioni delle query.

Panoramica di Query Insights

Utilizza la dashboard Approfondimenti sulle query per monitorare le query relative alle metriche. In base alle metriche, puoi identificare le query più utilizzate e quelle con latenze elevate che potrebbero richiedere l'ottimizzazione. Utilizza la dashboard Statistiche su query per:

  • Ottimizzazione delle prestazioni delle query: identifica le query con latenze elevate e che potrebbero richiedere l'ottimizzazione.
  • Gestione dei costi delle query: scopri le query ad alto costo e ottimizzale per ridurre i costi.
  • Monitoraggio delle statistiche sulle query: monitora le statistiche sulle query nel tempo.

Dati di Query Insights

Gli approfondimenti sulle query includono i dati dei seguenti metodi dell'API:

Puoi visualizzare i dati sulle query che utilizzano questi metodi per un determinato progetto, database e periodo di tempo compreso tra 10 minuti e 30 giorni. I dati per le query con strutture equivalenti vengono acquisiti in una singola query normalizzata.

Insight sulle query restituisce le seguenti informazioni su una query:

Testo della query normalizzato La struttura della query rappresentata in testo.
Conteggio esecuzioni Numero di esecuzioni nell'intervallo di tempo selezionato.
Numero errori Numero di errori nell'intervallo di tempo selezionato.
Durata media di esecuzione(ms) Il tempo medio in millisecondi impiegato dal database per elaborare la query.
Numero medio di risultati restituiti Il numero di risultati restituiti dalla query. I risultati includono documenti, ID raccolta e bucket aggregati.
Numero medio di documenti scansionati Il numero di documenti scansionati in una query.
Numero medio di voci di indice analizzate Il numero di voci dell'indice esaminate per eseguire la query.
Carica per tempo medio Dati utili per filtrare le query principali in base alla latenza media.
Carico per operazioni di lettura totali (fatturabili) Dati utili per filtrare le query principali in base alle operazioni di lettura fatturabili totali.

Granularità e conservazione dei dati

La granularità dei dati dipende dalla durata specificata:

  • Granularità di 10 minuti per intervalli fino a 4 giorni fa
  • Granularità di 1 ora per intervalli fino a 30 giorni fa

La conservazione massima dei dati per gli Approfondimenti sulle query è di 30 giorni. I dati ogni 10 minuti vengono archiviati per 4 giorni, mentre quelli ogni ora per 30 giorni.

Limitazioni

  • Gli ascoltatori in tempo reale non sono inclusi nelle statistiche degli approfondimenti delle query.
  • I dati degli Approfondimenti sulle query sono in ritardo di 1-2 ore.

Prezzi

Non sono previsti costi aggiuntivi per gli Approfondimenti sulle query.

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per visualizzare la dashboard Approfondimenti sulle query, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore Datastore (roles/datastore.viewer) nel progetto. Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione datastore.insights.get necessaria per visualizzare la dashboard Approfondimenti sulle query.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Visualizza Query Insights

Per visualizzare gli approfondimenti sulle query per un database Firestore, apri il riquadro Approfondimenti sulle query del database nella console Google Cloud.

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

    Vai a Database

  2. Seleziona un database dall'elenco dei database.

  3. Nel menu di navigazione, fai clic su Approfondimenti sulle query.

    La dashboard sull'utilizzo del database Firestore nella console Google Cloud.

    Utilizza il menu a discesa Tipo di caricamento per trovare le query principali in base alla latenza o al numero di operazioni di lettura.

Passaggi successivi