Ver registros de captura de performance

A captura de performance coleta e envia dados de métricas de instâncias para o Cloud Logging no arquivo mysql-performance-capture.log.

Para mais informações sobre como visualizar registros no Cloud Logging, consulte Ver registros usando a Análise de registros.

Antes de começar

Para visualizar os registros de captura de performance, você precisa ter as permissões adequadas para visualizar registros no Cloud Logging do seu projeto e instância.

Papéis e permissões necessárias

Para receber as permissões necessárias para visualizar os registros de captura de performance, peça ao administrador para conceder a você o papel do IAM de Visualizador de registros (roles/logging.viewer) no projeto da instância. 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 personalizados papéis ou outros predefinidos papéis.

Visualizar registros de captura de performance

Para visualizar os registros de captura de performance, faça o seguinte:

  1. No Google Cloud console, acesse a página Cloud Logging.

    Acessar o Cloud Logging

  2. Clique em Todos os recursos e selecione Banco de dados do Cloud SQL.
  3. Selecione sua instância do Cloud SQL.

  4. Filtre pelo nome do registro:

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

    Substitua PROJECT_ID pela ID do seu projeto.

    O payload do registro está no formato de string e contém a saída de comandos capturados, como SHOW ENGINE INNODB STATUS, que abrangem várias linhas de registro.

Analisar os dados em um registro de captura de performance

Cada registro de captura de performance é acionado por um evento de performance definido para sua instância. A tabela a seguir correlaciona as entradas de registro de captura de performance com os limites de configuração e fornece uma descrição do relatório de dados de performance que pode ser visualizado no registro de entrada.

Entrada de registro de captura de performance Descrição Acionador de limite Nome do relatório
Consultas ativas Captura métricas de carga do banco de dados, incluindo contagens de conexão e transação agrupadas por estado, contagens de consultas ativas agrupadas por duração de execução (<2 segundos, 2 a 10 segundos, ≥10 segundos) e informações detalhadas para as 50 transações ou consultas mais longas. Esse relatório ajuda a identificar períodos de alta carga e a identificar consultas lentas específicas.

Para mais informações sobre como interpretar dados sobre transações e processos do InnoDB, consulte a tabela INFORMATION_SCHEMA INNODB_TRX e a tabela processlist na documentação do MySQL.
  • runningThreadsThreshold (API Cloud SQL Admin)
  • running-threads-threshold (CLI gcloud)
 activequeries
Status do InnoDB Fornece informações sobre o estado do mecanismo de armazenamento do InnoDB no momento do evento de performance. Isso é fundamental para diagnosticar contenção de bloqueio, problemas de transação, problemas de pool de buffers e crescimento do comprimento da lista de histórico. Palavras-chave a serem procuradas:
  • TRANSACTIONS (transações de longa duração, esperas de bloqueio)
  • SEMAPHORES (contenção de mutex)
  • LATEST DETECTED DEADLOCK
  • BUFFER POOL AND MEMORY
  • HISTORY LIST LENGTH
Para mais informações sobre a saída do monitor padrão do InnoDB, consulte Saída do monitor padrão e do monitor de bloqueio do InnoDB na documentação do MySQL.
  • runningThreadsThreshold (API Cloud SQL Admin)
  • running-threads-threshold (CLI gcloud)
 innodbstatus
Análise de replicação Contém informações de diagnóstico de replicação, incluindo a saída de SHOW REPLICA STATUS, conjuntos de GTID e detalhes das ferramentas de esquema de performance. O relatório também inclui os cinco primeiros eventos do registro de retransmissão após a posição de execução no momento do evento de performance. Esse relatório pode ser usado para diagnosticar erros ou atrasos de replicação.

Para mais informações sobre a saída de SHOW REPLICA STATUS e threads do aplicador de réplicas, consulte Declaração SHOW REPLICA STATUS e Como monitorar threads de trabalho do aplicador de replicação na documentação do MySQL.
  • secondsBehindSourceThreshold (API Cloud SQL Admin)
  • seconds-behind-source-threshold (CLI gcloud)
 replicastatus
Dados do observador de transações Detalhes sobre as transações de longa duração que estão sendo rastreadas.

Para mais informações sobre como interpretar dados sobre transações do InnoDB, consulte a tabela INFORMATION_SCHEMA INNODB_TRX na documentação do MySQL.
  • transactionDurationThreshold (API Cloud SQL Admin)
  • transaction-duration-threshold (CLI gcloud)
 LongRunningTransactions

Filtrar os dados em um registro de captura de performance

Quando a captura de performance detecta um problema com base em um limite configurado para sua instância do Cloud SQL, o agente de monitoramento envia entradas de registro rotuladas associadas à instância e ao tipo de relatório para o Cloud Logging.

Para ajudar a classificar os registros e correlacionar as entradas de registro com os problemas de performance observados na sua instância, é possível filtrar as entradas de registro de captura de performance por rótulo.

Cada entrada de registro é rotulada com os dois rótulos a seguir:

  • Hora do evento ou labels.EVENT_TIME: indica a hora do registro de entrada de captura de performance. O formato é uma string de carimbo de data/hora exclusiva YYYY-MM-DDTHH:MM:SSZ. Por exemplo, 2025-10-16T13:12:07Z.

  • Nome do arquivo ou labels.FILE_NAME: identifica o tipo de relatório e o número de sequência da entrada de registro de captura de performance acionada por um evento de performance. O formato é INSTANCE_TYPE_SEQUENCE_NUMBER_REPORT_TYPE. Por exemplo, primary_1_activequeries, que é a primeira entrada de registro de captura de performance de um relatório de consultas ativas.

Exemplos de filtros

Esta seção fornece exemplos de como filtrar o arquivo mysql-performance-capture.log para entradas de registro específicas para análise.

Nos exemplos a seguir, substitua:

  • PROJECT_ID: ID do projeto da instância do Cloud SQL
  • TIMESTAMP: carimbo de data/hora do evento de performance de acionamento no formato YYYY-MM-DDTHH:MM:SSZ. Por exemplo, 2025-10-16T13:12:07Z

Filtrar por um evento de performance específico

Para filtrar por um evento de performance específico, use o rótulo labels.EVENT_TIME para encontrar entradas de registro relacionadas.

Por exemplo, para receber relatórios de um evento de performance específico, use as consultas a seguir no criador de consultas da Análise de registros.

Receber todos os relatórios de um evento específico

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

Receber o relatório do InnoDB para um evento específico

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

Receber apenas a primeira entrada de registro para todos os tipos de relatório de um evento específico

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

Filtrar em nomes de arquivos

Receber todos os relatórios activequeries em todos os eventos

Essa consulta geral é útil para ver como as consultas ativas aparecem durante qualquer evento de performance.

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

Substitua:

  • PROJECT_ID: ID do projeto da instância do Cloud SQL

Comparar o 1º e o 3º innodbstatus relatórios de um 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")

Substitua:

  • PROJECT_ID: ID do projeto da instância do Cloud SQL
  • TIMESTAMP: carimbo de data/hora do evento de performance de acionamento no formato YYYY-MM-DDTHH:MM:SSZ. Por exemplo, 2025-10-16T13:12:07Z

Encontrar o primeiro relatório activequeries de qualquer evento que ocorreu após um determinado horário

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

Substitua:

  • PROJECT_ID: ID do projeto da instância do Cloud SQL
  • TIMESTAMP: carimbo de data/hora no formato YYYY-MM-DDTHH:MM:SSZ. Por exemplo, 2025-10-16T13:12:07Z

Pesquisar um texto específico em qualquer relatório de status do InnoDB

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

Substitua:

  • PROJECT_ID: ID do projeto da instância do Cloud SQL
  • SEARCH_TEXT: o texto que você quer pesquisar. Por exemplo, SEMAPHORE WAITS