Afficher les journaux de capture des performances

La capture des performances collecte et envoie les données des métriques d'instance à Cloud Logging dans le fichier mysql-performance-capture.log.

Pour en savoir plus sur l'affichage des journaux dans Cloud Logging, consultez Afficher les journaux à l'aide de l'explorateur de journaux.

Avant de commencer

Pour afficher les journaux de capture des performances, vous devez disposer des autorisations appropriées pour afficher les journaux dans Cloud Logging pour votre projet et votre instance.

Rôles et autorisations nécessaires

Pour obtenir les autorisations nécessaires pour afficher les journaux de capture des performances, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de journaux (roles/logging.viewer) sur le projet de l'instance. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Afficher les journaux de capture des performances

Pour afficher les journaux de capture des performances, procédez comme suit :

  1. Dans la console Cloud de Confiance , accédez à la page Cloud Logging.

    Accéder à Cloud Logging

  2. Cliquez sur Toutes les ressources, puis sélectionnez Base de données Cloud SQL.
  3. Sélectionnez votre instance Cloud SQL.

  4. Filtrez les résultats pour ne conserver que le nom du journal :

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

    Remplacez PROJECT_ID par l'ID du projet.

    La charge utile du journal est au format chaîne et contient la sortie des commandes capturées, telles que SHOW ENGINE INNODB STATUS, qui s'étendent sur plusieurs lignes de journal.

Examiner les données d'un journal de capture des performances

Chaque journal de capture des performances est déclenché par un événement de performances que vous avez défini pour votre instance. Le tableau suivant met en corrélation les entrées de journal de capture des performances avec les seuils de configuration et fournit une description du rapport sur les données de performances que vous pouvez consulter dans le journal des entrées.

Entrée de journal de capture des performances Description Déclencheur de seuil Nom du rapport
Requêtes actives Capture les métriques de charge de la base de données, y compris le nombre de connexions et de transactions regroupées par état, le nombre de requêtes actives regroupées par durée d'exécution (< 2 secondes, entre 2 et 10 secondes, ≥ 10 secondes) et des informations détaillées sur les 50 transactions ou requêtes les plus longues. Ce rapport permet d'identifier les périodes de forte charge et de repérer les requêtes lentes spécifiques.

Pour savoir comment interpréter les données sur les transactions et les processus InnoDB, consultez les sections Table INFORMATION_SCHEMA INNODB_TRX et Table processlist dans la documentation MySQL.
  • runningThreadsThreshold (API Cloud SQL Admin)
  • running-threads-threshold (gcloud CLI)
 activequeries
État InnoDB Fournit des informations sur l'état du moteur de stockage InnoDB au moment de l'événement de performances. Cela est essentiel pour diagnostiquer les conflits de verrouillage, les problèmes de transaction, les problèmes de pool de mémoire tampon et l'augmentation de la longueur de la liste d'historique. Mots clés à rechercher :
  • TRANSACTIONS (transactions de longue durée, attentes de verrouillage)
  • SEMAPHORES (concurrence de mutex)
  • LATEST DETECTED DEADLOCK
  • BUFFER POOL AND MEMORY
  • HISTORY LIST LENGTH
Pour en savoir plus sur la sortie du moniteur standard InnoDB, consultez Sortie de surveillance standard et surveillance des verrous InnoDB dans la documentation MySQL.
  • runningThreadsThreshold (API Cloud SQL Admin)
  • running-threads-threshold (gcloud CLI)
 innodbstatus
Analyse de la réplication Contient des informations de diagnostic sur la réplication, y compris la sortie de SHOW REPLICA STATUS, les ensembles GTID et les détails des outils du schéma de performances. Le rapport inclut également les cinq premiers événements du journal de relais suivant la position d'exécution au moment de l'événement de performances. Ce rapport peut être utilisé pour diagnostiquer les erreurs ou les retards de réplication.

Pour en savoir plus sur la sortie SHOW REPLICA STATUS et les threads d'application des répliques, consultez les pages Instruction SHOW REPLICA STATUS et Surveillance des threads de travail de l'application de la réplication dans la documentation MySQL.
  • secondsBehindSourceThreshold (API Cloud SQL Admin)
  • seconds-behind-source-threshold (gcloud CLI)
 replicastatus
Données de l'outil de surveillance des transactions Détails sur les transactions de longue durée suivies.

Pour savoir comment interpréter les données sur les transactions InnoDB, consultez Table INFORMATION_SCHEMA INNODB_TRX dans la documentation MySQL.
  • transactionDurationThreshold (API Cloud SQL Admin)
  • transaction-duration-threshold (gcloud CLI)
 LongRunningTransactions

Filtrer les données d'un journal de capture des performances

Lorsque la capture des performances détecte un problème en fonction d'un seuil configuré pour votre instance Cloud SQL, l'agent de surveillance envoie des entrées de journal libellées associées à l'instance et au type de rapport à Cloud Logging.

Pour vous aider à trier les journaux et à mettre en corrélation les entrées de journal avec les problèmes de performances observés pour votre instance, vous pouvez filtrer les entrées de journal de capture des performances par libellé.

Chaque entrée de journal est associée aux deux libellés suivants :

  • Heure de l'événement ou labels.EVENT_TIME : indique l'heure de l'entrée de journal de capture des performances. Le format est une chaîne d'horodatage unique YYYY-MM-DDTHH:MM:SSZ. Par exemple, 2025-10-16T13:12:07Z.

  • Nom de fichier ou labels.FILE_NAME : identifie le type de rapport et le numéro de séquence de l'entrée de journal de capture des performances déclenchée par un événement de performances. Il a le format suivant : INSTANCE_TYPE_SEQUENCE_NUMBER_REPORT_TYPE. Par exemple, primary_1_activequeries, qui correspond à la première entrée de journal de capture des performances d'un rapport sur les requêtes actives.

Exemples de filtres

Cette section fournit des exemples de filtrage du fichier mysql-performance-capture.log pour des entrées de journal spécifiques à analyser.

Dans les exemples suivants, remplacez les éléments suivants :

  • PROJECT_ID : ID du projet de l'instance Cloud SQL
  • TIMESTAMP : code temporel de l'événement de performances déclencheur au format YYYY-MM-DDTHH:MM:SSZ. Par exemple, 2025-10-16T13:12:07Z.

Filtrer par événement de performances spécifique

Pour filtrer par événement de performances spécifique, utilisez le libellé labels.EVENT_TIME afin de trouver les entrées de journal associées.

Par exemple, pour obtenir des rapports sur un événement de performances spécifique, utilisez les requêtes suivantes dans le générateur de requêtes de l'explorateur de journaux Logging.

Obtenir tous les rapports pour un événement spécifique

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

Obtenir un rapport InnoDB pour un événement spécifique

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

Obtenir uniquement la première entrée de journal pour tous les types de rapports pour un événement spécifique

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

Filtrer les noms de fichiers

Obtenir tous les rapports activequeries pour tous les événements

Cette requête générale est utile pour voir à quoi ressemblent les requêtes actives lors d'un événement de performances.

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet de l'instance Cloud SQL

Comparer les 1er et 3e rapports innodbstatus pour un événement spécifique

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")

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet de l'instance Cloud SQL
  • TIMESTAMP : code temporel de l'événement de performances déclencheur au format YYYY-MM-DDTHH:MM:SSZ. Par exemple, 2025-10-16T13:12:07Z.

Trouver le premier rapport activequeries pour tout événement survenu après une certaine heure

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet de l'instance Cloud SQL
  • TIMESTAMP : code temporel au format YYYY-MM-DDTHH:MM:SSZ. Par exemple, 2025-10-16T13:12:07Z.

Rechercher un texte spécifique dans n'importe quel rapport sur l'état d'InnoDB

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet de l'instance Cloud SQL
  • SEARCH_TEXT : texte que vous souhaitez rechercher. Exemple : SEMAPHORE WAITS.