Analizza le statistiche sul rendimento 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:

  • find
  • aggregate

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 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 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.

Visualizza Query Insights

Console Firebase
  1. Per visualizzare Query Insights per un database Cloud Firestore, apri il riquadro Query Insights del database nella console Google Cloud.
  2. Nella console Firebase, vai alla pagina Database Firestore.

    Vai a Database Firestore

  3. Seleziona un database dall'elenco dei database.
  4. 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.

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.
Per visualizzare i suggerimenti sugli indici e creare gli indici suggeriti dalla console Firebase:

  1. Nella console Firebase, vai alla pagina Database Firestore.

    Vai a Database Firestore

  2. Dall'elenco dei database, seleziona un database Enterprise Edition.

  3. Fai clic sulla scheda Query Insights.

  4. Nella tabella delle query, individua una forma di query con suggerimenti e fai clic su Esamina i suggerimenti nella riga o nel popover.

  5. Nella finestra di dialogo dei suggerimenti per gli indici, esamina la definizione dell'indice composto, l'ordinamento dei campi e il livello di impatto stimato sul workload (ALTO, MEDIO o BASSO).

  6. Fai clic su Salva. Si apre il riquadro laterale Operazioni a lunga esecuzione (LRO) per monitorare l'avanzamento della creazione dell'indice.

  7. Una volta completata la creazione, l'indice viene elencato nella scheda Indici e l'indicatore del suggerimento scompare dalla riga della query.

Versioni supportate

I suggerimenti per gli indici sono supportati solo per i database Firestore Enterprise. I database della versione Standard non sono supportati.

Limitazioni

  • I dati di Query Insights hanno un ritardo di una o due ore.
  • 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 un 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:

  • Per visualizzare Query Insights: Datastore Viewer (roles/datastore.viewer)
  • Per creare gli indici consigliati: Datastore Index Admin (roles/datastore.indexAdmin) o Cloud Datastore Owner (roles/datastore.owner)

Questi ruoli predefiniti contengono le autorizzazioni datastore.insights.get e datastore.indexes.create.

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Passaggi successivi