Cómo ver los registros de captura del rendimiento

MySQL   |  PostgreSQL   |  SQL Server

Versión preliminar

Esta función está con sujeción a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección Términos Generales del Servicio de los Términos Específicos del Servicio. Las funciones de la fase previa a la DG están disponibles sin modificaciones y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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 rol de IAM Visualizador de registros (roles/logging.viewer) 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 consola de Google Cloud , 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 el nombre del registro:

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

   Reemplaza PROJECT_ID con el ID del 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 abarcan varias líneas de registro.

Revisa 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 conexiones y transacciones agrupados por estado, los recuentos de consultas activas agrupados por duración del tiempo de ejecución (menos de 2 segundos, de 2 a 10 segundos y más de 10 segundos) y la información detallada de las 50 transacciones o consultas de mayor duración. 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 búfer de memoria y el crecimiento de la longitud de la lista de historial. Palabras clave que debes 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 la replicación, incluido el resultado de SHOW REPLICA STATUS, los conjuntos de GTID y los detalles de las herramientas del 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 en la replicación. Para obtener más información sobre el resultado de SHOW REPLICA STATUS y los subprocesos del aplicador de réplicas, consulta las declaraciones SHOW REPLICA STATUS y cómo supervisar 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	Son los detalles de las transacciones de larga duración que se rastrean. Para obtener más información sobre cómo interpretar los datos de las transacciones de InnoDB, consulta La tabla INFORMATION_SCHEMA INNODB_TRX 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 según un umbral configurado para tu instancia de Cloud SQL, el agente de supervisión envía a Cloud Logging entradas de registro etiquetadas asociadas con la instancia y el tipo de informe.

Para ayudarte a ordenar los registros y correlacionar las entradas de registro con los problemas de rendimiento observados en 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 la 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 activó por 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 analizar entradas de registro específicas.

En los siguientes ejemplos, reemplaza lo siguiente:

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

Cómo 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 sobre 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"

Cómo obtener un 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 por 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: ID del proyecto de la instancia de Cloud SQL

Cómo comparar los informes 1 y 3 de 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: ID del proyecto de la instancia de Cloud SQL
• TIMESTAMP: Es la marca de tiempo del evento de rendimiento que activó el informe en el formato YYYY-MM-DDTHH:MM:SSZ. Por ejemplo: 2025-10-16T13:12:07Z

Cómo encontrar 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: ID del proyecto de la instancia de Cloud SQL
• TIMESTAMP: Marca de tiempo en el formato YYYY-MM-DDTHH:MM:SSZ. Por ejemplo: 2025-10-16T13:12:07Z

Cómo buscar 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: ID del proyecto de la instancia de Cloud SQL
• SEARCH_TEXT: Es el texto que deseas buscar. Por ejemplo: SEMAPHORE WAITS.