Es posible que parte de la información de esta página (o toda) no se aplique a Cloud de Confiance de S3NS. Consulta Diferencias con Google Cloud para obtener más información.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Cómo configurar la captura de rendimiento

MySQL | PostgreSQL | SQL Server

La captura de rendimiento te permite diagnosticar problemas transitorios con tu base de datos, ya que captura métricas detalladas de tu instancia cuando se degrada el rendimiento. Para usar la captura de rendimiento, habilita esta función en tu instancia y configura los umbrales que activan las instantáneas detalladas basadas en métricas de tu instancia de Cloud SQL.

Lineamientos para configurar activadores de captura de rendimiento

Ten en cuenta los siguientes lineamientos cuando configures activadores para la captura del rendimiento.

Los siguientes activadores de captura de rendimiento están inhabilitados de forma predeterminada:
- Uso alto de CPU
- Uso elevado de memoria
- Espera de bloqueo de transacción
- Espera de semáforo
- Longitud de la lista del historial
Si configuras un umbral para uno de estos activadores, pero quieres inhabilitarlo después, establece el valor del umbral en 0.
Para evitar capturas excesivas, configura los umbrales de activación según los datos de rendimiento históricos.

Te recomendamos que establezcas tus umbrales en el extremo superior de tu rango histórico (por ejemplo, por encima de tu carga de trabajo máxima diaria normal).

Si se establece un umbral demasiado bajo o demasiado cerca de tu carga de trabajo típica, es posible que el agente active capturas de forma repetida. Esto puede producir:
- Mayores costos y sobrecarga de registro: Los registros innecesarios pueden aumentar rápidamente los costos de Cloud Logging.
- Modo de suspensión de enfriamiento extendido: Si una instancia incumple repetidamente el mismo umbral, se activa el mecanismo de espera de enfriamiento adaptativo. Esto pone la captura de rendimiento en un modo de suspensión las 24 horas, que suspende todas las verificaciones de activación y los diagnósticos. Si ocurre un evento crítico real durante este modo de suspensión, corres el riesgo de perder datos de diagnóstico cruciales.

Antes de comenzar

Completa las siguientes tareas antes de configurar la captura del rendimiento.

Roles obligatorios

Para obtener los permisos que necesitas para modificar una instancia y habilitar la captura del rendimiento, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

Administrador de Cloud SQL (roles/cloudsql.admin)
Visualizador de Compute (roles/compute.viewer)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Habilita la captura de rendimiento

Puedes habilitar la captura del rendimiento cuando crees tu instancia de Cloud SQL o cuando actualices tu instancia existente.

Para habilitar la captura del rendimiento, habilita las estadísticas de consultas para tu instancia. Cuando habilitas las estadísticas de consultas, tu instancia usa la configuración básica de la captura del rendimiento y el valor predeterminado para cualquier activador basado en umbrales. En el caso de los activadores opcionales basados en umbrales, los activadores están inhabilitados.

Para habilitar las estadísticas de consultas y la captura del rendimiento en una instancia existente, haz lo siguiente:

En la consola de Cloud de Confiance , ve a la página Instancias de Cloud SQL.

Ir a Instancias de Cloud SQL
Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
En la sección Personaliza tu instancia, haz clic en Mostrar opciones de configuración.
Expande Estadísticas de consultas.
Selecciona la casilla de verificación Habilitar Estadísticas de consultas.
En la sección Habilita funciones adicionales, asegúrate de que esté seleccionada la casilla de verificación Captura de rendimiento.
Haz clic en Guardar.

Cómo configurar la captura de rendimiento

Puedes configurar la captura del rendimiento, por ejemplo, definir umbrales de activación específicos, cuando creas o editas la instancia con gcloud CLI o la API de Cloud SQL Admin. Si modificas la configuración de la captura de rendimiento o un umbral de activación de la captura de rendimiento, no se reiniciará la instancia ni se pondrá en mantenimiento.

En el siguiente procedimiento, se describe cómo editar una instancia existente para configurar la captura del rendimiento.

gcloud

Para configurar la captura del rendimiento en una instancia de Cloud SQL existente, ejecuta el siguiente comando:

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

Para la marca performance-capture-config, incluye enabled=true. Para la misma marca, puedes especificar configuraciones opcionales para PROBE_CONFIGURATION y para PERFORMANCE_CAPTURE_THRESHOLDS.

También puedes usar el comando gcloud sql instances patch para modificar los valores de configuración del umbral para la captura del rendimiento en una instancia existente.

Configura el intervalo de sondeo y los sondeos consecutivos de las métricas de rendimiento

Puedes reemplazar PROBE_CONFIGURATION por uno o ambos de los siguientes parámetros de configuración de marcas. Si no configuras las marcas, el agente de supervisión usará el valor predeterminado.

probing-interval-seconds=SECONDS: Es un número entero entre 20 y 86400. Es el intervalo de tiempo, en segundos, entre los sondeos de métricas. Por ejemplo, 30, 60, 100. El valor predeterminado es 30.
probe-threshold=PROBES: Es la cantidad de veces consecutivas que se debe superar un umbral para activar una captura del rendimiento. El rango válido es de 1 a 20. El valor predeterminado es 3.

Configura los umbrales de captura del rendimiento

Puedes reemplazar PERFORMANCE_CAPTURE_THRESHOLDS con uno o más de los siguientes parámetros de configuración de marcas. Si no estableces valores para las marcas, el agente de supervisión usará los valores predeterminados para los umbrales. Para obtener información más detallada sobre los activadores establecidos por estas marcas, consulta Activadores de captura de rendimiento.

running-threads-threshold=THREADS: Para instancias principales o de réplica, es la cantidad mínima de subprocesos activos que se consideran por encima del umbral. Por ejemplo, 10 Debe ser mayor o igual que 10. Si no se configura, el valor predeterminado se basa en el tamaño de la instancia. El valor predeterminado es MIN(600, cpuCount * 20).
seconds-behind-source-threshold=SECONDS : Para las réplicas de lectura, es el rezago de replicación mínimo, en segundos, que se considera que supera el umbral. Debe ser mayor que 1. El valor predeterminado es 900.
transaction-duration-threshold=SECONDS: Es la duración, en segundos, de una transacción no confirmada antes de que se haga un seguimiento de la transacción y se incluya en un registro de captura de rendimiento. Por ejemplo, 300 El valor mínimo es 60. El valor predeterminado es 3600. También tienes la opción de finalizar automáticamente las transacciones de larga duración.
cpu-utilization-threshold-percent=CPU_PERCENTAGE: Es el porcentaje de uso general de la CPU que se debe superar de forma constante. Por ejemplo, 90 El valor mínimo es 10 y el máximo es 99. El valor predeterminado es 0, que está inhabilitado.
memory-usage-threshold-percent=MEMORY_PERCENTAGE: Es el porcentaje de uso general de la memoria que se debe superar de forma constante. Por ejemplo, 90 El valor mínimo es 10 y el máximo es 99. El valor predeterminado es 0, que está inhabilitado.
transaction-lock-wait-threshold-count=TRANSACTION_COUNT: Es el umbral para las transacciones que pueden estar en estado "LOCK WAIT". Por ejemplo, 50 El valor mínimo es 10 y el máximo es 10000. El valor predeterminado es 0, que está inhabilitado.
semaphore-wait-threshold-count=SEMAPHORE_THREAD_COUNT: Es el umbral para la cantidad de subprocesos que esperan en los semáforos de InnoDB del comando SHOW ENGINE INNODB STATUS. Por ejemplo, 20. El valor mínimo es 10 y el máximo es 10000. El valor predeterminado es 0, que está inhabilitado.
history-list-length-threshold-count=HISTORY_LIST_LENGTH_COUNT: Es el umbral para el recuento de la longitud de la lista del historial de InnoDB (HLL) que se permite para la base de datos. Por ejemplo, 100000 El valor mínimo es 10000 y el máximo es 10000000. El valor predeterminado es 0, que está inhabilitado.

REST v1

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

En el campo performanceCaptureConfig, incluye los siguientes parámetros de configuración de la marca. Si no estableces valores para las marcas, la captura del rendimiento usará los valores predeterminados para los umbrales. Para obtener información más detallada sobre los activadores establecidos por estas marcas, consulta Activadores de captura del rendimiento.

PERFORMANCE_CAPTURE_ENABLED: Se establece en true para habilitar la captura del rendimiento de tu instancia.
PROBING_INTERVAL_SECONDS: Es un número entero entre 30 y 86400. Es el intervalo de tiempo, en segundos, entre las sondas de métricas. El valor predeterminado es 30.
PROBE_THRESHOLD: Es la cantidad de veces consecutivas que se debe superar un umbral para activar una captura de rendimiento. El rango válido es de 1 a 20. El valor predeterminado es 3.
RUNNING_THREADS_THRESHOLD: Para las instancias principales, es la cantidad mínima de hilos activos que se consideran por encima del umbral. Por ejemplo, 10 Debe ser mayor o igual que 10. Si no se configura, el valor predeterminado se basa en el tamaño de la instancia. El valor predeterminado es MIN(600, cpuCount * 20).
SECONDS_BEHIND_SOURCE_THRESHOLD: En el caso de las réplicas de lectura, es el retraso de replicación mínimo, en segundos, que se considera que supera el umbral. Debe ser mayor que 1. El valor predeterminado es 900.
TRANSACTION_DURATION_THRESHOLD: Es la duración, en segundos, de una transacción no confirmada antes de que se haga un seguimiento de la transacción y se incluya en un registro de captura de rendimiento. Por ejemplo, 300 El valor mínimo es 60. El valor predeterminado es 3600. Si deseas configurar el final automático de las transacciones de larga duración, puedes incluir parámetros de configuración adicionales en el campo performanceCaptureConfig. Para obtener más información, consulta Cómo finalizar automáticamente las transacciones de larga duración.
CPU_UTILIZATION_THRESHOLD_PERCENT: Es el porcentaje de uso general de la CPU que se debe superar de forma constante. Por ejemplo, 90 El valor mínimo es 10 y el máximo es 99. El valor predeterminado es 0, que está inhabilitado.
MEMORY_USAGE_THRESHOLD_PERCENT: Es el porcentaje de uso general de la memoria que se debe superar de forma constante. Por ejemplo, 90 El valor mínimo es 10 y el máximo es 99. El valor predeterminado es 0, que está inhabilitado.
TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: Es el umbral para las transacciones que pueden estar en un estado LOCK WAIT. Por ejemplo, 50. El valor mínimo es 10 y el máximo es 10000. El valor predeterminado es 0, que está inhabilitado.
SEMAPHORE_WAIT_THRESHOLD_COUNT: Es el umbral para la cantidad de subprocesos que esperan en los semáforos de InnoDB del comando SHOW ENGINE INNODB STATUS. Por ejemplo, 20. El valor mínimo es 10 y el máximo es 10000. El valor predeterminado es 0, que está inhabilitado.
HISTORY_LIST_LENGTH_THRESHOLD_COUNT: Es el umbral para el recuento de la longitud de la lista del historial de InnoDB (HLL) que se permite para la base de datos. Por ejemplo, 100000 El valor mínimo es 10000 y el máximo es 10000000. El valor predeterminado es 0, que está inhabilitado.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "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 tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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 cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

En el campo performanceCaptureConfig, incluye los siguientes parámetros de configuración de la marca. Si no estableces valores para las marcas, el agente de supervisión usará los valores predeterminados para los umbrales. Para obtener información más detallada sobre los activadores establecidos por estas marcas, consulta Activadores de captura del rendimiento.

PERFORMANCE_CAPTURE_ENABLED: Se establece en true para habilitar la captura del rendimiento de tu instancia.
PROBING_INTERVAL_SECONDS: Es un número entero entre 30 y 86400. Es el intervalo de tiempo, en segundos, entre las sondas de métricas. El valor predeterminado es 30.
PROBE_THRESHOLD: Es la cantidad de veces consecutivas que se debe superar un umbral para activar una captura de rendimiento. El rango válido es de 1 a 20. El valor predeterminado es 3.
RUNNING_THREADS_THRESHOLD: Para las instancias principales, es la cantidad mínima de hilos activos que se consideran por encima del umbral. Por ejemplo, 10. Debe ser mayor o igual que 10. Si no se configura, el valor predeterminado se basa en el tamaño de la instancia. El valor predeterminado es MIN(600, cpuCount * 20).
SECONDS_BEHIND_SOURCE_THRESHOLD: En el caso de las réplicas de lectura, es el retraso de replicación mínimo, en segundos, que se considera que supera el umbral. Debe ser mayor que 1. El valor predeterminado es 900.
TRANSACTION_DURATION_THRESHOLD: Es la duración, en segundos, de una transacción no confirmada antes de que se haga un seguimiento de la transacción y se incluya en un registro de captura de rendimiento. Por ejemplo, 300 El valor mínimo es 60. El valor predeterminado es 3600. Si deseas configurar el final automático de las transacciones de larga duración, puedes incluir parámetros de configuración adicionales en el campo performanceCaptureConfig. Para obtener más información, consulta Cómo finalizar automáticamente las transacciones de larga duración.
CPU_UTILIZATION_THRESHOLD_PERCENT: Es el porcentaje de uso general de la CPU que se debe superar de forma constante. Por ejemplo, 90 El valor mínimo es 10 y el máximo es 99. El valor predeterminado es 0, que está inhabilitado.
MEMORY_USAGE_THRESHOLD_PERCENT: Es el porcentaje de uso general de la memoria que se debe superar de forma constante. Por ejemplo, 90 El valor mínimo es 10 y el máximo es 99. El valor predeterminado es 0, que está inhabilitado.
TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: Es el umbral para las transacciones que pueden estar en estado LOCK WAIT. Por ejemplo, 50. El valor mínimo es 10 y el máximo es 10000. El valor predeterminado es 0, que está inhabilitado.
SEMAPHORE_WAIT_THRESHOLD_COUNT: Es el umbral para la cantidad de subprocesos que esperan en los semáforos de InnoDB del comando SHOW ENGINE INNODB STATUS. Por ejemplo, 20. El valor mínimo es 10 y el máximo es 10000. El valor predeterminado es 0, que está inhabilitado.
HISTORY_LIST_LENGTH_THRESHOLD_COUNT: Es el umbral para el recuento de la longitud de la lista del historial de InnoDB (HLL) que se permite para la base de datos. Por ejemplo, 100000 El valor mínimo es 10000 y el máximo es 10000000. El valor predeterminado es 0, que está inhabilitado.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "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 tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Finaliza automáticamente las transacciones de larga duración

Puedes usar la captura de rendimiento para finalizar cualquier transacción que supere una duración predefinida, lo que puede ayudarte a evitar consultas descontroladas que pueden desestabilizar tu instancia.

Para configurar tu base de datos de Cloud SQL para MySQL de modo que finalice automáticamente las transacciones de larga duración, usa la CLI de gcloud o la API de Cloud SQL Admin.

gcloud

Para habilitar la finalización automática de transacciones de larga duración, debes establecer el límite de umbral para las transacciones. Para configurar el final automático de las transacciones, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

INSTANCE_NAME: El nombre de la instancia.
SECONDS: Es el límite de duración, en segundos, para finalizar automáticamente la transacción de larga duración. Este límite no se puede establecer en un valor inferior al que estableciste para el activador transaction-duration-threshold o transactionDurationThreshold.

También puedes especificar el tipo de transacciones que se finalizarán automáticamente (el valor predeterminado es READ_ONLY_TRANSACTIONS) y personalizar una lista de usuarios o hosts de transacciones específicos para eximir. Para configurar estas opciones, ejecuta el siguiente 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"

Reemplaza lo siguiente:

TRANSACTION_TYPE: Determina las categorías de transacciones que se finalizarán. Especifica uno de los siguientes valores:
- READ_ONLY_TRANSACTIONS: Finaliza solo las búsquedas de SELECT o de solo lectura. Este es el valor predeterminado si no se especifica transaction-kill-type.
- ALL_TRANSACTIONS: Finaliza cualquier consulta en ejecución que supere el umbral, incluidas las consultas con operaciones de escritura. Esto incluye INSERT, UPDATE, DELETE y otras instrucciones DDL.
EXCLUSION_LIST: Es una lista de cadenas para excluir. Puedes proporcionar las entradas con una combinación específica de nombre de usuario y host de la base de datos, como user@host, o como un nombre de cuenta de usuario de estilo MySQL, que tiene el valor predeterminado user@%. La lista admite los comodines % y _ para la coincidencia en la parte del host.

Por ejemplo, puedes ejecutar el siguiente comando para configurar el final automático de _todas las transacciones_, incluidas todas las transacciones de lectura y escritura, pero excluir a los usuarios conocidos específicos de las transacciones de larga duración.

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 cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

SECONDS: Es la duración, en segundos, de las transacciones de larga duración que se finalizarán automáticamente. Este límite no se puede establecer en un valor inferior al que estableciste para el campo transactionDurationThreshold.
TRANSACTION_TYPE: Determina las categorías de transacciones que se finalizarán. Usa uno de los siguientes valores:
- READ_ONLY_TRANSACTIONS: Finaliza solo las búsquedas de SELECT o de solo lectura. Este es el valor predeterminado si no se especifica transactionKillType.
- ALL_TRANSACTIONS: Finaliza cualquier consulta en ejecución que supere el umbral, incluidas las consultas con operaciones de escritura. Esto incluye INSERT, UPDATE, DELETE y otras instrucciones DDL.
EXCLUSION_LIST: Es una lista de cadenas para excluir. Puedes proporcionar las entradas con una combinación específica de nombre de usuario y host de la base de datos, como user@host, o como un nombre de cuenta de usuario de estilo MySQL, que se establece de forma predeterminada en user@%. La lista admite los comodines % y _ para la coincidencia en la parte del host.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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 cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

SECONDS: Es la duración, en segundos, de las transacciones de larga duración que se finalizarán automáticamente. Este límite no se puede establecer en un valor inferior al que estableciste para el campo transactionDurationThreshold.
TRANSACTION_TYPE: Determina las categorías de transacciones que se finalizarán. Usa uno de los siguientes valores:
- READ_ONLY_TRANSACTIONS: Finaliza solo las búsquedas de SELECT o de solo lectura. Este es el valor predeterminado si no se especifica transactionKillType.
- ALL_TRANSACTIONS: Finaliza cualquier consulta en ejecución que supere el umbral, incluidas las consultas con operaciones de escritura. Esto incluye INSERT, UPDATE, DELETE y otras instrucciones DDL.
EXCLUSION_LIST: Es una lista de cadenas para excluir. Puedes proporcionar las entradas con una combinación específica de nombre de usuario y host de la base de datos, como user@host, o como un nombre de cuenta de usuario de estilo MySQL, que se establece de forma predeterminada en user@%. La lista admite los comodines % y _ para la coincidencia en la parte del host.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Inhabilita la captura de rendimiento

Para inhabilitar la captura del rendimiento, haz lo siguiente.

Console

En la consola de Cloud de Confiance , ve a la página Instancias de Cloud SQL.

Ir a Instancias de Cloud SQL
Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
Haz clic en Editar.
En la sección Personaliza tu instancia, haz clic en Mostrar opciones de configuración.
Expande Estadísticas de consultas.
En la sección Habilita funciones adicionales, desmarca la casilla de verificación Captura de rendimiento.
Haz clic en Guardar.

gcloud

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

Reemplaza INSTANCE_NAME por el nombre de la instancia en la que deseas inhabilitar la captura del rendimiento.

REST v1

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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 y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Cómo configurar la captura de rendimiento

Lineamientos para configurar activadores de captura de rendimiento

Antes de comenzar

Roles obligatorios

Habilita la captura de rendimiento

Cómo configurar la captura de rendimiento

gcloud

Configura el intervalo de sondeo y los sondeos consecutivos de las métricas de rendimiento

Configura los umbrales de captura del rendimiento

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Finaliza automáticamente las transacciones de larga duración

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Inhabilita la captura de rendimiento

Console

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

¿Qué sigue?