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 a Análise de registros.
Antes de começar
Para ver os registros de captura de desempenho, é preciso ter as permissões adequadas para visualizar registros no Cloud Logging para 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ê 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 papéis personalizados ou outros papéis predefinidos.
Ver registros de captura de desempenho
Para ver os registros de captura de desempenho, faça o seguinte:
-
No console Cloud de Confiance , acesse a página Cloud Logging.
- Clique em Todos os recursos e selecione Banco de dados do Cloud SQL.
- Selecione sua instância do Cloud SQL.
Filtre pelo nome do registro:
logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
Substitua PROJECT_ID pelo ID do 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 desempenho
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 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ões e transações agrupadas por estado, contagens de consultas ativas
agrupadas por duração do ambiente de execução (<2 segundos, 2 a 10 segundos, ≥10 segundos)
e informações detalhadas das 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 sobre transações e processos do InnoDB, consulte A tabela INFORMATION_SCHEMA INNODB_TRX e A tabela processlist na documentação do MySQL.
|
|
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 buffer e crescimento do tamanho da lista de histórico. Palavras-chave para procurar:
|
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 primeiros cinco eventos do registro de redirecionamento 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
as linhas de execução do aplicador de réplica, consulte
Instrução SHOW REPLICA STATUS e
Como monitorar as linhas de execução de worker do aplicador de replicação na documentação do MySQL.
|
|
replicastatus |
| Análise 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.
|
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 com os problemas de desempenho observados na 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:
Horário do evento ou
labels.EVENT_TIME: indica o horário do registro de entrada da captura de desempenho. O formato é uma string de carimbo de data/hora exclusivaYYYY-MM-DDTHH:MM:SSZ. Por exemplo,2025-10-16T13:12:07Z.Nome de 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:
- PROJECT_ID: ID do projeto da instância do Cloud SQL
- TIMESTAMP: carimbo de data/hora do evento de desempenho acionador 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 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 genérica é ú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 os relatórios de 1ª e 3ª innodbstatus para 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 acionador no formato
YYYY-MM-DDTHH:MM:SSZ. Por exemplo,2025-10-16T13:12:07Z
Encontrar o primeiro relatório activequeries de qualquer evento que tenha ocorrido 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