Analizzare le statistiche sulle prestazioni 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 Query Insights per monitorare le query correlate alle metriche. In base alle metriche, puoi identificare le query utilizzate più di frequente e le query con latenze elevate che potrebbero richiedere l'ottimizzazione. Utilizza la dashboard Query Insights per:
- Ottimizzare le prestazioni delle query: identifica le query con latenze elevate e che potrebbero richiedere l'ottimizzazione.
- Gestire i costi delle query: scopri le query a costi elevati e ottimizzale per ridurre i costi.
- Monitorare le statistiche sulle query: monitora le statistiche sulle query nel tempo.
Dati di Query Insights
Query Insights include i dati dei seguenti metodi API:
listDocumentslistCollectionIdsrunQueryrunAggregationQuerypartitionQueryexecutePipeline
Puoi visualizzare i dati sulle query che utilizzano questi metodi per un determinato progetto, database e durata compresa tra 10 minuti e 30 giorni. I dati per le query con strutture equivalenti vengono acquisiti in una singola query normalizzata.
Query Insights restituisce le seguenti informazioni su una query:
| Testo della query normalizzato | La struttura della query rappresentata nel testo. |
| Conteggio esecuzioni | Numero di esecuzioni nella finestra temporale selezionata. |
| Numero errori | Numero di errori nella finestra temporale selezionata. |
| 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 scansionate | Il numero di voci di indice esaminate per eseguire la query. |
| Latenza media | Dati per filtrare le query principali in base alla latenza media. |
| Carico per operazioni di lettura totali (fatturabili) | Dati 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
Il periodo di conservazione massimo dei dati per Query Insights è di 30 giorni. I dati di 10 minuti vengono archiviati per 4 giorni e i dati orari vengono archiviati per 30 giorni.
Limitazioni
- I listener in tempo reale non sono inclusi nelle statistiche di Query Insights.
- I dati di Query Insights vengono ritardati di una o due ore.
Prezzi
Non sono previsti costi aggiuntivi per Query Insights.
Ruoli obbligatori
Per ottenere l'autorizzazione necessaria per visualizzare la dashboard Query Insights, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore Datastore (roles/datastore.viewer) nel tuo progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene l'
datastore.insights.get
autorizzazione,
necessaria per
visualizzare la dashboard Query Insights.
Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.
Visualizzare Query Insights
Per visualizzare Query Insights per un database Firestore, apri il riquadro Query Insights del database nella Google Cloud console.
Nella Google Cloud console, vai alla pagina Database.
Seleziona un database dall'elenco dei database.
Nel menu di navigazione, fai clic su Query Insights.
Utilizza il menu a discesa Tipo di carico per trovare le query principali in base alla latenza o al numero di operazioni di lettura.