Analizza le statistiche sulle prestazioni delle query
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.
- Suggerimenti per gli indici: identifica gli indici compositi mancanti o non ottimali e crea gli indici suggeriti direttamente dalla dashboard (Enterprise Edition).
Dati di Query Insights
Query Insights include i dati dei seguenti metodi API:
Puoi visualizzare i dati sulle query che utilizzano questi metodi per un determinato progetto, database e durata, da 1 minuto a 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 dell'indice scansionate | Il numero di voci dell'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. |
| Suggerimenti sull'indicizzazione | Indici compositi consigliati, indici utilizzati e impatto stimato sul workload per le query nei database Enterprise Edition. |
Granularità e conservazione dei dati
La granularità dei dati dipende dalla durata specificata:
- Granularità di 1 minuto per intervalli fino a 6 ore fa
- 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 1 minuto vengono archiviati per 6 ore, i dati di 10 minuti vengono archiviati per 4 giorni e i dati orari vengono archiviati per 30 giorni.
Visualizza Query Insights
Per visualizzare Query Insights per un database Firestore, segui questi passaggi:
Nella console Google Cloud , vai alla pagina Database.
Seleziona un database dall'elenco dei database.
Nel menu di navigazione, fai clic su Query Insights.
La pagina Query Insights mostra un grafico delle serie temporali delle query principali insieme a una tabella delle statistiche delle query normalizzate. Per analizzare le prestazioni delle query:
- Seleziona un intervallo di tempo per visualizzare le tendenze storiche o le metriche quasi in tempo reale a intervalli di 1 minuto.
- Utilizza l'elenco Tipo di carico per classificare le query principali in base alla latenza media o alle operazioni di lettura totali.
- Seleziona singole query nella tabella per tracciare e confrontare i relativi conteggi di esecuzione, latenza, documenti analizzati, voci dell'indice analizzate e conteggi degli errori nel grafico.
Suggerimenti sull'indicizzazione
I suggerimenti per gli indici di Query Insights identificano automaticamente le configurazioni degli indici compositi mancanti o non ottimali per le forme di query eseguite di frequente nei database Firestore Enterprise.Nella versione Firestore Enterprise, le query possono essere eseguite anche senza indici compositi corrispondenti, il che può comportare scansioni lente della raccolta completa o operazioni di ordinamento in memoria. La dashboard Query Insights analizza le statistiche storiche di esecuzione delle query e suggerisce indici compositi mirati per ottimizzare la latenza delle query e ridurre i documenti scansionati fatturabili.
Come funzionano i suggerimenti sull'indicizzazione
Una pipeline batch offline valuta periodicamente le query principali storiche:
- Analisi della struttura delle query: estrae i predicati di uguaglianza, ordinamento e intervallo dalle query eseguite di frequente.
- Generazione di indici candidati: genera definizioni di indici composti potenziali utilizzando l'euristica di ordinamento degli indici (Uguaglianza > Ordinamento > Intervallo).
- Valutazione dell'ottimizzatore: inserisce gli indici candidati nel modello di costo del motore di query per confrontare i costi di esecuzione delle query di riferimento con i piani di esecuzione indicizzati ipotetici.
- Ranking dell'impatto sul workload: classifica gli indici consigliati in livelli di impatto in base ai risparmi totali stimati sui costi del workload:
- ALTO: converte le scansioni di intere raccolte in ricerche di indici selettive, riducendo in modo significativo le letture dei documenti e la latenza di esecuzione.
- MEDIUM: elimina le operazioni costose, come l'ordinamento in memoria, fornendo risultati dell'indice preordinati.
- LOW: offre piccoli miglioramenti della ricerca.
Visualizza e crea indici consigliati
Per visualizzare i suggerimenti per gli indici e creare gli indici suggeriti dalla consoleGoogle Cloud :Nella console Google Cloud , vai alla pagina Database.
Dall'elenco dei database, seleziona un database Enterprise Edition.
Nel menu di navigazione, fai clic su Query Insights.
Nella tabella delle query, seleziona una forma di query per visualizzare la relativa scheda Suggerimenti. La scheda mostra:
- La definizione dell'indice composto consigliato (raccolta, campi, ordinamenti o proprietà array-contains).
- Il livello di impatto stimato sul workload (HIGH, MEDIUM o LOW).
- Gli indici utilizzati o un'indicazione che viene eseguita una scansione completa della raccolta.
Fai clic su Crea indice nella scheda dei suggerimenti. Si apre una finestra di dialogo con la raccolta, l'ambito della query e i campi precompilati.
Fai clic su Crea per iniziare a creare l'indice. Puoi monitorare l'avanzamento della creazione dell'indice nella pagina Indici della console Google Cloud .
Versioni e modalità supportate
I suggerimenti per gli indici sono supportati per i database Firestore Enterprise, tra cui:
- Firestore in modalità Native
- Firestore con compatibilità MongoDB
I database della versione Standard non sono supportati per i suggerimenti sugli indici.
Limitazioni
- Gli ascoltatori in tempo reale non sono inclusi nelle statistiche di Query Insights.
- I dati di Query Insights sono disponibili entro pochi minuti dall'esecuzione della query.
- I suggerimenti per gli indici vengono generati periodicamente in base ai dati storici delle query, non in tempo reale.
- I suggerimenti sugli indici propongono nuovi indici composti, ma non suggeriscono di modificare o eliminare gli indici esistenti.
- La creazione automatica degli indici non è supportata. Gli indici consigliati devono essere creati manualmente.
- La normalizzazione delle query sostituisce i valori letterali con segnaposto. I suggerimenti per gli indici si basano su modelli di query normalizzati anziché su valori di runtime specifici.
- La valutazione dei costi utilizza l'euristica anziché il campionamento dei dati in tempo reale. Gli indici consigliati potrebbero non migliorare le prestazioni in ogni scenario e la creazione di un indice aggiunge overhead di scrittura e archiviazione.
Prezzi
Non sono previsti costi aggiuntivi per Query Insights o i suggerimenti per gli indici.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per visualizzare la dashboard di Query Insights e creare gli indici consigliati, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:
-
Visualizza Query Insights:
Datastore Viewer (
roles/datastore.viewer) -
Crea indici consigliati:
- Datastore Index Admin (
roles/datastore.indexAdmin) - Cloud Datastore Owner (
roles/datastore.owner) - Editor (
roles/editor) - Proprietario (
roles/owner)
- Datastore Index Admin (
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per visualizzare la dashboard di Query Insights e creare gli indici consigliati. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per visualizzare la dashboard di Query Insights e creare gli indici consigliati sono necessarie le seguenti autorizzazioni:
-
Visualizza Query Insights:
datastore.insights.get -
Crea indici consigliati:
-
datastore.indexes.create -
datastore.indexes.update
-
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Passaggi successivi
- Utilizza la funzionalità di spiegazione delle query per migliorare le prestazioni delle query
- Monitora l'utilizzo