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 quelle 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 delle query: monitora le statistiche delle query nel tempo.
Dati di Query Insights
Query Insights include i dati dei seguenti metodi API:
findaggregate
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. |
| Carico per tempo medio | 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 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.
Questo ruolo predefinito contiene l'autorizzazione datastore.insights.get, necessaria per visualizzare la dashboard Query Insights.
Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.
Visualizza Query Insights
Firebase console
- Per visualizzare Query Insights per un database Firebase, apri il riquadro Query Insights del database nella console Google Cloud.
Nella console Firebase, vai alla pagina Database Firestore.
- Seleziona un database dall'elenco dei database.
- Nell'elenco delle schede, fai clic su Query Insights.
Per trovare le query principali in base alla latenza o al numero di operazioni di lettura, fai clic su Latenza o Operazioni di lettura.