Configurare l'acquisizione delle prestazioni

Acquisizione delle prestazioni ti consente di diagnosticare problemi temporanei con il tuo database acquisendo metriche dettagliate per la tua istanza quando le prestazioni sono ridotte. Per utilizzare l'acquisizione delle prestazioni, abilita l'acquisizione delle prestazioni per la tua istanza e configura le soglie che attivano gli snapshot dettagliati basati sulle metriche della tua istanza Cloud SQL.

Linee guida per la configurazione dei trigger di acquisizione delle prestazioni

Tieni presente le seguenti linee guida quando configuri i trigger per l'acquisizione delle prestazioni.

  • I seguenti trigger di acquisizione delle prestazioni sono disattivati per impostazione predefinita:

    • Utilizzo elevato della CPU
    • Memoria utilizzata elevata
    • Attese di blocco delle transazioni
    • Semaphore waits
    • Lunghezza dell'elenco della cronologia

    Se configuri una soglia per uno di questi trigger, ma vuoi disattivarlo in un secondo momento, imposta il valore soglia su 0.

  • Per evitare acquisizioni eccessive, configura le soglie di attivazione in base ai dati sul rendimento storico.

    Ti consigliamo di impostare le soglie verso la parte superiore dell'intervallo storico (ad esempio, al di sopra del carico di lavoro di picco giornaliero normale).

    Se una soglia è impostata su un valore troppo basso o troppo vicino al tuo workload tipico, l'agente potrebbe attivare ripetutamente le acquisizioni. Ciò può comportare:

    • Costi più elevati e overhead di logging: i log non necessari possono aumentare rapidamente i costi di Cloud Logging.
    • Modalità di sospensione con raffreddamento esteso: se un'istanza viola ripetutamente la stessa soglia, viene attivato il meccanismo di backoff di raffreddamento adattivo. In questo modo, l'acquisizione delle prestazioni viene impostata in modalità sonno per 24 ore, che sospende tutti i controlli dei trigger e la diagnostica. Se si verifica un evento critico effettivo, rischi di perdere dati di diagnostica cruciali durante questa modalità sospensione.

Prima di iniziare

Completa le seguenti attività prima di configurare l'acquisizione delle prestazioni.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per modificare un'istanza e attivare l'acquisizione delle prestazioni, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

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

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Abilitare l'acquisizione delle prestazioni

Puoi attivare l'acquisizione delle prestazioni quando crei l'istanza Cloud SQL o quando aggiorni l'istanza esistente.

Per abilitare l'acquisizione delle prestazioni, abilita Query Insights per la tua istanza. Quando abiliti Query Insights, la tua istanza utilizza la configurazione di base dell'acquisizione del rendimento e il valore predefinito per tutti gli attivatori basati su soglia. Per i trigger facoltativi basati su soglie, i trigger sono disattivati.

Per abilitare Query Insight e l'acquisizione delle prestazioni su un'istanza esistente:

  1. Nella Google Cloud console, 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. Nella sezione Personalizza la tua istanza, fai clic su Mostra opzioni di configurazione.
  4. Espandi Query Insights.
  5. Seleziona la casella di controllo Abilita Query Insights.
  6. Nella sezione Attiva funzionalità aggiuntive, assicurati che la casella di controllo Acquisizione del rendimento sia selezionata.
  7. Fai clic su Salva.

Configurare l'acquisizione delle prestazioni

Puoi configurare l'acquisizione delle prestazioni, ad esempio definire soglie di trigger specifiche, quando crei o modifichi l'istanza utilizzando gcloud CLI o l'API Cloud SQL Admin. La modifica della configurazione dell'acquisizione delle prestazioni o di una soglia di attivazione dell'acquisizione delle prestazioni non riavvia l'istanza né la mette in manutenzione.

La seguente procedura descrive come modificare un'istanza esistente per configurare l'acquisizione delle prestazioni.

gcloud

Per configurare l'acquisizione delle prestazioni su un'istanza Cloud SQL esistente, esegui questo comando:

gcloud sql instances patch INSTANCE_NAME \
  --performance-capture-config="enabled=true,PROBE_CONFIGURATION,PERFORMANCE_CAPTURE_THRESHOLDS"

Per il flag performance-capture-config, includi enabled=true. Per lo stesso flag, puoi specificare configurazioni facoltative per PROBE_CONFIGURATION e per PERFORMANCE_CAPTURE_THRESHOLDS.

Puoi anche utilizzare il comando gcloud sql instances patch per modificare i valori di configurazione della soglia per l'acquisizione delle prestazioni su un'istanza esistente.

Configura l'intervallo di probing e i probe consecutivi delle metriche di rendimento

Puoi sostituire PROBE_CONFIGURATION con una o entrambe le seguenti impostazioni dei flag. Se non imposti i flag, l'agente di monitoraggio utilizza il valore predefinito.

  • probing-interval-seconds=SECONDS: un numero intero compreso tra 20 e 86400. L'intervallo di tempo, in secondi, tra i probe delle metriche. Ad esempio, 30, 60, 100. Il valore predefinito è 30.
  • probe-threshold=PROBES: il numero di volte consecutive in cui una soglia deve essere superata per attivare l'acquisizione del rendimento. L'intervallo valido è compreso tra 1 e 20. Il valore predefinito è 3.

Configurare le soglie di acquisizione delle prestazioni

Puoi sostituire PERFORMANCE_CAPTURE_THRESHOLDS con una o più delle seguenti impostazioni dei flag. Se non imposti i valori per i flag, l'agente di monitoraggio utilizza i valori predefiniti per le soglie. Per informazioni più dettagliate sui trigger impostati da questi flag, vedi Trigger di acquisizione delle prestazioni.

  • running-threads-threshold=THREADS: per le istanze primarie o di replica, il numero minimo di thread attivi considerati al di sopra della soglia. Ad esempio, 10. Deve essere maggiore o uguale a 10. Se non viene impostato, il valore predefinito si basa sulle dimensioni dell'istanza. Il valore predefinito è MIN(600, cpuCount * 20).
  • seconds-behind-source-threshold=SECONDS : per le repliche di lettura, il ritardo di replica minimo, in secondi, considerato superiore alla soglia. Deve essere maggiore di 1. Il valore predefinito è 900.
  • transaction-duration-threshold=SECONDS: la durata, in secondi, di una transazione non sottoposta a commit prima che la transazione venga monitorata e inclusa in un log di acquisizione delle prestazioni. Ad esempio, 300. Il valore minimo è 60. Il valore predefinito è 3600. Hai anche la possibilità di terminare automaticamente le transazioni di lunga durata.
  • cpu-utilization-threshold-percent=CPU_PERCENTAGE: la percentuale di utilizzo CPU complessiva da superare in modo coerente. Ad esempio, 90. Il valore minimo è 10 e il valore massimo è 99. Il valore predefinito è 0, che è disabilitato.
  • memory-usage-threshold-percent=MEMORY_PERCENTAGE: la percentuale di memoria utilizzata complessiva da superare costantemente. Ad esempio, 90. Il valore minimo è 10 e il valore massimo è 99. Il valore predefinito è 0, che è disabilitato.
  • transaction-lock-wait-threshold-count=TRANSACTION_COUNT: la soglia per le transazioni che possono trovarsi nello stato `LOCK WAIT`. Ad esempio, 50. Il valore minimo è 10 e il valore massimo è 10000. Il valore predefinito è 0, che è disabilitato.
  • semaphore-wait-threshold-count=SEMAPHORE_THREAD_COUNT: la soglia per il numero di thread in attesa di semafori InnoDB dal comando SHOW ENGINE INNODB STATUS. Ad esempio: 20. Il valore minimo è 10 e il valore massimo è 10000. Il valore predefinito è 0, che è disabilitato.
  • history-list-length-threshold-count=HISTORY_LIST_LENGTH_COUNT: la soglia per il conteggio della lunghezza dell'elenco della cronologia InnoDB (HLL) consentita per il database. Ad esempio, 100000. Il valore minimo è 10000 e il valore massimo è 10000000. Il valore predefinito è 0, che è disabilitato.

REST v1

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

Per il campo performanceCaptureConfig, includi le seguenti impostazioni dei flag. Se non imposti i valori per i flag, l'acquisizione delle prestazioni utilizza i valori predefiniti per le soglie. Per informazioni più dettagliate sui trigger impostati da questi flag, vedi Trigger di acquisizione delle prestazioni.

  • PERFORMANCE_CAPTURE_ENABLED: impostato su true per abilitare l'acquisizione delle prestazioni per l'istanza.
  • PROBING_INTERVAL_SECONDS: un numero intero compreso tra 30 e 86400. L'intervallo di tempo, in secondi, tra i probe delle metriche. Il valore predefinito è 30.
  • PROBE_THRESHOLD: il numero di volte consecutive in cui una soglia deve essere superata per attivare un'acquisizione del rendimento. L'intervallo valido è compreso tra 1 e 20. Il valore predefinito è 3.
  • RUNNING_THREADS_THRESHOLD: per le istanze principali, il numero minimo di thread attivi considerati al di sopra della soglia. Ad esempio, 10. Deve essere maggiore o uguale a 10. Se non viene impostato, il valore predefinito si basa sulle dimensioni dell'istanza. Il valore predefinito è MIN(600, cpuCount * 20).
  • SECONDS_BEHIND_SOURCE_THRESHOLD: per le repliche di lettura, il ritardo di replica minimo, in secondi, considerato superiore alla soglia. Deve essere maggiore di 1. Il valore predefinito è 900.
  • TRANSACTION_DURATION_THRESHOLD: la durata, in secondi, di una transazione non eseguita prima che venga monitorata e inclusa in un log di acquisizione del rendimento. Ad esempio, 300. Il valore minimo è 60. Il valore predefinito è 3600. Se vuoi configurare la chiusura automatica delle transazioni di lunga durata, puoi includere impostazioni di configurazione aggiuntive nel campo performanceCaptureConfig. Per saperne di più, consulta Terminare automaticamente le transazioni a lunga esecuzione.
  • CPU_UTILIZATION_THRESHOLD_PERCENT: la percentuale di utilizzo CPU complessiva da superare in modo coerente. Ad esempio, 90. Il valore minimo è 10 e il valore massimo è 99. Il valore predefinito è 0, che è disabilitato.
  • MEMORY_USAGE_THRESHOLD_PERCENT: la percentuale di memoria utilizzata complessiva da superare costantemente. Ad esempio, 90. Il valore minimo è 10 e il valore massimo è 99. Il valore predefinito è 0, che è disabilitato.
  • TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: la soglia per le transazioni che possono trovarsi nello stato LOCK WAIT. Ad esempio: 50. Il valore minimo è 10 e il valore massimo è 10000. Il valore predefinito è 0, che è disabilitato.
  • SEMAPHORE_WAIT_THRESHOLD_COUNT: la soglia per il numero di thread in attesa di semafori InnoDB dal comando SHOW ENGINE INNODB STATUS. Ad esempio: 20. Il valore minimo è 10 e il valore massimo è 10000. Il valore predefinito è 0, che è disabilitato.
  • HISTORY_LIST_LENGTH_THRESHOLD_COUNT: la soglia per il conteggio della lunghezza dell'elenco della cronologia InnoDB (HLL) consentita per il database. Ad esempio, 100000. Il valore minimo è 10000 e il valore massimo è 10000000. Il valore predefinito è 0, che è disabilitato.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "performanceCaptureConfig": {
     "enabled": PERFORMANCE_CAPTURE_ENABLED,
     "probingIntervalSeconds": PROBING_INTERVAL_SECONDS,
     "probeThreshold": PROBE_THRESHOLD,
     "runningThreadsThreshold": RUNNING_THREADS_THRESHOLD,
     "secondsBehindSourceThreshold": SECONDS_BEHIND_SOURCE_THRESHOLD,
     "transactionDurationThreshold": TRANSACTION_DURATION_THRESHOLD,
     "cpuUtilizationThresholdPercent": CPU_UTILIZATION_THRESHOLD_PERCENT,
     "memoryUsageThresholdPercent": MEMORY_USAGE_THRESHOLD_PERCENT,
     "transactionLockWaitThresholdCount": TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT,
     "semaphoreWaitThresholdCount": SEMAPHORE_WAIT_THRESHOLD_COUNT,
     "historyListLengthThresholdCount": HISTORY_LIST_LENGTH_THRESHOLD_COUNT
  },
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-11-10T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

Per il campo performanceCaptureConfig, includi le seguenti impostazioni dei flag. Se non imposti i valori per i flag, l'agente di monitoraggio utilizza i valori predefiniti per le soglie. Per informazioni più dettagliate sui trigger impostati da questi flag, vedi Trigger di acquisizione delle prestazioni.

  • PERFORMANCE_CAPTURE_ENABLED: impostato su true per abilitare l'acquisizione delle prestazioni per l'istanza.
  • PROBING_INTERVAL_SECONDS: un numero intero compreso tra 30 e 86400. L'intervallo di tempo, in secondi, tra i probe delle metriche. Il valore predefinito è 30.
  • PROBE_THRESHOLD: il numero di volte consecutive in cui una soglia deve essere superata per attivare un'acquisizione del rendimento. L'intervallo valido è compreso tra 1 e 20. Il valore predefinito è 3.
  • RUNNING_THREADS_THRESHOLD: per le istanze principali, il numero minimo di thread attivi considerati al di sopra della soglia. Ad esempio, 10. Deve essere maggiore o uguale a 10. Se non viene impostato, il valore predefinito si basa sulle dimensioni dell'istanza. Il valore predefinito è MIN(600, cpuCount * 20).
  • SECONDS_BEHIND_SOURCE_THRESHOLD: per le repliche di lettura, il ritardo di replica minimo, in secondi, considerato superiore alla soglia. Deve essere maggiore di 1. Il valore predefinito è 900.
  • TRANSACTION_DURATION_THRESHOLD: la durata, in secondi, di una transazione non eseguita prima che venga monitorata e inclusa in un log di acquisizione del rendimento. Ad esempio, 300. Il valore minimo è 60. Il valore predefinito è 3600. Se vuoi configurare la chiusura automatica delle transazioni di lunga durata, puoi includere impostazioni di configurazione aggiuntive nel campo performanceCaptureConfig. Per saperne di più, consulta Terminare automaticamente le transazioni a lunga esecuzione.
  • CPU_UTILIZATION_THRESHOLD_PERCENT: la percentuale di utilizzo CPU complessiva da superare in modo coerente. Ad esempio, 90. Il valore minimo è 10 e il valore massimo è 99. Il valore predefinito è 0, che è disabilitato.
  • MEMORY_USAGE_THRESHOLD_PERCENT: la percentuale di memoria utilizzata complessiva da superare costantemente. Ad esempio, 90. Il valore minimo è 10 e il valore massimo è 99. Il valore predefinito è 0, che è disabilitato.
  • TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: la soglia per le transazioni che possono trovarsi nello stato LOCK WAIT. Ad esempio: 50. Il valore minimo è 10 e il valore massimo è 10000. Il valore predefinito è 0, che è disabilitato.
  • SEMAPHORE_WAIT_THRESHOLD_COUNT: la soglia per il numero di thread in attesa di semafori InnoDB dal comando SHOW ENGINE INNODB STATUS. Ad esempio: 20. Il valore minimo è 10 e il valore massimo è 10000. Il valore predefinito è 0, che è disabilitato.
  • HISTORY_LIST_LENGTH_THRESHOLD_COUNT: la soglia per il conteggio della lunghezza dell'elenco della cronologia InnoDB (HLL) consentita per il database. Ad esempio, 100000. Il valore minimo è 10000 e il valore massimo è 10000000. Il valore predefinito è 0, che è disabilitato.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "performanceCaptureConfig": {
     "enabled": PERFORMANCE_CAPTURE_ENABLED,
     "probingIntervalSeconds": PROBING_INTERVAL_SECONDS,
     "probeThreshold": PROBE_THRESHOLD,
     "runningThreadsThreshold": RUNNING_THREADS_THRESHOLD,
     "secondsBehindSourceThreshold": SECONDS_BEHIND_SOURCE_THRESHOLD,
     "transactionDurationThreshold": TRANSACTION_DURATION_THRESHOLD,
     "cpuUtilizationThresholdPercent": CPU_UTILIZATION_THRESHOLD_PERCENT,
     "memoryUsageThresholdPercent": MEMORY_USAGE_THRESHOLD_PERCENT,
     "transactionLockWaitThresholdCount": TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT,
     "semaphoreWaitThresholdCount": SEMAPHORE_WAIT_THRESHOLD_COUNT,
     "historyListLengthThresholdCount": HISTORY_LIST_LENGTH_THRESHOLD_COUNT
  },
}

Per inviare la richiesta, espandi una di queste opzioni:

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": "2025-11-10T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Terminare automaticamente le transazioni a lunga esecuzione

Puoi utilizzare l'acquisizione delle prestazioni per terminare le transazioni che superano una durata predefinita, il che può aiutarti a evitare query incontrollate che possono destabilizzare la tua istanza.

Per configurare il database Cloud SQL per MySQL in modo da terminare automaticamente le transazioni a lunga esecuzione, utilizza gcloud CLI o l'API Cloud SQL Admin.

gcloud

Per attivare la chiusura automatica delle transazioni a lunga esecuzione, imposta il limite di soglia per le transazioni. Per configurare la chiusura automatica delle transazioni, esegui questo comando:

gcloud sql instances patch INSTANCE_NAME \
  --performance-capture-config="transaction-kill-threshold-seconds=SECONDS"

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza
  • SECONDS: il limite di durata, in secondi, per la chiusura automatica della transazione a esecuzione prolungata. Questo limite non può essere impostato su un valore inferiore a quello impostato per il trigger transaction-duration-threshold o transactionDurationThreshold.

Puoi anche specificare il tipo di transazioni da terminare automaticamente (il valore predefinito è READ_ONLY_TRANSACTIONS) e personalizzare un elenco di utenti o host di transazioni specifici da esentare. Per configurare queste opzioni, esegui il comando seguente:

gcloud sql instances patch INSTANCE_NAME \
  --performance-capture-config="transaction-kill-threshold-seconds=SECONDS,transaction-kill-type=TRANSACTION_TYPE,transaction-kill-excluded-user-hosts=EXCLUSION_LIST"

Sostituisci quanto segue:

  • TRANSACTION_TYPE: determina le categorie di transazioni da terminare. Specifica uno dei seguenti valori:
    • READ_ONLY_TRANSACTIONS: termina solo le query di sola lettura o SELECT. Questo è il valore predefinito se transaction-kill-type non è specificato.
    • ALL_TRANSACTIONS: termina qualsiasi query in esecuzione che supera la soglia, incluse le query con operazioni di scrittura. Sono inclusi INSERT, UPDATE, DELETE e altre dichiarazioni DDL.
  • EXCLUSION_LIST: un elenco di stringhe da esentare. Puoi fornire le voci utilizzando una combinazione specifica di nome utente e host del database, ad esempio user@host, o come nome di un account utente in stile MySQL, che per impostazione predefinita è user@%. L'elenco supporta i caratteri jolly % e _ per la corrispondenza nella parte dell'host.

Ad esempio, puoi eseguire il seguente comando per configurare la fine automatica di _tutte le transazioni_, incluse tutte le transazioni di lettura e scrittura, ma escludere utenti specifici noti di transazioni di lunga durata.

gcloud sql instances patch example-instance \
--performance-capture-config="transaction-kill-threshold-seconds=600,transaction-kill-type=ALL_TRANSACTIONS,transaction-kill-excluded-user-hosts=report_user@%;backup_user@localhost"

REST v1

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

  • SECONDS: la durata, in secondi, delle transazioni a esecuzione prolungata da terminare automaticamente. Questo limite non può essere impostato su un valore inferiore a quello impostato per il campo transactionDurationThreshold.
  • TRANSACTION_TYPE: determina le categorie di transazioni da terminare. Utilizza uno dei seguenti valori:
    • READ_ONLY_TRANSACTIONS: termina solo le query di sola lettura o SELECT. Questo è il valore predefinito se transactionKillType non è specificato.
    • ALL_TRANSACTIONS: termina qualsiasi query in esecuzione che supera la soglia, incluse le query con operazioni di scrittura. Sono inclusi INSERT, UPDATE, DELETE e altre istruzioni DDL.
  • EXCLUSION_LIST: un elenco di stringhe da esentare. Puoi fornire le voci utilizzando una combinazione specifica di nome utente e host del database, ad esempio user@host, o come nome account utente in stile MySQL, che per impostazione predefinita è user@%. L'elenco supporta i caratteri jolly % e _ per la corrispondenza nella parte dell'host.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "performanceCaptureConfig": {
    "transactionKillThresholdSeconds": SECONDS,
    "transactionKillType": TRANSACTION_TYPE,
    "transactionKillExcludedUserHosts": [ EXCLUSION_LIST
    ]
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-11-10T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

  • SECONDS: la durata, in secondi, delle transazioni a esecuzione prolungata da terminare automaticamente. Questo limite non può essere impostato su un valore inferiore a quello impostato per il campo transactionDurationThreshold.
  • TRANSACTION_TYPE: determina le categorie di transazioni da terminare. Utilizza uno dei seguenti valori:
    • READ_ONLY_TRANSACTIONS: termina solo le query di sola lettura o SELECT. Questo è il valore predefinito se transactionKillType non è specificato.
    • ALL_TRANSACTIONS: termina qualsiasi query in esecuzione che supera la soglia, incluse le query con operazioni di scrittura. Sono inclusi INSERT, UPDATE, DELETE e altre istruzioni DDL.
  • EXCLUSION_LIST: un elenco di stringhe da esentare. Puoi fornire le voci utilizzando una combinazione specifica di nome utente e host del database, ad esempio user@host, o come nome account utente in stile MySQL, che per impostazione predefinita è user@%. L'elenco supporta i caratteri jolly % e _ per la corrispondenza nella parte dell'host.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "performanceCaptureConfig": {
    "transactionKillThresholdSeconds": SECONDS,
    "transactionKillType": TRANSACTION_TYPE,
    "transactionKillExcludedUserHosts": [ EXCLUSION_LIST
    ]
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

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": "2025-11-10T22:19:33.735Z",
  "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 l'acquisizione delle prestazioni

Per disattivare l'acquisizione delle prestazioni:

Console

  1. Nella Google Cloud console, 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. Fai clic su Modifica.
  4. Nella sezione Personalizza la tua istanza, fai clic su Mostra opzioni di configurazione.
  5. Espandi Query Insights.
  6. Nella sezione Attiva funzionalità aggiuntive, deseleziona la casella di controllo Acquisizione delle prestazioni.
  7. Fai clic su Salva.

gcloud

gcloud sql instances patch INSTANCE_NAME \
  --performance-capture-config="enabled=false"

Sostituisci INSTANCE_NAME con il nome dell'istanza in cui vuoi disattivare l'acquisizione delle prestazioni.

REST v1

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "performanceCaptureConfig": {
     "enabled": false
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "INSERT_TIME",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "performanceCaptureConfig": {
     "enabled": false
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

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": "2025-11-10T22:19:33.735Z",
  "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