Ver registros de captura de performance

A captura de desempenho 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 desempenho, 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 desempenho, peça ao administrador para conceder a você opapel do IAM de Leitor 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 com papéis personalizados ou outros papéis predefinidos.

Visualizar registros de captura de desempenho

Para visualizar os registros de captura de desempenho, 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, abrangendo várias linhas de registro.

Analisar os dados em um registro de captura de desempenho

Cada registro de captura de desempenho é acionado por um evento de desempenho definido para sua instância. A tabela a seguir correlaciona as entradas de registro de captura de desempenho 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 desempenho Descrição Condições de acionamento 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 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.
  • alta utilização da CPU;
  • Uso da memória elevado
  • Uso elevado de arquivos temporários
  • Comprimento da lista do histórico
  • Linhas de execução em andamento
  • Espera de semáforo
  • Espera de bloqueio de transação
 activequeries
Status do InnoDB Fornece informações sobre o estado do mecanismo de armazenamento do InnoDB no momento do evento de desempenho. Isso é fundamental para diagnosticar contenção de bloqueio, problemas de transação, problemas de pool de buffers e crescimento do comprimento da lista do histórico. Palavras-chave a serem procuradas:
  • TRANSACTIONS (transações de longa duração, espera 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. 		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 de ferramentas de esquema de desempenho. 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 desempenho. 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 linhas de execução do aplicador de réplicas, consulte Declaração SHOW REPLICA STATUS e Como monitorar linhas de execução de trabalho do aplicador de replicação na documentação do MySQL.
  • Erro de linha de execução de E/S de SQL de réplica
  • Segundos atrás da origem
 replicastatus
Análise de transação 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. 		Transações de longa duração LongRunningTransactions
Transações encerradas automaticamente Detalhes sobre as transações de longa duração encerradas no ciclo de sondagem atual.

Dados de encerramento automático AutoTerminateTransaction

Filtrar os dados em um registro de captura de desempenho

Quando a captura de desempenho 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 você a classificar os registros e correlacionar as entradas de registro com os problemas de desempenho observados na sua instância, é possível filtrar as entradas de registro de captura de desempenho 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 desempenho. 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 desempenho acionada por um evento de desempenho. O formato é INSTANCE_TYPE_SEQUENCE_NUMBER_REPORT_TYPE. Por exemplo, primary_1_activequeries, que é a primeira entrada de registro de captura de desempenho 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 desempenho de acionamento no formato YYYY-MM-DDTHH:MM:SSZ. Por exemplo, 2025-10-16T13:12:07Z

Filtrar por um evento de desempenho específico

Para filtrar por um evento de desempenho 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 desempenho 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 de todos os eventos

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

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 desempenho 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