Ver registros de captura de performance

A captura de desempenho coleta e envia dados de métricas de instância 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 o Explorador de registros.

Antes de começar

Para ver os registros de captura de desempenho, você precisa ter as permissões adequadas para acessar os registros no Cloud Logging do projeto e da instância.

Papéis e permissões necessárias

Para receber as permissões necessárias para ver os registros de captura de desempenho, peça ao administrador para conceder a você o papel 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 usando papéis personalizados ou outros papéis predefinidos.

Ver registros de captura de performance

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

  1. No console Google Cloud , 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 a instância do Cloud SQL.

  4. Filtre o 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 performance

Cada registro de captura de desempenho é acionado por um evento de desempenho que você definiu 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 desempenho que pode ser visualizado no registro de entrada.

Entrada de registro de captura de desempenho Descrição Gatilho de limite Nome do relatório
Consultas ativas Captura métricas de carga do banco de dados, incluindo contagens de conexões e transações agrupadas por estado, contagens de consultas ativas agrupadas por duração do tempo 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 consultas lentas específicas.

Para mais informações sobre como interpretar dados de 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 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 de histórico. Palavras-chave a serem procuradas:
  • TRANSACTIONS (transações de longa duração, esperas de bloqueio)
  • SEMAPHORES (disputa 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 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 threads de aplicação de réplica, consulte Instrução SHOW REPLICA STATUS e Como monitorar threads de trabalho do aplicativo 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 de 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 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, filtre as entradas de registro de captura de desempenho por rótulo.

Cada entrada de registro é rotulada com os seguintes rótulos:

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

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

Nos exemplos a seguir, substitua o seguinte:

  • 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 e encontre entradas de registro relacionadas.

Por exemplo, para receber relatórios de um evento de desempenho específico, use as seguintes consultas no criador de consultas do Explorador de registros do Logging.

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 por nomes de arquivos

Receber todos os relatórios de activequeries em 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º relatórios innodbstatus 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 de activequeries para qualquer evento que tenha ocorrido depois de 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