Questa pagina è stata tradotta dall'API Cloud Translation.

Utilizzare gli approfondimenti sulle query per migliorare le prestazioni delle query

MySQL | PostgreSQL | SQL Server

Questa pagina descrive come utilizzare la dashboard di Query Insights per rilevare e analizzare i problemi di prestazioni.

Puoi utilizzare l'assistenza di Gemini in Database per osservare e risolvere i problemi delle risorse Cloud SQL per MySQL. Per ulteriori informazioni, consulta Osservare e risolvere i problemi con l'assistenza di Gemini.

Introduzione

Query Insights consente di rilevare, diagnosticare e prevenire i problemi di prestazioni delle query per i database Cloud SQL. Supporta il monitoraggio intuitivo e fornisce informazioni diagnostiche che non si limitano al rilevamento per identificare la causa principale dei problemi di prestazioni.

Con gli approfondimenti sulle query, puoi monitorare il rendimento a livello di applicazione e risalire all'origine di una query problematica nello stack dell'applicazione in base a modello, vista, controller, route, utente e host. Lo strumento di approfondimenti sulle query può integrarsi con gli strumenti e i servizi di monitoraggio delle applicazioni (APM) esistenti Google Cloudutilizzando standard e API aperti. In questo modo, puoi monitorare e risolvere i problemi di query utilizzando il tuo strumento preferito.

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

Approfondimenti sulle query per la versione Enterprise Plus di Cloud SQL

Se utilizzi la versione Cloud SQL Enterprise Plus, puoi accedere a funzionalità aggiuntive in Query Insights per eseguire diagnostica avanzata delle prestazioni delle query. Oltre alle funzionalità standard della dashboard Query Insights, Query Insights per la versione Enterprise Plus di Cloud SQL ti consente di:

Filtra il carico aggregato del database in base a dimensioni aggiuntive come query, tag e altro ancora
Acquisisci i piani di query per tutte le query eseguite
Esempio di massimo 200 piani di query al minuto
Acquisisci testo di query più lungo fino a 1 MB
Ottenere aggiornamenti quasi in tempo reale per le metriche (nell'ordine di secondi)
Mantieni una conservazione più lunga delle metriche per 30 giorni

La tabella seguente mette a confronto i requisiti e le funzionalità di query insights per la versione Enterprise di Cloud SQL con quelli per la versione Enterprise Plus di Cloud SQL.

Area di confronto	Approfondimenti sulle query per la versione Enterprise di Cloud SQL	Approfondimenti sulle query per la versione Enterprise Plus di Cloud SQL
Versioni del database supportate	MySQL 5.7 o versioni successive	MySQL 8.0 o versioni successive
Tipi di macchine supportati	Supportato su tutti i tipi di macchine	Non supportato nelle istanze che utilizzano un tipo di macchina con core condivisi
Regioni supportate	Località regionali di Cloud SQL	Località regionali della versione Cloud SQL Enterprise Plus
Periodo di conservazione delle metriche	7 giorni	30 giorni
Lunghezza massima della query	4500 byte	1 MB
Massimo del campione del piano di query	20	200

Per attivare gli approfondimenti sulle query per la versione Cloud SQL Enterprise Plus durante la preview per la tua istanza Cloud SQL Enterprise Plus, segui i passaggi descritti in Attivare gli approfondimenti sulle query per la versione Cloud SQL Enterprise Plus.

Prezzi

Non sono previsti costi aggiuntivi per gli approfondimenti sulle query. Inoltre, non è previsto alcun costo per attivare gli approfondimenti sulle query per la versione Cloud SQL Enterprise Plus, che è in anteprima.

Requisiti di spazio di archiviazione

Query Insights per Cloud SQL Enterprise Edition non occupa spazio di archiviazione nello spazio di archiviazione dell'istanza Cloud SQL. Le metriche vengono archiviate in Cloud Monitoring. Per le richieste API, consulta Prezzi di Cloud Monitoring. Cloud Monitoring dispone di un livello che puoi utilizzare senza costi aggiuntivi.

Query insights per la versione Cloud SQL Enterprise Plus (anteprima) memorizza i dati delle metriche sullo stesso disco collegato alla tua istanza Cloud SQL e richiede di mantenere attiva l'impostazione degli aumenti automatici dello spazio di archiviazione.

Il requisito di spazio di archiviazione per sette giorni di dati è di circa 45 GB. Per 30 giorni sono necessari circa 180 GB. Query Insights per la versione Enterprise Plus di Cloud SQL utilizza fino a 130 MB di RAM. Le metriche dovrebbero essere disponibili negli approfondimenti sulle query entro un minuto dal completamento della query. Si applicano le tariffe di archiviazione applicabili.

Prima di iniziare

Prima di utilizzare gli approfondimenti sulle query, svolgi i seguenti passaggi.

Aggiungi i ruoli e le autorizzazioni richiesti.
Abilita l'API Cloud Trace.
Se utilizzi Query Insights per la versione Enterprise Plus di Cloud SQL, assicurati che l'opzione Abilita gli aumenti automatici dello spazio di archiviazione sia abilitata per l'istanza.

Ruoli e autorizzazioni richiesti

Per utilizzare gli approfondimenti sulle query, devi concedere i ruoli con le autorizzazioni di gestione di identità e accessi richieste o fornire un account utente con le autorizzazioni richieste.

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso.

Per ottenere le autorizzazioni necessarie per accedere ai dati storici di esecuzione delle query nella dashboard Approfondimenti sulle query, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto che ospita l'istanza Cloud SQL:

Database Insights monitoring viewer (roles/databaseinsights.monitoringViewer)
Cloud SQL Viewer (roles/cloudsql.viewer)

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per accedere ai dati storici di esecuzione delle query nella dashboard Approfondimenti sulle query. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per accedere ai dati storici di esecuzione delle query nella dashboard di Query Insights sono necessarie le seguenti autorizzazioni:

databaseinsights.aggregatedStats.query
databaseinsights.timeSeries.query

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

Ad esempio, in Database Insights puoi chiedere all'amministratore di concederti il ruolo predefinito Database Insights Viewer (roles/databaseinsights.viewer). In Cloud SQL, puoi chiedere all'amministratore di concederti uno dei seguenti ruoli predefiniti:

Cloud SQL Editor (roles/cloudsql.editor)
Amministratore Cloud SQL (roles/cloudsql.admin)

Abilita l'API Trace

Per visualizzare i piani di query e le relative visualizzazioni end-to-end, nel Google Cloud progetto deve essere attivata l'API Trace. Questa impostazione consente al tuo Google Cloud progetto di ricevere dati di traccia da origini autenticate senza alcun costo aggiuntivo. Questi dati possono aiutarti a rilevare e diagnosticare problemi di prestazioni nella tua istanza.

Per verificare che l'API Trace sia abilitata:

Nella console Google Cloud, vai ad API e servizi:
Vai ad API e servizi
Fai clic su Abilita API e servizi.
Nella barra di ricerca, inserisci Trace API.
Se viene visualizzato il messaggio API abilitata, significa che l'API è abilitata e non devi fare altro. In caso contrario, fai clic su Abilita.

Abilita aumenti automatici dello spazio di archiviazione

Se utilizzi Approfondimenti sulle query per la versione Enterprise Plus di Cloud SQL (anteprima), assicurati che l'impostazione dell'istanza per abilitare gli aumenti automatici dello spazio di archiviazione rimanga attivata. Per impostazione predefinita, questa opzione è attivata per le istanze Cloud SQL.

Se in precedenza hai disattivato questa impostazione dell'istanza e vuoi attivare gli Approfondimenti sulle query per la versione Cloud SQL Enterprise Plus, riattiva prima gli aumenti automatici dello spazio di archiviazione. Non puoi disattivare gli aumenti automatici dello spazio di archiviazione e attivare Query Insights per la versione Cloud SQL Enterprise Plus.

Abilita Query Insights

Gli utenti che hanno accesso alla dashboard di Cloud SQL possono accedere alle metriche di Query Insights. Se disponi dell'autorizzazione per aggiornare le istanze, puoi attivare gli approfondimenti sulle query. Per un elenco delle autorizzazioni richieste per le istanze Cloud SQL, consulta Controllo dell'accesso ai progetti Cloud SQL. Se non disponi di queste autorizzazioni e vuoi attivare gli approfondimenti sulle query nelle tue istanza, contatta l'amministratore.

Console

Abilitare Query Insights per un'istanza

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

Vai a Istanze Cloud SQL
Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
Nel riquadro Configurazione, fai clic su Modifica configurazione.
Nella sezione Personalizza la tua istanza, espandi Approfondimenti sulle query.
Seleziona la casella di controllo Attiva Query Insights.
Facoltativo. Seleziona una o più delle seguenti funzionalità aggiuntive degli insight sulle query:

Analisi delle query attive

Valore predefinito: false

Ti consente di esaminare i dettagli delle query in esecuzione e, se necessario, di terminare le query in esecuzione da molto tempo. Per ulteriori informazioni, consulta Monitorare le query attive. Questa funzionalità è in Anteprima.

Attivare i suggerimenti sull'indicizzazione

Valore predefinito: false

Il consulente per gli indici fornisce suggerimenti per gli indici per velocizzare l'elaborazione delle query. Quando attivi i suggerimenti sull'indicizzazione, l'istanza richiede un riavvio. Per ulteriori informazioni, consulta la Panoramica di Strumento per la consulenza sull'indice e l'articolo Utilizzare Strumento per la consulenza sull'indice. Questa funzionalità è in Anteprima.

Archivia gli indirizzi IP client

Valore predefinito: false

Memorizza gli indirizzi IP dei client da cui provengono le query e ti aiuta a raggruppare questi dati per generare le metriche corrispondenti. Le query provengono da più host. La revisione dei grafici per le query provenienti dagli indirizzi IP dei client può aiutarti a identificare la fonte di un problema.

Archivia i tag delle applicazioni

Valore predefinito: false

Memorizza i tag delle applicazioni che ti aiutano a determinare le API e i route modello-visualizzazione-controller (MVC) che effettuano richieste e raggruppa i dati su cui eseguire le metriche. Questa opzione richiede di commentare le query con un insieme specifico di tag utilizzando la libreria di automisurazione ORM (Object-Relational Mapping) open source sqlcommenter. Queste informazioni aiutano Query Insights a identificare la fonte di un problema e l'MVC da cui proviene. I percorsi delle applicazioni ti aiutano con il monitoraggio delle applicazioni.

Personalizzare la lunghezza delle query

Valore predefinito: 1024

Imposta il limite di lunghezza della query su un valore specificato compreso tra 256 e 4500 byte. Le query con una lunghezza maggiore sono più utili per le query analitiche, ma richiedono anche più memoria. La modifica della dimensione delle query 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 acquisiti al minuto in tutti i database dell'istanza. Modifica questo valore scegliendo un numero compreso tra 0 (se impostato su 0, il campionamento viene disattivato) e 20. È probabile che l'aumento della frequenza di campionamento fornisca più punti dati, ma potrebbe aumentare il sovraccarico delle prestazioni.

Fai clic su Salva.

Abilita Query Insights per più istanze

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

Vai a Istanze Cloud SQL
Fai clic sul menu Altre azioni in qualsiasi riga.
Seleziona Attiva Query Insights.
Nella finestra di dialogo, seleziona la casella di controllo Abilita Query Insights per più istanze.
Fai clic su Abilita.
Nella finestra di dialogo successiva, seleziona le istanze per cui vuoi attivare Query Insights.
Fai clic su Attiva Query Insights.
Nota: questo passaggio attiva gli approfondimenti sulle query nelle tue istanze in base alla configurazione predefinita.

gcloud

Per attivare gli approfondimenti sulle query 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

Utilizza anche uno o più dei seguenti flag facoltativi:

--insights-config-record-client-address

Memorizza gli indirizzi IP dei client da cui provengono le query e ti aiuta a raggruppare questi dati per generare le metriche corrispondenti. Le query provengono da più di un host. La revisione dei grafici per le query provenienti dagli indirizzi IP dei client può aiutarti a identificare la causa di un problema.
--insights-config-record-application-tags

Memorizza i tag delle applicazioni che ti aiutano a determinare le API e i route modello-visualizzazione-controller (MVC) che effettuano richieste e raggruppa i dati per eseguire le metriche su di essi. Questa opzione richiede di aggiungere commenti alle query con un insieme specifico di tag. Puoi farlo utilizzando la libreria di automazione dell'analisi di mappatura relazionale degli oggetti (ORM) open source sqlcommenter. Queste informazioni aiutano Query Insights a identificare la fonte di un problema e l'MVC da cui proviene. I percorsi delle applicazioni ti aiutano con il monitoraggio delle applicazioni.
--insights-config-query-string-length

Imposta il limite predefinito per la lunghezza delle query su un valore specificato compreso tra 256 e 4500 byte. La lunghezza predefinita delle query è 1024 byte. Le query con una lunghezza maggiore sono più utili per le query di analisi, ma richiedono anche più memoria. Per modificare la lunghezza delle query, devi riavviare l'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 cinque campioni di piano di query eseguiti al minuto su tutti i database dell'istanza. Modifica questo valore scegliendo un numero compreso tra 0 (se imposti questo valore, il campionamento viene disattivato) e 20. È probabile che l'aumento della frequenza di campionamento fornisca più punti dati, ma potrebbe incrementare il sovraccarico delle prestazioni.

Sostituisci quanto segue:

INSIGHTS_CONFIG_QUERY_STRING_LENGTH: la lunghezza della stringa di query da memorizzare in byte.
API_TIER_STRING: la configurazione dell'istanza personalizzata da utilizzare per l'istanza.
REGION: la regione dell'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 attivare gli approfondimenti sulle query per un'istanza Cloud SQL utilizzando l'API REST, chiama il metodo instances.patch con le impostazioni insightsConfig.

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

project-id: l'ID 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 di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'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, quindi esegui il comando seguente:

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 alla CLI 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, quindi esegui il comando seguente:

$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": "user@example.com",
  "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 attivare Query Insights per un'istanza Cloud SQL, imposta il flag query_insights_enabled su true.

Inoltre, puoi utilizzare uno o più dei seguenti flag facoltativi:

query_string_length: il valore predefinito è 1024 e puoi impostarlo su un valore compreso tra 256 e 4500 in byte.
record_application_tags: imposta il valore su true se vuoi registrare i tag delle applicazioni 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 impostarlo su 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 in un progetto Google Cloud, completa i passaggi nelle seguenti sezioni.

Prepara Cloud Shell

Avvia Cloud Shell.
Imposta il progetto Google Cloud predefinito in cui vuoi applicare le configurazioni Terraform.

Devi eseguire questo comando una sola volta per progetto e puoi farlo in qualsiasi directory.
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.

Prepara la directory

Ogni file di configurazione di Terraform deve avere una propria directory (chiamata anche modulo principale).

In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file è denominato main.tf.
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

Copia il codice campione nel main.tf appena creato.

Se vuoi, copia il codice da GitHub. Questa opzione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.
Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
Salva le modifiche.
Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory.
```
terraform init
```
Se vuoi, per utilizzare la versione più recente del provider Google, includi l'opzione -upgrade:
```
terraform init -upgrade
```

Applica le modifiche

Rivedi la configurazione e verifica che le risorse che Terraform sta per creare o aggiornare corrispondano alle tue aspettative:
```
terraform plan
```
Apporta le correzioni necessarie alla configurazione.
Applica la configurazione di Terraform eseguendo il seguente comando e inserendo yes al prompt:
```
terraform apply
```
Attendi che Terraform mostri il messaggio "Applicazione completata".
Apri il tuo progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

Le metriche dovrebbero essere disponibili negli approfondimenti sulle query entro pochi minuti dal completamento della query. Esamina i criteri di conservazione dei dati Cloud Monitoring.

Le tracce degli approfondimenti delle query vengono archiviate in Cloud Trace. Leggi le norme relative alla conservazione dei dati di Cloud Trace.

Attivare gli approfondimenti sulle query per la versione Cloud SQL Enterprise Plus

Puoi attivare gli approfondimenti sulle query per la versione Cloud SQL Enterprise Plus sulla tua istanza Cloud SQL solo utilizzando la console Google Cloud.

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

Vai a Istanze Cloud SQL
Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
Fai clic su Modifica.
Nella sezione Spazio di archiviazione, verifica che sia selezionata la casella di controllo Abilita aumenti automatici dello spazio di archiviazione.
Nella sezione Personalizza la tua istanza, espandi Approfondimenti sulle query.
Seleziona la casella di controllo Attiva le funzionalità di Enterprise Plus.
Dopo aver attivato gli approfondimenti sulle query per la versione Enterprise Plus di Cloud SQL, puoi aggiornare i seguenti campi:
- Personalizza la lunghezza delle query: specifica il limite, in byte, della lunghezza della query. Puoi specificare un numero da 1 a 1048576. Qualsiasi stringa di query che superi il limite specificato viene troncata nella visualizzazione. Un limite di lunghezza della query più elevato richiede più memoria. Il valore predefinito è 1024 byte (1 KB).
- Imposta la frequenza di campionamento massima: puoi impostare la frequenza di campionamento massima delle query in base al carico del database. Per impostazione predefinita, la frequenza di campionamento massima è impostata su 5 esempi di piano di query al minuto in tutti i database dell'istanza. Puoi aumentare il valore massimo a 200 per fornire più punti dati. Tuttavia, l'aumento del numero potrebbe anche aumentare il carico del database.
Fai clic su Salva.

Visualizzare la dashboard Query Insights

La dashboard Approfondimenti sulle query mostra il carico delle query in base ai fattori selezionati. Il carico delle query è una misura del lavoro totale per tutte le query nell'istanza nell'intervallo di tempo selezionato. La dashboard fornisce una serie di filtri che ti aiutano a visualizzare il carico delle query.

Per aprire la dashboard Approfondimenti sulle query:

Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
Seleziona la scheda Query Insight nel pannello di navigazione a sinistra o fai clic sul link Vai a Query Insight per informazioni più approfondite su query e prestazioni.

Si apre la dashboard Approfondimenti sulle query. Mostra le seguenti informazioni sulla tua istanza:

Mostra la dashboard Approfondimenti sulle query, con menu a discesa per database, utenti e indirizzi. A destra dei menu a discesa, c'è un filtro per impostare un intervallo di tempo. Inoltre,
un grafico mostra il carico del database per le query principali. Nella parte inferiore
del grafico sono presenti caselle di selezione per capacità della CPU, CPU e
attesa CPU, attesa I/O e attesa blocco e una scheda per query e tag.

Database: filtra il carico delle query su un database specifico o su tutti i database.
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 1 ora, 6 ore, 1 giorno, 7 giorni, 30 giorni o un intervallo personalizzato.
Grafico del carico del database: mostra il grafico del carico delle query in base ai dati filtrati.
Capacità CPU, CPU e attesa CPU, attesa IO e attesa blocco: filtra i carichi in base alle opzioni selezionate. Per informazioni dettagliate su ciascuno di questi filtri, consulta Visualizzare il carico del database per le query principali.
Query e Tag: filtra il carico delle query in base a una query selezionata o a un tag di query SQL selezionato. Consulta Filtrare il carico del database.

Visualizza il carico del database per tutte le query

Il carico delle query del database è una misura del lavoro (in secondi CPU) nel tempo per le query eseguite nel database selezionato. Ogni query in esecuzione utilizza o è in attesa di risorse CPU, risorse I/O o risorse di blocco. Il carico delle query del database è il rapporto tra il tempo impiegato da tutte le query completate in un determinato intervallo di tempo e le ore effettive.

La dashboard degli approfondimenti sulle query di primo livello mostra il grafico Carico del database: tutte le query principali. I menu a discesa nella dashboard ti consentono di filtrare il grafico in base a un database, un utente o un indirizzo client specifico.

Mostra il grafico del carico del database con un carico per la capacità della CPU, la CPU e
l'attesa della CPU, l'attesa I/O e l'attesa del blocco.

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

Capacità CPU: il numero di CPU disponibili nell'istanza.
CPU e attesa CPU: il rapporto tra il tempo impiegato dalle query in stato attivo e le ore effettive. Le attese I/O e di blocco non bloccano le query in stato attivo. Questa metrica potrebbe indicare che la query utilizza la CPU o è in attesa che lo scheduler di Linux pianifichi il processo del server che esegue la query mentre altri processi utilizzano la CPU.

Attesa I/O: il rapporto tra il tempo impiegato dalle query in attesa di I/O e le ore effettive. L'attesa I/O include attesa di lettura I/O e attesa di scrittura I/O. Se vuoi una suddivisione delle informazioni sulle attese IO, puoi visualizzarla in Cloud Monitoring. Per ulteriori informazioni, consulta le metriche Cloud SQL.
Attesa blocco: il rapporto tra il tempo impiegato dalle query in attesa di blocchi e le ore effettive. Include le attese per blocchi di tipo Lock, LwLock e BufferPin Lock. Per visualizzare una suddivisione delle informazioni relative alle attese dei blocchi, utilizza Cloud Monitoring. Per ulteriori informazioni, consulta le metriche Cloud SQL.

Le linee colorate nel grafico mostrano il carico del database per tempo di esecuzione. Esamina il grafico e utilizza le opzioni di filtro per rispondere a queste domande:

Il carico delle query è elevato? Il grafico presenta picchi o è elevato nel tempo? Se non noti un carico elevato, il problema non riguarda la query.
Da quanto tempo il carico è elevato? È alto solo ora o lo è da molto tempo? Utilizza il selettore di intervalli per selezionare vari periodi di tempo per scoprire da quanto tempo si verifica il problema. Aumenta lo zoom per visualizzare una finestra temporale in cui vengono osservati picchi di carico delle query. Riduci lo zoom per visualizzare fino a una settimana della cronologia.
Qual è la causa del carico elevato? Puoi selezionare le opzioni per esaminare la capacità della CPU, la CPU e l'attesa della CPU, l'attesa del blocco o l'attesa IO. Il grafico di ciascuna di queste opzioni è di un colore diverso, in modo da individuare quella con il carico più elevato. La linea blu scuro sul grafico mostra la capacità massima della CPU del sistema. Ti consente di confrontare il carico delle query con la capacità massima del sistema CPU. Questo confronto ti aiuta a determinare se un'istanza sta esaurendo le risorse della CPU.
Quale database sta riscontrando il carico? Seleziona diversi database dal menu a discesa Database per trovare quelli con i carichi più elevati.
Utenti o indirizzi IP specifici causano carichi più elevati? Seleziona utenti e indirizzi diversi dai menu a discesa per identificare quelli che causano carichi più elevati.

Filtrare il carico del database

Puoi filtrare il carico del database per query o tag. Se utilizzi gli approfondimenti delle query per la versione Enterprise Plus di Cloud SQL, puoi personalizzare il grafico del carico del database per suddividere i dati visualizzati utilizzando una delle seguenti dimensioni:

Tutte le query

Database
Utenti
Tag
Indirizzi client

Per personalizzare il grafico del carico del database, seleziona una dimensione dal menu a discesa Carico database per tempo di esecuzione.

Visualizza i principali fattori che contribuiscono al carico del database

Per visualizzare i principali fattori che contribuiscono al carico del database, puoi utilizzare la tabella Dimensioni principali per carico del database. La tabella Principali dimensioni per carico del database mostra i principali fattori di contributo per il periodo di tempo e la dimensione selezionati nel menu a discesa del grafico Carico del database per tempo di esecuzione. Puoi modificare il periodo di tempo o la dimensione per visualizzare i principali contributor per una dimensione o un periodo di tempo diverso.

Nella tabella Principali dimensioni per carico di dati, puoi selezionare le seguenti schede.

TAB	Descrizione
Query	La tabella mostra le query normalizzate principali per tempo di esecuzione totale. Per ogni query, i dati mostrati nelle colonne sono elencati come segue: Tempo di esecuzione medio (ms): tempo medio di esecuzione della query. Tempo di esecuzione totale (ms): il tempo di esecuzione totale impiegato dalla query specifica. Riga media restituita: il numero medio di righe recuperate per la query. Numero di chiamate: il numero di volte in cui la query è stata chiamata dall'applicazione. %di carica per `SELECTED_DIMENSION`: il grafico a linee percentuale rappresenta la distribuzione della dimensione selezionata per la query specifica.
Database	La tabella mostra l'elenco dei principali database che hanno contribuito al caricamento durante il periodo di tempo scelto in tutte le query eseguite. Tempo medio trascorso nel database (ms): tempo medio impiegato dalle query nel database specifico. Tempo totale trascorso nel database (ms): il tempo di esecuzione totale impiegato dalle query nel database specifico. %di carico per `SELECTED_DIMENSION`: il grafico a linee percentuale rappresenta la distribuzione della dimensione selezionata per il grafico del carico del database nel database specifico.
Users (Utenti)	La tabella mostra l'elenco dei principali utenti per il periodo di tempo selezionato in tutte le query eseguite. Tempo medio trascorso nell'utente (ms): tempo medio impiegato dalle query per l'utente specifico. Tempo totale trascorso nell'utente (ms): il tempo di esecuzione totale delle query nell'utente specifico. %di carico per `SELECTED_DIMENSION`: il grafico a linee percentuale rappresenta la distribuzione della dimensione selezionata per il grafico del carico del database tra gli utenti specifici.
Tag	Per informazioni sui tag, Filtra per tag query.
Indirizzi client	La tabella mostra l'elenco dei principali utenti per il periodo di tempo selezionato in tutte le query eseguite. Tempo totale trascorso nell'indirizzo client (ms): il tempo di esecuzione totale impiegato dalle query per un client specifico. %carico per `SELECTED_DIMENSION`: il grafico a linee percentuale rappresenta la distribuzione della dimensione selezionata per il grafico del carico del database nel cliente specifico.

Filtra per query

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

Mostra il grafico del carico del database con un carico per le query, con
filtri selezionati per capacità della CPU, CPU e
attesa CPU, attesa I/O e attesa blocco.

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. Per impostazione predefinita, gli Approfondimenti sulle query mostrano solo 1024 caratteri nella stringa di query. Le query etichettate come UTILITY COMMAND in genere includono comandi o comandi wrapper BEGIN, COMMIT e EXPLAIN.
Database: il database su cui è stata eseguita la query.
Carico per tempo totale/Carico per CPU/Carico per attesa IO/Carico per attesa blocco: le opzioni che ti consentono di filtrare query specifiche per trovare il carico maggiore.
% di carico per query: la percentuale di carico per singola query.
Tempo di esecuzione medio (ms): il tempo medio di esecuzione della query.
Numero di chiamate: il numero di volte in cui l'applicazione ha chiamato la query.
Numero medio di righe restituite: il numero medio di righe restituite per la query.
Media righe scansionate: il numero medio di righe scansionate per la query.

La sezione Approfondimenti sulle query memorizza e mostra solo le query normalizzate.

Per impostazione predefinita, gli approfondimenti sulle query non raccolgono indirizzi IP o informazioni sui tag. Puoi attivare gli approfondimenti sulle query per raccogliere queste informazioni e, se necessario, disattivarne la raccolta.

Le tracce del piano di query non raccolgono né memorizzano valori costanti e rimuovono eventuali informazioni PII che la costante potrebbe mostrare.

Le statistiche sulle query mostrano le query normalizzate, ovvero ? sostituisce il valore costante letterale. Nell'esempio seguente, la costante del nome viene rimossa e sostituita da ?.

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

Filtra per tag query

Per risolvere i problemi di un'applicazione, devi prima aggiungere tag alle query SQL. I tag di carico delle query forniscono un'analisi dettagliata del carico delle query del tag selezionato nel tempo.

Query Insights fornisce un monitoraggio incentrato sulle applicazioni per diagnosticare i problemi di prestazioni delle applicazioni create utilizzando gli ORM. Se sei responsabile dell'intero stack di applicazioni, Query Insights fornisce il monitoraggio delle query da una visualizzazione dell'applicazione. Il tagging delle query ti aiuta a trovare problemi a livello di strutture di livello superiore, ad esempio con la logica di business o un microservizio.

Potresti taggare le query in base alla logica aziendale, ad esempio i tag di pagamento, l'inventario, le analisi aziendali o la spedizione. Puoi quindi trovare il carico delle query creato dalle varie logiche di business. Ad esempio, potresti osservare eventi inaspettati, come picchi per un tag di analisi aziendale alle 13:00 o una crescita inaspettata per un servizio di pagamento di tendenza nella settimana precedente.

Per calcolare il carico del database per tag, gli approfondimenti sulle query utilizzano il tempo impiegato da ogni query che utilizza il tag selezionato. Lo strumento calcola il tempo di completamento al confine dei minuti utilizzando il tempo reale.

Nella dashboard degli approfondimenti sulle query, seleziona Tag per visualizzare la tabella dei tag. La tabella ordina i tag in base al carico totale per tempo totale.

Mostra la dashboard Approfondimenti sulle query, con il carico per i tag e un elenco di tag.

Puoi ordinare la tabella selezionando una proprietà da Tag filtro o facendo clic su un'intestazione di colonna. La tabella mostra le seguenti proprietà:

Azione, Controller, Framework, Route, Application, DB driver: ogni proprietà aggiunta alle query viene visualizzata come colonna. Se vuoi filtrare in base ai tag, devi aggiungere almeno una di queste proprietà.
Carico per tempo totale/Carico per CPU/Carico per attesa IO/Carico per attesa blocco: opzioni per filtrare query specifiche al fine di trovare il carico maggiore per ogni opzione.
Tempo di esecuzione medio (ms): il tempo medio di esecuzione della query.
Numero medio di righe restituite: il numero medio di righe restituite per la query.
Media righe scansionate: il numero medio di righe scansionate per la query.
Numero di chiamate: il numero di volte in cui l'applicazione ha chiamato la query.
Database: il database su cui è stata eseguita la query.

Esaminare una query o un tag specifico

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

Per ordinare l'elenco in ordine decrescente, fai clic sull'intestazione Carica per tempo totale.
Fai clic sulla query o sul tag nella parte superiore dell'elenco. Ha il carico più elevato e richiede più tempo rispetto alle altre.

Si apre una dashboard che mostra i dettagli della query o del tag selezionato.

Esaminare un carico delle query specifico

La dashboard per una query selezionata viene visualizzata come segue:

Mostra i grafici di carico e latenza del database per una
query specifica.

Il grafico Carico del database - query specifica mostra una misura del lavoro (in secondi CPU) nel tempo per la query normalizzata selezionata nella query selezionata. Per calcolare il carico, viene utilizzato il tempo impiegato dalle query normalizzate completate al confine del minuto rispetto al tempo effettivo. Nella parte superiore della tabella vengono visualizzati i primi 1024 caratteri della query normalizzata, con i valori letterali rimossi per motivi di aggregazione e PII.

Mostra il grafico del carico del database con un carico per una query specifica, con
filtri selezionati per capacità della CPU, CPU e attesa CPU, attesa IO e attesa
blocco.

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 capacità della CPU, CPU e attesa 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 di un pagamento di microservizi sono contrassegnate come payment, puoi vedere la quantità di query di tendenza visualizzando il tag payment.

Mostra i grafici relativi al carico e alla latenza del database nella pagina per un
tag specifico.

Il grafico Carico del database: tag specifici mostra una misura del lavoro (in secondi CPU) che le query corrispondenti ai tag selezionati hanno eseguito nel tempo all'interno del database selezionato. Come per il grafico delle query totali, puoi filtrare il carico per un tag specifico in base a Database, Utente e Indirizzo client.

Esaminare le operazioni in un piano di query campionato

Un piano di query prende un esempio di query e la suddivide in singole operazioni. Spiega e analizza ogni operazione nella query.

MySQL 5.7 fornisce un piano di query stimato con la vista EXPLAIN, mentre MySQL 8.0 e le versioni successive forniscono un piano di query eseguito con la vista EXPLAIN ANALYZE. Un piano di query stimato 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 singole tabelle: INSERT, SELECT, UPDATE e DELETE.
Per più tabelle: SELECT, UPDATE ed 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 impiega tempo per le query SELECT per singole tabelle e più tabelle. Cloud SQL non supporta la generazione di piani di query DML (Data Manipulation Language) con più tabelle perché queste query non sono supportate da EXPLAIN ANALYZE.

Il piano di query di esempio fornisce una visualizzazione EXPLAIN ANALYZE per i campioni del piano di query correlati alla query normalizzata. Si tratta di piani di query eseguiti che forniscono un'analisi dettagliata del tempo attivo impiegato da ogni operazione nel piano di query.

Il grafico Sample dei piani di query mostra tutti i piani di query in esecuzione in determinati momenti e il tempo necessario per l'esecuzione di ciascun piano. Puoi modificare la frequenza con cui vengono acquisiti i campioni di piano di query al minuto. Consulta Attivare Query Insights.

Un grafico per i piani di query di esempio, con il momento in cui sono stati eseguiti nella parte inferiore del grafico (asse x) e il numero di secondi di esecuzione a destra (asse y).

Per impostazione predefinita, il riquadro a destra mostra i dettagli del piano di query di esempio che richiede più tempo, come mostrato nel grafico Campioni di piano di query. Per visualizzare i dettagli di un altro piano di query di esempio, fai clic sul cerchio pertinente sul 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 dell'operazione. Quando selezioni un'operazione, puoi visualizzare ulteriori dettagli, ad esempio i blocchi di hit condivisi, il tipo di schema, i loop e le righe del piano.

Il piano di query mostra la latenza e il costo per ogni operazione eseguita per la query. Inizia con un aggregato che restituisce 48 righe, con una latenza di 31,06 ms e un costo di 296,34. L'operazione successiva è
un ciclo nidificato, che si suddivide in un altro ciclo nidificato e un materialize.
Il ciclo nidificato si suddivide in un altro ciclo nidificato e in una scansione dell'indice. La
materializzazione genera una scansione della sequenza.

Prova a restringere il problema esaminando le seguenti domande:

Qual è il consumo di risorse?
Qual è la sua relazione con altre query?
Il consumo cambia nel tempo?

Esamina la latenza

La latenza è il tempo impiegato dalla query normalizzata per il completamento nelle ora effettive. Utilizza il grafico Latenza per esaminare la latenza della query o del tag. La dashboard della latenza mostra le latenze al 50°, 95° e 99° percentile per trovare comportamenti anomali.

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

Mostra il grafico della latenza delle query per una query specifica con i filtri selezionati per capacità della CPU, CPU e attesa CPU, attesa I/O e attesa blocco.

La latenza delle query parallele si misura nelle ore effettive, anche se il carico delle query può essere superiore per la query a causa dell'utilizzo di più core per l'esecuzione di parte della query.

Prova a restringere il problema esaminando le seguenti domande:

Qual è la causa del carico elevato? Seleziona le opzioni per esaminare la capacità della CPU, la CPU e l'attesa CPU, l'attesa I/O o l'attesa blocco.
Da quanto tempo il carico è elevato? È alto solo ora? Oppure è alto da molto tempo? Modifica l'intervallo di tempo per trovare la data e l'ora in cui il caricamento ha iniziato a funzionare in modo insoddisfacente.
Ci sono stati picchi di latenza? Modifica la finestra temporale per studiare la latenza storica per la query normalizzata.

Trace la fonte del problema

Quando trovi le aree e i momenti in cui il carico è stato più elevato, identifica la fonte del problema utilizzando il monitoraggio per visualizzare ulteriori dettagli.

Per aiutarti a identificare la fonte specifica del problema, ad esempio un modello, una vista, un controller, una route, un host o un utente, gli approfondimenti sulle query forniscono una visualizzazione della traccia dell'applicazione end-to-end in contesto. Questa visualizzazione ti aiuta a capire cosa succede nel livello del database per una richiesta specifica e a trovare l'origine di una query problematica in base a modello, visualizzazione, controller e route.

Se attivi OpenCensus o OpenTelemetry, le informazioni su opencensus span vengono inviate al database insieme alle informazioni sui tag all'interno dei commenti SQL. Eventuali tracce dall'applicazione a Cloud Logging sono collegate alle tracce del piano di query del database per contribuire a identificare l'origine del problema.

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

Seleziona un tag end-to-end per visualizzare informazioni specifiche sul tag. Il riepilogo mostra le chiamate RPC e la durata totale in ms per
ogni operazione per quel tag.

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

L'immagine mostra che per i principali indirizzi client il carico era
100%, il tempo di esecuzione medio era 19.568 secondi e il numero di volte
chiamate era 1.226. Per gli utenti principali, l'utente postgres ha avuto il 100% del carico,
un tempo di esecuzione medio di 19.568 ms ed è stato chiamato 1.226
volte.

Puoi utilizzare Cloud Trace per visualizzare il monitoraggio end-to-end per ogni passaggio del piano di query. Nella dashboard degli approfondimenti sulle query, fai clic sul link Visualizza nel tracciato per aprire lo strumento Cloud Trace. Il grafico delle tracce mostra tutte le tracce che sono state eseguite per il periodo selezionato.

Il grafico delle tracce mostra tutte le tracce eseguite per il periodo selezionato, in questo caso un'ora. La pagina contiene anche una tabella che mostra la latenza, il metodo HTTP, l'URL e l'ora in cui è stata eseguita la traccia.

Per maggiori dettagli, vedi Trovare e visualizzare le tracce.

Aggiungere tag alle query SQL

Il tagging delle query SQL semplifica la risoluzione dei problemi relativi alle applicazioni. Puoi utilizzare sqlcommenter per aggiungere tag alle query SQL automaticamente o manualmente.

Utilizzare sqlcommenter con ORM

Quando utilizzi ORM instead of directly writing SQL queries, potresti non trovare il codice dell'applicazione che causa problemi di prestazioni. Potresti anche riscontrare difficoltà ad analizzare in che modo il codice dell'applicazione influisce sulle prestazioni delle query. Per risolvere il problema, Query Insights fornisce una libreria open source chiamata sqlcommenter. Questa biblioteca è utile per gli sviluppatori e gli amministratori che utilizzano gli strumenti ORM per rilevare il codice dell'applicazione che causa problemi di prestazioni.

Se utilizzi ORM e sqlcommenter insieme, i tag vengono creati automaticamente. Non è necessario aggiungere o modificare il codice nell'applicazione.

Puoi installare sqlcommenter sul server delle applicazioni. La libreria di instrumentazione consente di propagare le informazioni dell'applicazione relative al framework MVC al database insieme alle query come commento SQL. Il database rileva questi tag e inizia a registrare e aggregare le statistiche per tag, che sono ortogonali alle statistiche aggregate per query normalizzate. Query Insights mostra i tag in modo che tu sappia quale applicazione sta causando il carico delle query e possa trovare il codice dell'applicazione che sta causando problemi di prestazioni.

Quando esamini i risultati nei log del 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 il nome del controller, il percorso, il framework e l'azione.

L'insieme di strumenti ORM in sqlcommenter è supportato per i seguenti linguaggi di programmazione:

Python	Django psycopg2 Sqlalchemy Flask
Java	Hibernate Spring
Ruby	Rails
Node.js	Knex.js Sequelize.js Express.js

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

Utilizzare sqlcommenter per aggiungere tag

Se non utilizzi ORM, devi aggiungere manualmente i tag o i commenti sqlcommenter nel corretto formato dei commenti SQL alla query SQL. Devi anche integrare 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=''

Gli Approfondimenti delle query eliminano tutte le altre chiavi.

Disattivare Query Insights

Console

Per disattivare gli approfondimenti sulle query per un'istanza Cloud SQL utilizzando la console Google Cloud, segui questi passaggi:

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

Vai a Istanze Cloud SQL
Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
Nel riquadro Configurazione, fai clic su Modifica configurazione.
Nella sezione Opzioni di configurazione, espandi Approfondimenti sulle query.
Deseleziona la casella di controllo Abilita Query Insights.
Fai clic su Salva.

gcloud

Per disattivare gli approfondimenti sulle query 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 disattivare gli approfondimenti sulle query per un'istanza Cloud SQL utilizzando l'API REST, chiama il metodo instances.patch con queryInsightsEnabled impostato su false come segue.

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

project-id: l'ID 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 di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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": "user@example.com",
  "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"
}

Disattivare gli approfondimenti sulle query per la versione Cloud SQL Enterprise Plus

Per disattivare gli approfondimenti sulle query per la versione Enterprise Plus di Cloud SQL, segui questi passaggi:

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

Vai a Istanze Cloud SQL
Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
Fai clic su Modifica.
Nella sezione Personalizza la tua istanza, espandi Approfondimenti sulle query.
Deseleziona la casella di controllo Abilita le funzionalità di Enterprise Plus.
Fai clic su Salva.

Passaggi successivi

Blog di lancio: Osservabilità del database per gli sviluppatori: presentazione di Cloud SQL Insights
Consulta le Google Cloud metriche.
Blog: Migliora le tue competenze di risoluzione dei problemi relativi alle prestazioni delle query con Cloud SQL Insights
Video: Introduzione a Cloud SQL Insights
Podcast: Cloud SQL Insights
Codelab di Approfondimenti
Post del blog: Introduzione a Sqlcommenter: una libreria di automazione dell'ORM open source
Blog: Attivare il tagging delle query con Sqlcommenter