Configurar a captura de performance

Com a captura de performance, é possível diagnosticar problemas temporários no banco de dados capturando métricas detalhadas da instância quando a performance está degradada. 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 gatilhos de captura de performance

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

  • Os seguintes gatilhos de captura de performance são desativados por padrão:

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

    Se você configurar um limite para um desses acionadores, 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 na extremidade superior do intervalo histórico (por exemplo, acima da carga de trabalho diária normal).

    Se um limite for definido como muito baixo ou muito próximo da sua 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 os custos do Cloud Logging.
    • Modo de espera de redução de velocidade estendida: se uma instância violar repetidamente o mesmo limite, o mecanismo de espera adaptativa de redução de velocidade será acionado. Isso coloca a captura de desempenho em um modo de espera de 24 horas, que suspende todas as verificações de acionamento e diagnósticos. Você corre o risco de perder dados de diagnóstico cruciais durante esse modo de espera se um evento crítico real ocorrer.

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 papéis do IAM a seguir 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 captura de performance

É possível ativar a captura de desempenho ao criar sua 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 os insights de consulta, a instância usa a configuração básica de captura de performance e o valor padrão para todos os acionadores com base em limite. Para acionadores opcionais baseados em limite, eles são desativados.

Para ativar os insights de consulta e a captura de desempenho em uma instância atual, faça o seguinte:

  1. No console Google Cloud , 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. Expanda Query Insights.
  5. Marque a caixa de seleção Ativar Query insights.
  6. Na seção Ativar outros recursos, verifique se a caixa de seleção Captura de performance está marcada.
  7. Clique em Salvar.

Configurar a captura de desempenho

É possível configurar a captura de desempenho, como definir limites de gatilho 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 performance ou um limite de ativação da captura de performance 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 atual para configurar a captura de desempenho.

gcloud

Para configurar a captura de desempenho em uma instância 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 sinalização 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 de limite para captura de desempenho em uma instância atual.

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

Você pode 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 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 performance

Substitua 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 mais informações 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 de ser 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 pode encerrar transações de longa duração automaticamente.
  • cpu-utilization-threshold-percent=CPU_PERCENTAGE: a porcentagem geral de uso da CPU que é 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 a 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 para 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 comprimento da lista de histórico (HLL) 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 usará os valores padrão para os limites. Para mais informações sobre os gatilhos definidos por essas flags, consulte Gatilhos de captura de desempenho.

  • PERFORMANCE_CAPTURE_ENABLED: defina como true para ativar a captura de performance na sua 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 principais, o número mínimo de threads 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 de ser 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 configurações 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 é 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 a 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 para transações que podem estar no 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 comprimento da lista de histórico (HLL) 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 usará os valores padrão para os limites. Para mais informações sobre os gatilhos definidos por essas flags, consulte Gatilhos de captura de desempenho.

  • PERFORMANCE_CAPTURE_ENABLED: defina como true para ativar a captura de performance na sua 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 principais, o número mínimo de threads 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 de ser 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 configurações 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 é 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 a 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 para transações que podem estar no 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 comprimento da lista de histórico (HLL) 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 automaticamente transações de longa duração

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

Para configurar seu banco de dados do Cloud SQL para MySQL e 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 de 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 automaticamente a transação de longa duração. Esse limite não pode ser definido com um valor menor do que o definido para o gatilho transaction-duration-threshold ou transactionDurationThreshold.

Você também pode especificar o tipo de transações a serem encerradas automaticamente (o padrão é READ_ONLY_TRANSACTIONS) e personalizar uma lista de usuários ou hosts específicos para excluir. 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 é 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 dispensadas. É 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 tem como padrão user@%. A lista é compatível com os caracteres curinga % e _ para correspondência na parte do host.

Por exemplo, você pode executar o seguinte comando 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 específicos conhecidos 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 com 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 é 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 dispensadas. Você pode 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 tem como padrão user@%. 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 com 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 é 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 dispensadas. Você pode 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 tem como padrão user@%. 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 performance

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

Console

  1. No console Google Cloud , 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. Expanda Query Insights.
  6. Na seção Ativar recursos extras, 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