Utilizzare Query Insights per migliorare le prestazioni delle query

MySQL   |  PostgreSQL   |  SQL Server

In questa pagina viene descritto come utilizzare la dashboard di Query Insights per: rilevare e analizzare problemi di prestazioni.

Introduzione

Query Insights consente di rilevare, diagnosticare e prevenire problemi di prestazioni delle query per o i database Cloud SQL. Supporta un monitoraggio intuitivo e fornisce informazioni diagnostiche che ti aiutano ad andare oltre il rilevamento per identificare la causa principale dei problemi di prestazioni.

Con Query Insights puoi monitorare le prestazioni a livello di applicazione Tracciare l'origine di una query problematica nello stack di applicazioni in base al modello, visualizzazione, controller, route, utente e host. Lo strumento Query Insights può integrare con gli strumenti di monitoraggio delle applicazioni (APM) esistenti e con Google Cloud e i servizi cloud usando standard aperti e API. In questo modo, puoi monitorare risolvere i problemi relativi alle query utilizzando il tuo strumento preferito.

Query Insights ti aiuta a migliorare le prestazioni delle query Cloud SQL fornendoti indicazioni i seguenti passaggi:

1. Visualizza il carico del database per le query principali.
2. Identifica una query o un tag potenzialmente problematico.
3. Esamina la query o il tag per identificare i problemi.
4. Individua l'origine del problema.

Query Insights è supportato su tutti i tipi di macchine Cloud SQL e disponibile in tutte le regioni di Google Cloud.

Query Insights è disponibile per MySQL 5.7 e versioni successive.

Prezzi

Non sono previsti costi aggiuntivi per Query Insights. Puoi accedere ai dati di una settimana su la dashboard di Query Insights.

Nota: per impostazione predefinita, Query Insights mostra solo i dati delle query completate, a meno che stai monitorando le query attive nell'ambito di Gemini in Databases. Per monitorare tutte le query eseguite in tempo reale, consulta Monitora le query attive. Gemini in Databases è in Anteprima.

Query Insights non occupa spazio di archiviazione nell'istanza Cloud SQL di archiviazione. Le metriche vengono archiviate in Cloud Monitoring. Per le richieste API, consulta la pagina Prezzi di Cloud Monitoring. Cloud Monitoring offre un livello che puoi utilizzare senza costi aggiuntivi.

Puoi creare un account per valutare le prestazioni di Cloud SQL in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti da spendere su Cloud SQL per l'esecuzione, il test e il deployment dei carichi di lavoro. Non ti verrà addebitato alcun importo fino a quando non eseguirai l'upgrade.

Registrati per provare Cloud SQL gratuitamente.

Prima di iniziare

Per visualizzare un piano di query o eseguire il tracciamento end-to-end, devi disporre di autorizzazioni IAM specifiche. Crea un ruolo personalizzato a cui aggiungi l'autorizzazione IAM cloudtrace.traces.get. Quindi, aggiungi questo ruolo a ciascun utente che deve utilizzare Query Insights.

Per visualizzare i piani di query e le relative viste end-to-end, nel progetto Google Cloud deve essere abilitata l'API Trace. Questa impostazione consente al progetto Google Cloud di ricevere dati di traccia da origini autenticate senza costi aggiuntivi. Questi dati possono aiutarti a rilevare e diagnosticare problemi di prestazioni dell'istanza.

Per verificare che l'API Trace sia abilitata, segui questi passaggi:

1. Nella console Google Cloud, vai ad API e servizi:

   Vai ad API e servizi

2. Fai clic su Abilita API e servizi.
3. Nella barra di ricerca, inserisci Trace API.
4. Se è visualizzato API abilitata, questa API è abilitata e non devi fare nulla. In caso contrario, fai clic su Attiva.

Abilita Query Insights

Le metriche di Query Insights sono criptate at-rest. Gli utenti che hanno accesso La dashboard di Cloud SQL può accedere a Query Insights nella dashboard di Query Insights. Se disponi dell'autorizzazione per eseguire l'aggiornamento puoi configurare Query Insights. Per un elenco delle autorizzazioni richieste per le istanze Cloud SQL, Controllo dell'accesso al progetto Cloud SQL. Se non disponi di queste autorizzazioni e vuoi abilitare Query Insights sul tuo di Compute Engine, quindi contatta l'amministratore.

Nota: quando abiliti Query Insights, tutte le altre operazioni vengono temporaneamente sospeso. Queste operazioni includono controlli di integrità, logging, il monitoraggio e altre operazioni dell'istanza. Tuttavia, l'istanza stessa non riavvialo e continuerai ad avere accesso senza interruzioni al tuo database.

Console

Nota: se Query Insights non è abilitato su nessuna delle istanze, puoi abilitare Query Insights facendo clic su Abilita o Abilita per più istanze Dashboard di Query Insights.

Abilitare Query Insights per un'istanza

1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
3. Nel riquadro Configurazione, fai clic su Modifica configurazione.
4. Nella sezione Opzioni di configurazione, espandi Approfondimenti sulle query.
5. Seleziona la casella di controllo Attiva Query Insights.
6. (Facoltativo) Seleziona una o più delle seguenti opzioni Query Insights:

Archivia gli indirizzi IP dei clienti

Valore predefinito: false

Archivia gli indirizzi IP dei client da cui provengono le query e ti aiuta raggrupparli per eseguire le metriche. Le query provengono da più di una . L'analisi dei grafici per le query dagli indirizzi IP dei client può essere utile per identificare l'origine di un problema.

Archivia i tag delle applicazioni

Valore predefinito: false

Archivia i tag dell'applicazione che consentono di determinare le API route modello-vista-controller (MVC) che effettuano richieste e raggruppano i dati per eseguire le metriche corrispondenti. Questa opzione richiede di commentare le query con un un set specifico di tag usando sqlcommenter libreria di strumentazione automatica di mappatura relazionale open source (ORM). Queste informazioni consentono a Query Insights di identificare l'origine di un problema e MVC da cui proviene il problema. I percorsi delle applicazioni consentono di monitorare le applicazioni.

Personalizzare la lunghezza delle query

Valore predefinito: 1024

Imposta il limite di lunghezza delle query su un valore specificato compreso tra 256 e 4500 byte. Se le query hanno una lunghezza maggiore, analitiche, ma richiedono anche più memoria. Modifica della query di lunghezza richiede il riavvio dell'istanza. Puoi comunque aggiungere tag alle query che superano il limite di lunghezza.

Impostare la frequenza di campionamento massima

Valore predefinito: 5

Imposta la frequenza di campionamento massima. La frequenza di campionamento è il numero di esempi di piano di query eseguiti che vengono acquisiti al minuto in tutti i database dell'istanza. Modifica questo valore scegliendo un numero compreso tra 0 (per disattivare il campionamento) su 20. È probabile che l'aumento della frequenza di campionamento fornisca più punti dati, ma potresti aumentare l'overhead delle prestazioni.

7. Fai clic su Salva.

Abilitare Query Insights per più istanze

1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Fai clic su Altre azioni Menu su qualsiasi riga.
3. Seleziona Abilita Query Insights.
4. Nella finestra di dialogo, seleziona la casella di controllo Abilita Query Insights per più istanze .
5. Fai clic su Attiva.
6. Nella finestra di dialogo successiva, seleziona le istanze per le quali vuoi abilitare Query Insights.
7. Fai clic su Abilita Query Insights.
   Nota: questo passaggio abilita Query Insights sulle tue istanze in base alla configurazione predefinita.

gcloud

Per abilitare Query Insights per un'istanza Cloud SQL utilizzando gcloud, esegui gcloud sql instances patch con il flag --insights-config-query-insights-enabled come segue dopo aver sostituito INSTANCE_ID con l'ID dell'istanza.

gcloud sql instances patch INSTANCE_ID \
--insights-config-query-insights-enabled
  

Inoltre, utilizza uno o più dei seguenti flag facoltativi:

• --insights-config-record-client-address

  Archivia gli indirizzi IP dei client da cui provengono le query e ti aiuta raggrupparli per eseguire le metriche. Le query provengono da più di una . L'analisi dei grafici per le query dagli indirizzi IP dei client può essere utile per identificare l'origine di un problema.

• --insights-config-record-application-tags

  Archivia i tag dell'applicazione che consentono di determinare le API route modello-vista-controller (MVC) che effettuano richieste e raggruppano i dati per eseguire le metriche corrispondenti. Questa opzione richiede di commentare le query con un un insieme specifico di tag. Puoi farlo usando sqlcommenter. libreria di strumentazione automatica di mappatura relazionale open source (ORM). Queste informazioni consentono a Query Insights di identificare l'origine di un problema e MVC da cui proviene il problema. I percorsi delle applicazioni consentono di monitorare le applicazioni.

• --insights-config-query-string-length

  Imposta il limite di lunghezza delle query predefinito su un valore specificato compreso tra 256 e 4500 byte. La lunghezza predefinita delle query è 1024 byte. Se le query hanno una lunghezza maggiore, analitiche, ma richiedono anche più memoria. Modifica della query di lunghezza richiede il riavvio dell'istanza. Puoi comunque aggiungere tag alle query che superano il limite di lunghezza.

• --query_plans_per_minute

  Per impostazione predefinita, vengono acquisiti un massimo di 5 esempi di piano di query eseguiti al minuto in tutti i database dell'istanza. Modifica questo valore scegliendo un numero compreso tra 0 (per disattivare il campionamento) su 20. È probabile che l'aumento della frequenza di campionamento fornisca più punti dati, ma potresti incrementare il sovraccarico delle prestazioni.

Sostituisci quanto segue:

• INSIGHTS_CONFIG_QUERY_STRING_LENGTH: la stringa di query da memorizzare, in byte.
• API_TIER_STRING: il configurazione di istanze personalizzate da utilizzare per l'istanza.
• REGION: il regione per l'istanza.

gcloud sql instances patch INSTANCE_ID \
--insights-config-query-insights-enabled \
--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH \
--query_plans_per_minute=QUERY_PLANS_PER_MINUTE \
--insights-config-record-application-tags \
--insights-config-record-client-address \
--tier=API_TIER_STRING \
--region=REGION
  

REST v1

Per abilitare Query Insights per un'istanza Cloud SQL utilizzando il comando API REST, chiama instances.patch con le impostazioni di insightsConfig.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• project-id: l'ID del progetto.
• instance-id: l'ID istanza.

Metodo HTTP e URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON della richiesta:

{
  "settings" : { "insightsConfig" : { "queryInsightsEnabled" : true } }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

PowerShell (Windows)

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2021-01-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Terraform

Per utilizzare Terraform per abilitare Query Insights per un'istanza Cloud SQL, imposta la classe query_insights_enabled flag per true. Inoltre, puoi utilizzare uno o più dei seguenti flag facoltativi:

query_string_length: il valore predefinito è 1024 e puoi e lo configuri con un valore compreso tra 256 e 4500 in byte.

record_application_tags: imposta il valore su true se vuoi per registrare i tag dell'applicazione dalla query.

record_client_address: imposta il valore su true se vuoi registrare l'indirizzo IP del client.

query_plans_per_minute: il valore predefinito è 5 e puoi configurarlo in un valore compreso tra 5 e 20.

Ecco un esempio:

resource "google_sql_database_instance" "INSTANCE_NAME" {
 name                = "INSTANCE_NAME"
 database_version    = "MYSQL_VERSION"
 region              = "REGION"
 root_password       = "PASSWORD"
 deletion_protection = false # set to true to prevent destruction of the resource
 settings {
   tier = "DB_TIER"
   insights_config {
     query_insights_enabled  = true
     query_string_length     = 2048 # Optional
     record_application_tags = true # Optional
     record_client_address   = true # Optional
     query_plans_per_minute  = 10 # Optional
   }
 }
}

Per applicare la configurazione Terraform a un progetto Google Cloud, completa i passaggi nella le sezioni seguenti.

Prepara Cloud Shell

1. Avvia Cloud Shell.

2. Imposta il progetto Google Cloud predefinito dove vuoi applicare le configurazioni Terraform.

   Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Le variabili di ambiente vengono sostituite se imposti valori espliciti in Terraform di configurazione del deployment.

Prepara la directory

Ogni file di configurazione Terraform deve avere una directory (inoltre chiamato modulo principale).

1. In Cloud Shell, crea una directory e un nuovo all'interno di quella directory. Il nome del file deve contenere .tf, ad esempio main.tf. In questo tutorial, il file è denominato main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

   Copia il codice campione nel nuovo oggetto main.tf.

   Facoltativamente, copia il codice da GitHub. Opzione consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

3. Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
4. Salva le modifiche.
5. Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory.

   terraform init

   Facoltativamente, per utilizzare la versione più recente del provider Google, includi -upgrade :

   terraform init -upgrade

Applica le modifiche

1. Rivedi la configurazione e verifica che le risorse che Terraform creerà o che l'aggiornamento soddisfi le tue aspettative:

   terraform plan

   Apporta le correzioni necessarie alla configurazione.

2. Applica la configurazione Terraform eseguendo questo comando e inserendo yes alla richiesta:

   terraform apply

   Attendi finché Terraform non visualizzi il messaggio "Applicazione completata!". .

3. Apri il progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nella UI per assicurarti create o aggiornate da Terraform.

Nota: gli esempi di Terraform in genere presuppongono che le API richieste siano nel tuo progetto Google Cloud.

Le metriche dovrebbero essere disponibili in Query Insights entro pochi minuti dal completamento della query. Esamina il criterio di conservazione dei dati di Cloud Monitoring. Le tracce Query Insights vengono archiviate in Cloud Trace. Esamina il Criterio di conservazione dei dati di Cloud Trace.

Visualizza la dashboard di Query Insights

La dashboard di Query Insights mostra il carico delle query in base a fattori. che selezioni. Il carico di query è una misurazione del lavoro totale per tutte le nell'istanza nell'intervallo di tempo selezionato. La dashboard fornisce serie di filtri per visualizzare il carico delle query.

Per aprire la dashboard di Query Insights, segui questi passaggi:

1. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
2. Seleziona la scheda Query Insights nel riquadro di navigazione a sinistra. o fai clic su Vai a Query Insights per informazioni più approfondite sulle query sul rendimento.

Si apre la dashboard di Query Insights. Mostra le seguenti informazioni sull'istanza:

• Database: filtra il carico delle query su un database specifico o su tutti o Microsoft SQL Server.
• Utente: filtra il carico delle query da un account utente specifico.
• Indirizzo client: filtra il carico delle query da un indirizzo IP specifico.
• Intervallo di tempo: filtra il carico delle query in base a intervalli di tempo, ad esempio ora, giorno, settimana, mese o un intervallo personalizzato.
• Grafico del carico del database: mostra il grafico del carico delle query, basato su dati filtrati.
• Capacità CPU, CPU e attesa CPU, attesa IO e attesa blocco: I filtri vengono caricati in base alle opzioni selezionate. Consulta Visualizza il carico del database per le query principali per i dettagli su ciascuno di questi filtri.
• Query e tag. Filtra il carico delle query in base a una query selezionata o un tag di query SQL selezionato. Consulta Filtra il carico del database.

Nota: se abiliti Gemini in Databases, il criterio di conservazione dei dati per le metriche di query sarà di 30 giorni. Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. Puoi trattare i dati personali per questa funzione come descritto in Trattamento dati Cloud Addendum, fatte salve le obbligazioni e le limitazioni descritte nel contratto alla accedi a Google Cloud.

Visualizza il carico del database per tutte le query

Il carico delle query database è una misura del lavoro (in secondi CPU) che le query eseguite nel database selezionato vengono eseguite nel tempo. Ciascuna in esecuzione la query sta utilizzando o in attesa di risorse CPU, risorse IO o Google Cloud. Il carico delle query nel database è il rapporto tra la quantità di tempo impiegato da tutti le query completate in un determinato intervallo di tempo fino all'ora reale.

La dashboard di primo livello di Query Insights mostra il Carico del database - tutti i principali delle query. I menu a discesa sulla dashboard consentono di filtrare il grafico per un indirizzo specifico di database, utente o client.

Le linee colorate nel grafico mostrano il carico delle query, suddivise in quattro categorie:

• Capacità CPU: il numero di CPU disponibili nell'istanza.

• Attesa CPU e CPU: il rapporto tra il tempo impiegato dalle query in un ambiente alle ore effettive. I tempi di attesa per IO e blocco non bloccano le query in attivo. Questa metrica potrebbe significare che la query utilizza la CPU o in attesa che lo scheduler Linux pianifica il server processo che esegue la query mentre altri processi utilizzano la CPU.

  Nota: il carico della CPU tiene conto sia del runtime sia del tempo di attesa con lo scheduler Linux per pianificare il processo server in esecuzione. Come come risultato, il carico della CPU può andare oltre la linea massima del core.

• Attesa I/O: il rapporto tra il tempo impiegato dalle query in attesa di I/O per alle ore tradizionali. L'attesa I/O include attesa di lettura I/O e attesa di scrittura I/O.

  Se vuoi un'analisi dettagliata delle informazioni sulle attese IO, puoi visualizzarle in e configurazione in Cloud Monitoring. Per ulteriori informazioni, consulta le metriche di Cloud SQL.

• Attesa blocco: il rapporto di tempo impiegato dalle query in attesa di blocchi alle ore reali. Include Lock waits, LwLock waits e pin del buffer La serratura attende. Per visualizzare un'analisi dettagliata delle informazioni relative ai tempi di attesa dei blocchi, utilizza Cloud Monitoring. Per ulteriori informazioni, consulta le metriche di Cloud SQL.

Esamina il grafico e utilizza le opzioni di filtro per rispondere a queste domande:

1. Il carico di query è elevato? Il grafico è aumenta o aumenta nel tempo? Se non noti un carico elevato, non riguarda la tua query.
2. Quanto tempo è stato elevato? È alto solo ora o è già stato alta per molto tempo? Utilizza il selettore di intervallo per selezionare vari periodi di tempo per scoprire quanto è durato il problema. Aumenta lo zoom per visualizzare un di tempo durante il quale si osservano picchi di carico delle query. Diminuisci lo zoom per visualizzare fino a una settimana della sequenza temporale.
3. Qual è la causa del carico elevato? Puoi selezionare le opzioni per esaminare la CPU capacità, attesa CPU e CPU, attesa blocco o attesa IO. Il grafico di ciascuna delle queste opzioni sono di un colore diverso in modo da poter individuare facilmente quella con carico massimo. La linea blu scuro nel grafico mostra la capacità massima della CPU all'interno del sistema. Consente di confrontare il carico delle query con il numero massimo di CPU e la capacità di archiviazione. Questo confronto consente di determinare se un'istanza è in esecuzione delle risorse della CPU.
4. Quale database è soggetto a questo carico? Seleziona database diversi da il menu a discesa Database per trovare i database con i caricamenti più elevati.
5. Utenti o indirizzi IP specifici causano carichi più elevati? Seleziona i diversi utenti e indirizzi dai menu a discesa per identificare quelli che causano carichi più elevati.

Filtra il carico del database

Puoi filtrare il carico del database per query o tag.

Filtra per query

La tabella Query fornisce una panoramica delle query che causano il la maggior parte del carico di query. La tabella mostra tutte le query normalizzate per la finestra temporale e le opzioni selezionate nella dashboard di Query Insights. Ordina le query in base Tempo totale di esecuzione durante l'intervallo di tempo selezionato.

Per ordinare la tabella, seleziona un'intestazione di colonna o una proprietà da Filtra query. La tabella mostra le seguenti proprietà:

• Query: la stringa di query normalizzata. Query Insights mostra solo 1024 caratteri nella stringa di query per impostazione predefinita.

  Le query con l'etichetta UTILITY COMMAND di solito includono BEGIN, COMMIT e EXPLAIN o comandi wrapper.

• Database: il database in base al quale è stata eseguita la query.

• Caricamento per tempo totale/caricamento per CPU/caricamento per attesa di I/O/caricamento per attesa blocco: Le opzioni in base alle quali è possibile filtrare query specifiche per trovare il carico più grande.

• Tempo medio di esecuzione (ms). Il tempo medio per l'esecuzione della query.

• Numero di chiamate: il numero di volte in cui l'applicazione ha chiamato la query.

• Media righe restituite: il numero medio di righe restituite per la query.

• Media righe scansionate: il numero medio di righe analizzate per la query.

Query Insights archivia e mostra solo le query normalizzate. Per impostazione predefinita, le query Gli insight non raccolgono indirizzi IP o informazioni sui tag. Puoi abilitare le query Insight per raccogliere queste informazioni e, se necessario, disattivarne la raccolta. Le tracce del piano di query non raccolgono né archiviano valori costanti e rimuove qualsiasi PII che la costante potrebbe mostrare.

Query Insights mostra le query normalizzate, ovvero ? sostituisce il valore della costante letterale. Nell'esempio seguente, la costante del nome viene rimosso e ? lo sostituisce.

UPDATE
  "demo_customer"
SET
  "customer_id" = ?::uuid,
  "name" = ?,
  "address" = ?,
  "rating" = ?,
  "balance" = ?,
  "current_city" = ?,
  "current_location" = ?
WHERE
  "demo_customer"."id" = ?

Filtra per tag di query

Per risolvere i problemi di un'applicazione, devi prima aggiungere tag alle query SQL. I tag di caricamento query forniscono una suddivisione del carico di query del tag selezionato su nel tempo.

Query Insights fornisce un monitoraggio incentrato sull'applicazione per diagnosticare le prestazioni per le applicazioni create utilizzando gli ORM. Se sei responsabile dell'intero stack di applicazioni, Query Insights fornisce il monitoraggio delle query vista. Il tagging delle query consente di individuare problemi a costrutti di livello superiore, come con la logica di business o un microservizio.

Potresti taggare le query in base alla logica di business, ad esempio i dati di pagamento, inventario, analisi aziendali o tag di spedizione. Puoi quindi il carico della query creato dalle varie logiche di business. Ad esempio, potrebbero osservare eventi imprevisti, come i picchi per un tag di analisi dell'attività a 1 PM o crescita anomala per un servizio di pagamento di tendenza nella settimana precedente.

Per calcolare il Carico del database per il tag, Query Insights utilizza la quantità di tempo impiegato da ogni query che utilizza il tag selezionato. Lo strumento calcola il tempo di completamento al limite dei minuti utilizzando l'ora reale.

Nella dashboard di Query Insights, seleziona Tag per visualizzare la tabella dei tag. La che ordina i tag in base al loro carico totale per tempo totale.

Puoi ordinare la tabella selezionando una proprietà in Filtra tag oppure per facendo clic su un'intestazione di colonna. La tabella mostra le seguenti proprietà:

• Azione, Controller, Framework, Route, Applicazione, driver DB: ogni proprietà aggiunta alle query viene visualizzata in una colonna. Almeno uno devi aggiungere di queste proprietà se vuoi filtrare per tag.
• Caricamento per tempo totale/Caricamento per CPU/Caricamento per attesa di I/O/Caricamento per attesa blocco: opzioni per filtrare query specifiche e trovare il carico più grande per ciascuna opzione.
• Tempo medio di esecuzione (ms). Il tempo medio per l'esecuzione della query.
• Media righe restituite: il numero medio di righe restituite per la query.
• Media righe scansionate: il numero medio di righe analizzate per la query.
• Numero di chiamate: il numero di volte in cui l'applicazione ha chiamato la query.
• Database: il database in base al quale è stata eseguita la query.

Esaminare una query o un tag specifico

Per determinare se una query o un tag è la causa principale del problema, effettua le seguenti operazioni dalla scheda Query o dalla scheda Tag, rispettivamente:

1. Per ordinare l'elenco in ordine decrescente, fai clic sull'intestazione Carica per tempo totale.
2. Fai clic sulla query o sul tag in cima all'elenco. Ha il carico più alto e sta prendendo più tempo degli altri.

Viene visualizzata una dashboard che mostra i dettagli della query o del tag selezionato.

Esaminare un carico di query specifico

La dashboard per una query selezionata viene visualizzata come segue:

Il grafico Carico database - query specifica mostra una misura del lavoro (in secondi CPU) che la query normalizzata ha eseguito nel query selezionata nel tempo. Per calcolare il carico, utilizza la quantità di tempo impiegato le query normalizzate completate al minuto al limite alle ore tradizionali. Nella parte superiore della tabella, vengono visualizzati i primi 1024 caratteri della query normalizzata, vengono visualizzati i valori letterali rimossi per l'aggregazione e per motivi relativi alle PII.

Come per il grafico delle query totali, puoi filtrare il carico per una query specifica in base a Database, Utente e Indirizzo client. Il carico delle query è suddiviso in CPU capacità massima, Attesa CPU e CPU, Attesa I/O e Attesa blocco.

Esaminare un carico di query con tag specifico

La dashboard per un tag selezionato viene visualizzata come segue. Ad esempio, se tutte le query da un di microservizi sono contrassegnati con payment, puoi vedere la quantità di query di tendenza visualizzando il tag payment.

Il grafico Carico database - Tag specifici mostra una misura delle il lavoro (in secondi CPU) che le query corrispondenti ai tag selezionati hanno eseguite nel database selezionato. Come per il grafico delle query totali, puoi filtrare il carico per un tag specifico in base a Database, Utente, e Indirizzo cliente.

Esaminare le operazioni in un piano di query campionato

Un piano di query prende un campione dei tuoi e la suddivide in singole operazioni. Illustra e analizza a ogni operazione nella query.

MySQL 5.7 fornisce un piano di query stimato con la vista EXPLAIN, mentre MySQL La versione 8.0 e le versioni successive forniscono un piano di query eseguito con la vista EXPLAIN ANALYZE. Stima di query fornisce il tempo di esecuzione stimato di una query, mentre un piano di query eseguito fornisce informazioni in tempo reale su ogni passaggio di esecuzione di una determinata query.

I piani di query in MySQL 5.7 sono supportati per le seguenti query supportate dall'istruzione EXPLAIN:

• Per le tabelle singole: INSERT, SELECT, UPDATE e DELETE.

• Per più tabelle: SELECT, UPDATE e DELETE.

Puoi generare piani di query in MySQL 8.0 e versioni successive per tutte le query supportate da EXPLAIN ANALYZE. Questo strumento mostra dove MySQL trascorre il tempo sulle query SELECT per tabelle singole e più tabelle. Cloud SQL supporta la generazione di piani di query DML (Data Manipulation Language) con più tabelle, poiché queste query non sono supportate da EXPLAIN ANALYZE.

Il piano di query di esempio fornisce una vista EXPLAIN ANALYZE per gli esempi di piani di query correlati alla query normalizzata. Si tratta di piani di query eseguiti che offrono un'analisi dettagliata del tempo attivo impiegato da ogni operazione nel piano di query.

Il grafico Esempi di piani di query mostra tutti i piani di query in esecuzione in una determinata e la quantità di tempo impiegata da ciascun piano. Puoi modificare la tariffa in quali esempi di piano di query vengono acquisiti al minuto. Consulta Attivare Query Insights.

Per impostazione predefinita, il riquadro a destra mostra i dettagli del piano di query di esempio che richiede più tempo, come visibile nel grafico Esempi di piani di query. Per visualizzare i dettagli di un altro piano di query di esempio, fai clic sul cerchio pertinente nel grafico. I dettagli espansi mostrano un modello di tutte le operazioni nel piano di query. Ogni operazione mostra la latenza, le righe restituite e il costo operativa. Quando selezioni un'operazione, puoi vedere ulteriori dettagli, ad esempio blocchi di hit condivisi, il tipo di schema, i loop e le righe del piano.

Prova a restringere il problema esaminando le seguenti domande:

1. Qual è il consumo delle risorse?
2. Qual è la relazione con altre query?
3. Il consumo cambia nel tempo?

Esamina la latenza

La latenza è il tempo impiegato per la generazione la query da completare, in tempo reale. Utilizzi il grafico Latenza per esaminare la latenza sulla query o sul tag. La dashboard della latenza mostra le metriche 50°, 95° e la latenza del 99° percentile per trovare i comportamenti anomali.

L'immagine seguente mostra il grafico di carico del database al 50° percentile per una query specifica con filtri selezionati per capacità della CPU, CPU e attesa CPU, Attesa IO e attesa blocco.

La latenza query parallele è sono misurate in tempo reale anche se il carico delle query può essere più elevato poiché vengono utilizzati più core per eseguire parte della query.

Prova a restringere il problema esaminando le seguenti domande:

1. Qual è la causa del carico elevato? Seleziona le opzioni per esaminare la CPU capacità, attesa CPU e CPU, attesa I/O o attesa blocco.
2. Quanto tempo è stato elevato? È solo alto ora? Oppure è stato alto per molto tempo? Modifica l'intervallo di tempo per trovare la data e l'ora in cui il caricamento ha iniziato a funzionare in modo scarso.
3. Si sono verificati picchi di latenza? Cambia l'intervallo di tempo per studiare la latenza storica per la query normalizzata.

Trace l'origine del problema

Quando trovi le aree e gli orari in cui il carico è stato più elevato, identifica l'origine del problema usando il tracciamento per andare più in dettaglio.

Per aiutarti a identificare l'origine specifica del problema, ad esempio una modello, vista, controller, route, host o utente, Query Insights fornisce visualizzazione della traccia dell'applicazione end-to-end nel contesto. Questa visualizzazione ti aiuta a comprendere cosa succede a livello di database per una richiesta specifica e per trovare l'origine di una query problematica per modello, vista, controller e route.

Se attivi OpenCensus o OpenTelemetry, le informazioni relative all'intervallo di Opencensus vengono inviate a nel database insieme alle informazioni sui tag nei commenti SQL. Qualsiasi traccia da dell'applicazione a Cloud Logging siano collegate alle tracce del piano di query del database per identificare l'origine del problema.

Fai clic sulla scheda End-to-end nella schermata Query di esempio per esaminare la traccia nel contesto.

Per determinare il client e l'utente che causa il problema, utilizza Indirizzi client principali e Utenti principali per trovare i caricamenti più elevati. Puoi aggiungere un utente o Indirizzo IP al filtro per analizzare ulteriormente l'indirizzo di un utente o di un client specifico. I dettagli nelle tabelle includono la percentuale del carico delle query, il valore medio tempo di esecuzione in millisecondi e i tempi chiamati.

Puoi utilizzare Cloud Trace per visualizzare il tracciamento end-to-end per ogni passaggio nel piano di query. Nella dashboard di Query Insights, fai clic su Visualizza nella traccia. per aprire lo strumento Cloud Trace. Il grafico delle tracce mostra tutte le tracce eseguiti per il periodo selezionato.

Per maggiori dettagli, vedi Trovare e visualizzare tracce.

Aggiungi tag alle query SQL

Il tagging delle query SQL semplifica la risoluzione dei problemi dell'applicazione. Puoi utilizzare sqlcommenter per aggiungere tag a Query SQL in modo automatico o manuale.

Utilizzare sqlcommenter con ORM

Quando utilizzi ORM anziché scrivere direttamente query SQL, potresti non trovare il codice dell'applicazione che causano problemi di prestazioni. Potresti anche avere problemi con l'analisi in che modo il codice dell'applicazione influisce sulle prestazioni delle query. Per affrontare questo problema, Insights fornisce una libreria open source chiamata sqlcommenter. Questo è utile per sviluppatori e amministratori che utilizzano gli strumenti ORM per rilevare quale codice dell'applicazione causa problemi di prestazioni.

Se usi ORM e sqlcommenter insieme, i tag vengono è stato creato. Non è necessario aggiungere o modificare il codice nell'applicazione.

Puoi installare sqlcommenter sul server delle applicazioni. La di strumentazione consente le informazioni sulle applicazioni relative alla tua MVC di propagarsi al database insieme alle query come SQL . Il database rileva questi tag e avvia la registrazione e l'aggregazione per tag, che sono ortogonali alle statistiche aggregate per le query normalizzate. Query Insights mostra i tag in modo che tu possa causa il carico della query e riesce a trovare il codice dell'applicazione che causa problemi di prestazioni.

Quando esamini i risultati nei log di database SQL, vengono visualizzati come segue:

SELECT * from USERS /*action='run+this',
controller='foo%3',
traceparent='00-01',
tracestate='rojo%2'*/

I tag supportati includono nome del controller, route, framework e azione.

Il set di strumenti ORM in sqlcommenter è supportato per i seguenti linguaggi di programmazione:

Python	Django psycopg2 Sqlalchimia Flask
Java	Letargo Primavera
Ruby	Binari
Node.js	Knex.js Sequelize.js Express.js

Per ulteriori informazioni su sqlcommenter e su come utilizzarlo nel tuo mapper ORM consulta la documentazione di sqlcommenter.

Usa sqlcommenter per aggiungere tag

Se non utilizzi il metodo ORM, devi aggiungere manualmente i tag o i commenti sqlcommenter nel formato dei commenti SQL corretto per la query SQL. Devi inoltre arricchire ogni istruzione SQL con un commento contenente una coppia chiave-valore serializzata. Utilizza almeno una delle seguenti chiavi:

• action=''
• controller=''
• framework=''
• route=''
• application=''
• db driver=''

Query Insights elimina tutte le altre chiavi.

Disabilita Query Insights

Console

Per disabilitare Query Insights per un'istanza Cloud SQL utilizzando la console Google Cloud, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
3. Nel riquadro Configurazione, fai clic su Modifica configurazione.
4. Nella sezione Opzioni di configurazione, espandi Approfondimenti sulle query.
5. Deseleziona la casella di controllo Attiva Query Insights.
6. Fai clic su Salva.

gcloud

Per disabilitare Query Insights per un'istanza Cloud SQL utilizzando gcloud, esegui gcloud sql instances patch con il flag --no-insights-config-query-insights-enabled come segue, dopo aver sostituito INSTANCE_ID con l'ID dell'istanza.

gcloud sql instances patch INSTANCE_ID \
--no-insights-config-query-insights-enabled
  

REST

Per disabilitare Query Insights per un'istanza Cloud SQL utilizzando il comando API REST, chiama instances.patch con queryInsightsEnabled impostato su false come segue.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• project-id: l'ID del progetto.
• instance-id: l'ID istanza.

Metodo HTTP e URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON della richiesta:

{
  "settings" : { "insightsConfig" : { "queryInsightsEnabled" : false } }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

PowerShell (Windows)

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2021-01-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Passaggi successivi

• Blog di lancio: Osservabilità del database per sviluppatori: introduzione agli insight di Cloud SQL

• Consulta le metriche di Google Cloud.

• Blog: Aumenta le tue competenze nella risoluzione dei problemi di prestazioni delle query con Cloud SQL Insights
• Video: Introduzione a Cloud SQL Insights
• Podcast: Approfondimenti di Cloud SQL
• Codelab sugli approfondimenti
• Blog: Introduzione a Sqlcommenter: una libreria di strumentazione automatica ORM open source
• Blog: Attivare il tagging delle query con Sqlcommenter