Questa pagina descrive come utilizzare la dashboard di Query Insights per rilevare e analizzare le prestazioni delle query.
Panoramica di Query Insights
Utilizza la dashboard di Query Insights per monitorare le query relative 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 di Query Insights 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 con costi elevati e ottimizzale per ridurre i costi.
- Monitoraggio delle 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 periodo di tempo compreso tra 10 minuti e 30 giorni. I dati per le query con strutture equivalenti vengono acquisiti in un'unica query normalizzata.
Query Insights restituisce le seguenti informazioni su una query:
| Testo della query normalizzato | La struttura della query rappresentata in formato testo. |
| Conteggio esecuzioni | Numero di esecuzioni nella finestra temporale selezionata. |
| Numero errori | Numero di errori nella finestra temporale selezionata. |
| Durata media dell'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 che consentono di 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
La conservazione massima dei dati per Query Insights è di 30 giorni. I dati di 10 minuti vengono archiviati per 4 giorni, mentre i dati orari vengono archiviati per 30 giorni.
Limitazioni
I dati di Query Insights hanno un ritardo 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 di Query Insights, chiedi all'amministratore di concederti il ruolo IAM Datastore Viewer (roles/datastore.viewer) nel progetto.
Questo ruolo predefinito contiene l'autorizzazione datastore.insights.get, necessaria per visualizzare la dashboard di Query Insights.
Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.
Visualizza Query Insights
Console Firebase
- Per visualizzare Query Insights per un database Cloud Firestore, apri il riquadro Query Insights del database nella console Google Cloud.
Nella console Firebase, vai alla pagina Database Firestore.
- Dall'elenco dei database, seleziona un 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.