Configurar a captura de performance

A captura de desempenho permite diagnosticar problemas temporários no banco de dados capturando métricas detalhadas da instância quando o desempenho é degradado. Para usar a captura de desempenho, ative-a na sua instância e configure os limites que acionam os snapshots detalhados baseados em métricas da instância do Cloud SQL.

Diretrizes para configurar acionadores de captura de desempenho

Lembre-se das seguintes diretrizes ao configurar gatilhos para captura de desempenho.

  • Os seguintes gatilhos de captura de desempenho estão desativados por padrão:

    • alta utilização da CPU;
    • Alto uso da memória
    • Espera de bloqueio de transação
    • Esperas de semáforo
    • Tamanho da lista do histórico

    Se você configurar um limite para um desses gatilhos, mas quiser desativá-lo depois, defina o valor do limite como 0.

  • Para evitar capturas excessivas, configure os limites de acionamento com base em dados históricos de performance.

    Recomendamos definir os limites para o limite superior do intervalo histórico (por exemplo, acima da carga de trabalho de pico diária normal).

    Se um limite for definido como muito baixo ou muito próximo da carga de trabalho típica, o agente poderá acionar capturas repetidamente. Isso pode gerar:

    • Custos mais altos e sobrecarga de geração de registros: registros desnecessários podem aumentar rapidamente seus custos do Cloud Logging.
    • Modo de espera de resfriamento estendido: se uma instância violar repetidamente o mesmo limite, o mecanismo de espera de resfriamento adaptável será acionado. Isso coloca a captura de desempenho em um modo de suspensão de 24 horas, que suspende todas as verificações de acionadores e diagnósticos. Você corre o risco de perder dados de diagnóstico cruciais durante esse modo de espera se ocorrer um evento crítico real.

Antes de começar

Conclua as tarefas a seguir antes de configurar a captura de desempenho.

Funções exigidas

Para receber as permissões necessárias para modificar uma instância e ativar a captura de desempenho, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Ativar a captura de desempenho

É possível ativar a captura de desempenho ao criar a instância do Cloud SQL ou ao atualizar a instância atual.

Para ativar a captura de desempenho, ative o Query Insights na sua instância. Quando você ativa o Query Insights, sua instância usa a configuração básica de captura de desempenho e o valor padrão para todos os gatilhos baseados em limite. Para acionadores opcionais baseados em limite, os acionadores são desativados.

Para ativar o Query Insights e a captura de desempenho em uma instância, faça o seguinte:

  1. No console do Cloud de Confiance , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. Na seção Personalizar a instância, clique em Mostrar opções de configuração.
  4. Abra o Query Insights.
  5. Marque a caixa de seleção Ativar Query insights.
  6. Na seção Ativar recursos adicionais, verifique se a caixa de seleção Captura de performance está marcada.
  7. Clique em Salvar.

Configurar a captura de performance

É possível configurar a captura de desempenho, como definir limites de acionamento específicos, ao criar ou editar a instância usando a CLI gcloud ou a API Cloud SQL Admin. Modificar a configuração da captura de desempenho ou um limite de acionador de captura de desempenho não reinicia a instância nem faz com que ela entre em manutenção.

O procedimento a seguir descreve como editar uma instância para configurar a captura de desempenho.

gcloud

Para configurar a captura de desempenho em uma instância atual do Cloud SQL, execute o seguinte comando:

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

Para a flag performance-capture-config, inclua enabled=true. Para a mesma flag, é possível especificar configurações opcionais para PROBE_CONFIGURATION e para PERFORMANCE_CAPTURE_THRESHOLDS.

Também é possível usar o comando gcloud sql instances patch para modificar os valores de configuração do limite para captura de desempenho em uma instância atual.

Configurar o intervalo de sondagem e as sondagens consecutivas de métricas de performance

É possível substituir PROBE_CONFIGURATION por uma ou ambas as configurações de flag a seguir. Se você não definir as flags, o agente de monitoramento vai usar o valor padrão.

  • probing-interval-seconds=SECONDS: um número inteiro entre 20 e 86400. O intervalo de tempo, em segundos, entre as sondagens de métricas. Por exemplo, 30, 60, 100. O padrão é 30.
  • probe-threshold=PROBES: o número de vezes consecutivas que um limite precisa ser excedido para acionar uma captura de desempenho. O intervalo válido é de 1 a 20. O padrão é 3.

Configurar limites de captura de desempenho

É possível substituir PERFORMANCE_CAPTURE_THRESHOLDS por uma ou mais das seguintes configurações de flag. Se você não definir valores para as flags, o agente de monitoramento vai usar os valores padrão para os limites. Para informações mais detalhadas sobre os gatilhos definidos por essas flags, consulte Gatilhos de captura de desempenho.

  • running-threads-threshold=THREADS: para instâncias primárias ou de réplica, o número mínimo de linhas de execução ativas consideradas acima do limite. Por exemplo, 10. Precisa ser maior ou igual a 10. Se não for definido, o padrão será baseado no tamanho da instância. O padrão é MIN(600, cpuCount * 20).
  • seconds-behind-source-threshold=SECONDS : para réplicas de leitura, o atraso mínimo de replicação, em segundos, considerado acima do limite. Precisa ser maior que 1. O padrão é 900.
  • transaction-duration-threshold=SECONDS: a duração, em segundos, de uma transação não confirmada antes que ela seja rastreada e incluída em um registro de captura de desempenho. Por exemplo, 300. O valor mínimo é 60. O padrão é 3600. Você também tem a opção de encerrar transações de longa duração automaticamente.
  • cpu-utilization-threshold-percent=CPU_PERCENTAGE: a porcentagem geral de uso da CPU que deve ser excedida de forma consistente. Por exemplo, 90. O valor mínimo é 10, e o máximo é 99. O padrão é 0, que está desativado.
  • memory-usage-threshold-percent=MEMORY_PERCENTAGE: a porcentagem geral de uso da memória que será excedida de forma consistente. Por exemplo, 90. O valor mínimo é 10, e o máximo é 99. O padrão é 0, que está desativado.
  • transaction-lock-wait-threshold-count=TRANSACTION_COUNT: o limite de transações que podem estar em um estado "LOCK WAIT". Por exemplo, 50. O valor mínimo é 10, e o máximo é 10000. O padrão é 0, que está desativado.
  • semaphore-wait-threshold-count=SEMAPHORE_THREAD_COUNT: o limite para o número de linhas de execução aguardando semáforos do InnoDB do comando SHOW ENGINE INNODB STATUS. Por exemplo, 20. O valor mínimo é 10, e o máximo é 10000. O padrão é 0, que está desativado.
  • history-list-length-threshold-count=HISTORY_LIST_LENGTH_COUNT: o limite para a contagem do tamanho da lista de histórico (HLL, na sigla em inglês) do InnoDB permitida para o banco de dados. Por exemplo, 100000. O valor mínimo é 10000, e o máximo é 10000000. O padrão é 0, que está desativado.

REST v1

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

Para o campo performanceCaptureConfig, inclua as seguintes configurações de flag. Se você não definir valores para as flags, a captura de desempenho vai usar os valores padrão para os limites. Para mais informações sobre os acionadores definidos por essas flags, consulte Acionadores de captura de desempenho.

  • PERFORMANCE_CAPTURE_ENABLED: defina como true para ativar a captura de desempenho na instância.
  • PROBING_INTERVAL_SECONDS: um número inteiro entre 30 e 86400. O intervalo de tempo, em segundos, entre as sondagens de métricas. O padrão é 30.
  • PROBE_THRESHOLD: o número de vezes consecutivas que um limite precisa ser excedido para acionar uma captura de desempenho. O intervalo válido é de 1 a 20. O padrão é 3.
  • RUNNING_THREADS_THRESHOLD: para instâncias primárias, o número mínimo de linhas de execução ativas consideradas acima do limite. Por exemplo, 10. Precisa ser maior ou igual a 10. Se não for definido, o padrão será baseado no tamanho da instância. O padrão é MIN(600, cpuCount * 20).
  • SECONDS_BEHIND_SOURCE_THRESHOLD: para réplicas de leitura, o atraso mínimo de replicação, em segundos, considerado acima do limite. Precisa ser maior que 1. O padrão é 900.
  • TRANSACTION_DURATION_THRESHOLD: a duração, em segundos, de uma transação não confirmada antes que ela seja rastreada e incluída em um registro de captura de desempenho. Por exemplo, 300. O valor mínimo é 60. O padrão é 3600. Se você quiser configurar o encerramento automático de transações de longa duração, inclua outras definições de configuração no campo performanceCaptureConfig. Para mais informações, consulte Encerrar transações de longa duração automaticamente.
  • CPU_UTILIZATION_THRESHOLD_PERCENT: a porcentagem geral de uso da CPU que deve ser excedida de forma consistente. Por exemplo, 90. O valor mínimo é 10, e o máximo é 99. O padrão é 0, que está desativado.
  • MEMORY_USAGE_THRESHOLD_PERCENT: a porcentagem geral de uso da memória que será excedida de forma consistente. Por exemplo, 90. O valor mínimo é 10, e o máximo é 99. O padrão é 0, que está desativado.
  • TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: o limite de transações que podem estar em um estado LOCK WAIT. Por exemplo, 50. O valor mínimo é 10, e o máximo é 10000. O padrão é 0, que está desativado.
  • SEMAPHORE_WAIT_THRESHOLD_COUNT: o limite para o número de linhas de execução aguardando semáforos do InnoDB do comando SHOW ENGINE INNODB STATUS. Por exemplo, 20. O valor mínimo é 10, e o máximo é 10000. O padrão é 0, que está desativado.
  • HISTORY_LIST_LENGTH_THRESHOLD_COUNT: o limite para a contagem do tamanho da lista de histórico (HLL, na sigla em inglês) do InnoDB permitida para o banco de dados. Por exemplo, 100000. O valor mínimo é 10000, e o máximo é 10000000. O padrão é 0, que está desativado.

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "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
  },
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

Para o campo performanceCaptureConfig, inclua as seguintes configurações de flag. Se você não definir valores para as flags, o agente de monitoramento vai usar os valores padrão para os limites. Para mais informações sobre os acionadores definidos por essas flags, consulte Acionadores de captura de desempenho.

  • PERFORMANCE_CAPTURE_ENABLED: defina como true para ativar a captura de desempenho na instância.
  • PROBING_INTERVAL_SECONDS: um número inteiro entre 30 e 86400. O intervalo de tempo, em segundos, entre as sondagens de métricas. O padrão é 30.
  • PROBE_THRESHOLD: o número de vezes consecutivas que um limite precisa ser excedido para acionar uma captura de desempenho. O intervalo válido é de 1 a 20. O padrão é 3.
  • RUNNING_THREADS_THRESHOLD: para instâncias primárias, o número mínimo de linhas de execução ativas consideradas acima do limite. Por exemplo, 10. Precisa ser maior ou igual a 10. Se não for definido, o padrão será baseado no tamanho da instância. O padrão é MIN(600, cpuCount * 20).
  • SECONDS_BEHIND_SOURCE_THRESHOLD: para réplicas de leitura, o atraso mínimo de replicação, em segundos, considerado acima do limite. Precisa ser maior que 1. O padrão é 900.
  • TRANSACTION_DURATION_THRESHOLD: a duração, em segundos, de uma transação não confirmada antes que ela seja rastreada e incluída em um registro de captura de desempenho. Por exemplo, 300. O valor mínimo é 60. O padrão é 3600. Se você quiser configurar o encerramento automático de transações de longa duração, inclua outras definições de configuração no campo performanceCaptureConfig. Para mais informações, consulte Encerrar transações de longa duração automaticamente.
  • CPU_UTILIZATION_THRESHOLD_PERCENT: a porcentagem geral de uso da CPU que deve ser excedida de forma consistente. Por exemplo, 90. O valor mínimo é 10, e o máximo é 99. O padrão é 0, que está desativado.
  • MEMORY_USAGE_THRESHOLD_PERCENT: a porcentagem geral de uso da memória que será excedida de forma consistente. Por exemplo, 90. O valor mínimo é 10, e o máximo é 99. O padrão é 0, que está desativado.
  • TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: o limite de transações que podem estar em um estado LOCK WAIT. Por exemplo, 50. O valor mínimo é 10, e o máximo é 10000. O padrão é 0, que está desativado.
  • SEMAPHORE_WAIT_THRESHOLD_COUNT: o limite para o número de linhas de execução aguardando semáforos do InnoDB do comando SHOW ENGINE INNODB STATUS. Por exemplo, 20. O valor mínimo é 10, e o máximo é 10000. O padrão é 0, que está desativado.
  • HISTORY_LIST_LENGTH_THRESHOLD_COUNT: o limite para a contagem do tamanho da lista de histórico (HLL, na sigla em inglês) do InnoDB permitida para o banco de dados. Por exemplo, 100000. O valor mínimo é 10000, e o máximo é 10000000. O padrão é 0, que está desativado.

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "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
  },
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "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"
}

Encerrar transações de longa duração automaticamente

É possível usar a captura de desempenho para encerrar todas as transações que excedem uma duração predefinida, o que pode ajudar a evitar consultas descontroladas que podem desestabilizar sua instância.

Para configurar o banco de dados do Cloud SQL para MySQL para encerrar transações de longa duração automaticamente, use a CLI gcloud ou a API Cloud SQL Admin.

gcloud

Para ativar o encerramento automático de transações de longa duração, defina o limite para transações. Para configurar o encerramento automático de transações, execute o seguinte comando:

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

Substitua:

  • INSTANCE_NAME: o nome da instância.
  • SECONDS: o limite de duração, em segundos, de quando encerrar a transação de longa duração automaticamente. Esse limite não pode ser definido como um valor menor do que o definido para o gatilho transaction-duration-threshold ou transactionDurationThreshold.

Também é possível especificar o tipo de transação que será encerrada automaticamente (o padrão é READ_ONLY_TRANSACTIONS) e personalizar uma lista de usuários ou hosts de transações específicas que serão isentos. Para configurar essas opções, execute o seguinte comando:

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"

Substitua:

  • TRANSACTION_TYPE: determina as categorias de transações a serem encerradas. Especifique um dos seguintes valores:
    • READ_ONLY_TRANSACTIONS: encerra apenas consultas somente leitura ou SELECT. Esse será o padrão se transaction-kill-type não for especificado.
    • ALL_TRANSACTIONS: encerra qualquer consulta em execução que exceda o limite, incluindo consultas com operações de gravação. Isso inclui INSERT, UPDATE, DELETE e outras instruções DDL.
  • EXCLUSION_LIST: uma lista de strings a serem isentas. É possível fornecer as entradas usando uma combinação específica de nome de usuário e host do banco de dados, como user@host, ou como um nome de conta de usuário no estilo MySQL, que usa user@% como padrão. A lista é compatível com os caracteres curinga % e _ para correspondência na parte do host.

Por exemplo, é possível executar o comando a seguir para configurar o encerramento automático de _todas as transações_, incluindo todas as transações de leitura e gravação, mas excluir usuários conhecidos específicos de transações de longa duração.

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

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • SECONDS: a duração, em segundos, das transações de longa duração que serão encerradas automaticamente. Esse limite não pode ser definido como um valor menor do que o valor definido para o campo transactionDurationThreshold.
  • TRANSACTION_TYPE: determina as categorias de transações a serem encerradas. Use um dos seguintes valores:
    • READ_ONLY_TRANSACTIONS: encerra apenas consultas somente leitura ou SELECT. Esse será o padrão se transactionKillType não for especificado.
    • ALL_TRANSACTIONS: encerra qualquer consulta em execução que exceda o limite, incluindo consultas com operações de gravação. Isso inclui INSERT, UPDATE, DELETE e outras instruções DDL.
  • EXCLUSION_LIST: uma lista de strings a serem isentas. É possível fornecer as entradas usando uma combinação específica de nome de usuário e host do banco de dados, como user@host ou como um nome de conta de usuário no estilo MySQL, que usa user@% como padrão. A lista aceita os caracteres curinga % e _ para correspondência na parte do host.

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • SECONDS: a duração, em segundos, das transações de longa duração que serão encerradas automaticamente. Esse limite não pode ser definido como um valor menor do que o valor definido para o campo transactionDurationThreshold.
  • TRANSACTION_TYPE: determina as categorias de transações a serem encerradas. Use um dos seguintes valores:
    • READ_ONLY_TRANSACTIONS: encerra apenas consultas somente leitura ou SELECT. Esse será o padrão se transactionKillType não for especificado.
    • ALL_TRANSACTIONS: encerra qualquer consulta em execução que exceda o limite, incluindo consultas com operações de gravação. Isso inclui INSERT, UPDATE, DELETE e outras instruções DDL.
  • EXCLUSION_LIST: uma lista de strings a serem isentas. É possível fornecer as entradas usando uma combinação específica de nome de usuário e host do banco de dados, como user@host ou como um nome de conta de usuário no estilo MySQL, que usa user@% como padrão. A lista aceita os caracteres curinga % e _ para correspondência na parte do host.

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "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"
}

Desativar a captura de desempenho

Para desativar a captura de desempenho, faça o seguinte:

Console

  1. No console do Cloud de Confiance , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome dela.
  3. Clique em Editar.
  4. Na seção Personalizar a instância, clique em Mostrar opções de configuração.
  5. Abra o Query Insights.
  6. Na seção Ativar recursos adicionais, desmarque a caixa de seleção Captura de desempenho.
  7. Clique em Salvar.

gcloud

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

Substitua INSTANCE_NAME pelo nome da instância em que você quer desativar a captura de desempenho.

REST v1

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "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"
}

A seguir