Cómo ver los registros de captura del rendimiento

La captura de rendimiento recopila y envía datos de métricas de instancias a Cloud Logging en el archivo mysql-performance-capture.log.

Para obtener más información sobre cómo ver registros en Cloud Logging, consulta Visualiza registros con el Explorador de registros.

Antes de comenzar

Para ver los registros de captura de rendimiento, debes tener los permisos adecuados para ver los registros en Cloud Logging de tu proyecto y tu instancia.

Roles y permisos requeridos

Para obtener los permisos que necesitas para ver los registros de captura de rendimiento, pídele a tu administrador que te otorgue el Visor de registros (roles/logging.viewer) rol de IAM en el proyecto de la instancia. 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.

Cómo ver los registros de captura de rendimiento

Para ver los registros de captura de rendimiento, haz lo siguiente:

  1. En la Cloud de Confiance consola de, ve a la página de Cloud Logging.

    Ir a Cloud Logging

  2. Haz clic en Todos los recursos y, luego, selecciona Base de datos de Cloud SQL.
  3. Selecciona tu instancia de Cloud SQL.

  4. Filtra por nombre de registro:

    logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"

    Reemplaza PROJECT_ID por el ID de tu proyecto.

    La carga útil del registro está en formato de cadena y contiene el resultado de los comandos capturados, como SHOW ENGINE INNODB STATUS, que abarca varias líneas de registro.

Cómo revisar los datos en un registro de captura de rendimiento

Cada registro de captura de rendimiento se activa mediante un evento de rendimiento que definiste para tu instancia. En la siguiente tabla, se correlacionan las entradas de registro de captura de rendimiento con los umbrales de configuración y se proporciona una descripción del informe de datos de rendimiento que puedes ver en el registro de entrada.

Entrada de registro de captura de rendimiento Descripción Activador de umbral Nombre del informe
Consultas activas Captura métricas de carga de la base de datos, incluidos los recuentos de conexión y transacción agrupados por estado, los recuentos de consultas activas agrupados por duración de ejecución (<2 segundos, de 2 a 10 segundos, ≥10 segundos) y la información detallada de las 50 transacciones o consultas de ejecución más larga. Este informe ayuda a identificar períodos de carga alta y a detectar consultas lentas específicas.

Para obtener más información sobre cómo interpretar los datos de las transacciones y los procesos de InnoDB, consulta la tabla INFORMATION_SCHEMA INNODB_TRX y la tabla processlist en la documentación de MySQL.
  • runningThreadsThreshold (API de Cloud SQL Admin)
  • running-threads-threshold (CLI de gcloud)
 activequeries
Estado de InnoDB Proporciona información sobre el estado del motor de almacenamiento InnoDB en el momento del evento de rendimiento. Esto es fundamental para diagnosticar la contención de bloqueos, los problemas de transacciones, los problemas del grupo de búferes y el crecimiento de la longitud de la lista de historial. Palabras clave para buscar:
  • TRANSACTIONS (transacciones de larga duración, esperas de bloqueo)
  • SEMAPHORES (contención de exclusión mutua)
  • LATEST DETECTED DEADLOCK
  • BUFFER POOL AND MEMORY
  • HISTORY LIST LENGTH
Para obtener más información sobre el resultado de la supervisión estándar de InnoDB, consulta Resultado de supervisión de bloqueo y supervisión estándar de InnoDB en la documentación de MySQL.
  • runningThreadsThreshold (API de Cloud SQL Admin)
  • running-threads-threshold (CLI de gcloud)
 innodbstatus
Análisis de replicación Contiene información de diagnóstico de replicación, incluido el resultado de SHOW REPLICA STATUS, los conjuntos de GTID y los detalles de las herramientas de esquema de rendimiento. El informe también incluye los primeros cinco eventos del registro de retransmisión después de la posición de ejecución en el momento del evento de rendimiento. Este informe se puede usar para diagnosticar errores o retrasos de replicación.

Para obtener más información sobre el resultado de SHOW REPLICA STATUS y los subprocesos del aplicador de réplicas, consulta la instrucción SHOW REPLICA STATUS y Supervisa los subprocesos de trabajo del aplicador de replicación en la documentación de MySQL.
  • secondsBehindSourceThreshold (API de Cloud SQL Admin)
  • seconds-behind-source-threshold (CLI de gcloud)
 replicastatus
Datos del observador de transacciones Detalles sobre las transacciones de larga duración que se están rastreando.

Para obtener más información sobre cómo interpretar los datos de las transacciones de InnoDB, consulta la INFORMATION_SCHEMA INNODB_TRX tabla en la documentación de MySQL.
  • transactionDurationThreshold (API de Cloud SQL Admin)
  • transaction-duration-threshold (CLI de gcloud)
 LongRunningTransactions

Cómo filtrar los datos en un registro de captura de rendimiento

Cuando la captura de rendimiento detecta un problema en función de un umbral configurado para tu instancia de Cloud SQL, el agente de supervisión envía entradas de registro etiquetadas asociadas con la instancia y el tipo de informe a Cloud Logging.

Para ayudarte a ordenar los registros y correlacionar las entradas de registro con los problemas de rendimiento observados para tu instancia, puedes filtrar las entradas de registro de captura de rendimiento por etiqueta.

Cada entrada de registro se etiqueta con las siguientes dos etiquetas:

  • Hora del evento o labels.EVENT_TIME: Indica la hora del registro de entrada de captura de rendimiento. El formato es una cadena de marca de tiempo única YYYY-MM-DDTHH:MM:SSZ. Por ejemplo, 2025-10-16T13:12:07Z.

  • Nombre de archivo o labels.FILE_NAME: Identifica el tipo de informe y el número de secuencia de la entrada de registro de captura de rendimiento que se activa mediante un evento de rendimiento. El formato es INSTANCE_TYPE_SEQUENCE_NUMBER_REPORT_TYPE. Por ejemplo, primary_1_activequeries, que es la primera entrada de registro de captura de rendimiento de un informe de consultas activas.

Filtros de ejemplo

En esta sección, se proporcionan ejemplos de cómo filtrar el archivo mysql-performance-capture.log para obtener entradas de registro específicas para el análisis.

En los siguientes ejemplos, reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de la instancia de Cloud SQL.
  • TIMESTAMP: Es la marca de tiempo del evento de rendimiento de activación en el formato YYYY-MM-DDTHH:MM:SSZ. Por ejemplo, 2025-10-16T13:12:07Z

Filtrar por un evento de rendimiento específico

Para filtrar por un evento de rendimiento específico, usa la etiqueta labels.EVENT_TIME para encontrar las entradas de registro relacionadas.

Por ejemplo, para obtener informes de un evento de rendimiento específico, usa las siguientes consultas en el compilador de consultas del Explorador de registros de Logging.

Obtén todos los informes de un evento específico

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.EVENT_TIME="TIMESTAMP"

Obtén el informe de InnoDB para un evento específico

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.EVENT_TIME="TIMESTAMP"
labels.FILE_NAME=~"innodbstatus"

Obtén solo la primera entrada de registro para todos los tipos de informes de un evento específico

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.EVENT_TIME="TIMESTAMP"
labels.FILE_NAME=~"_1_"

Filtrar entre nombres de archivo

Obtén todos los informes de activequeries en todos los eventos

Esta consulta general es útil para ver cómo se ven las consultas activas durante cualquier evento de rendimiento.

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.FILE_NAME=~"activequeries"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de la instancia de Cloud SQL.

Compara los informes 1º y 3º innodbstatus para un evento específico

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.EVENT_TIME="TIMESTAMP"
(labels.FILE_NAME="primary_1_innodbstatus" OR labels.FILE_NAME="primary_3_innodbstatus")

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de la instancia de Cloud SQL.
  • TIMESTAMP: Es la marca de tiempo del evento de rendimiento de activación en el formato YYYY-MM-DDTHH:MM:SSZ. Por ejemplo, 2025-10-16T13:12:07Z

Encuentra el primer informe de activequeries para cualquier evento que haya ocurrido después de un momento determinado

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.FILE_NAME="primary_1_activequeries"
timestamp > "TIMESTAMP"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de la instancia de Cloud SQL.
  • TIMESTAMP: Es la marca de tiempo en el formato YYYY-MM-DDTHH:MM:SSZ. Por ejemplo, 2025-10-16T13:12:07Z

Busca texto específico en cualquier informe de estado de InnoDB

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.FILE_NAME=~"innodbstatus"
textPayload:"SEARCH_TEXT"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de la instancia de Cloud SQL.
  • SEARCH_TEXT: Es el texto que quieres buscar. Por ejemplo, SEMAPHORE WAITS