Afficher les journaux de capture des performances

L'enregistrement des performances collecte et envoie les données de 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 la page Afficher les journaux à l'aide de l'explorateur de journaux.

Avant de commencer

Pour afficher les journaux d'enregistrement 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 requis

Pour obtenir les autorisations nécessaires pour afficher les journaux d'enregistrement 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 via des rôles personnalisés ou d'autres rôles prédéfinis.

Afficher les journaux d'enregistrement des performances

Pour afficher les journaux d'enregistrement des performances, procédez comme suit :

  1. Dans la Google Cloud console, 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 par nom de journal :

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

    Remplacez PROJECT_ID par l'ID de votre 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 dans un journal d'enregistrement des performances

Chaque journal d'enregistrement 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 d'enregistrement des performances avec les seuils de configuration et fournit une description du rapport sur les données de performances que vous pouvez afficher dans le journal d'entrée.

Entrée de journal d'enregistrement des performances Description Conditions de déclenchement 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, 2 à 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 localiser des requêtes lentes spécifiques.

Pour en savoir plus sur l'interprétation des données concernant les transactions et les processus InnoDB, consultez les pages The INFORMATION_SCHEMA INNODB_TRX Table (Table ) et The processlist Table (Table processlist) dans la documentation MySQL.
  • Utilisation élevée du processeur
  • Utilisation élevée de la mémoire
  • Utilisation élevée des fichiers temporaires
  • Longueur de la liste d'historique
  • Threads en cours d'exécution
  • Attentes de sémaphore
  • Attentes de verrouillage de transaction
 activequeries
État InnoDB Fournit des informations sur l'état du moteur de stockage InnoDB au moment de l'événement de performances. Ces informations sont essentielles pour diagnostiquer les conflits de verrouillage, les problèmes de transaction, les problèmes de pool de mémoire tampon et la croissance de la longueur de la liste d'historique. Mots clés à rechercher :
  • TRANSACTIONS (transactions de longue durée, attentes de verrouillage)
  • SEMAPHORES (conflit de mutex)
  • LATEST DETECTED DEADLOCK
  • BUFFER POOL AND MEMORY
  • HISTORY LIST LENGTH
Pour en savoir plus sur la sortie du moniteur standard InnoDB, consultez la page InnoDB Standard Monitor and Lock Monitor Output (Sortie de surveillance standard et surveillance des verrous InnoDB) dans la documentation MySQL. 		innodbstatus
Analyse de la réplication Contient des informations de diagnostic de la réplication, y compris la sortie de SHOW REPLICA STATUS, les ensembles GTID et les détails des outils de 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 de SHOW REPLICA STATUS et les threads d'application de réplica, consultez les pages SHOW REPLICA STATUS Statement et Monitoring Replication Applier Worker Threads dans la documentation MySQL.
  • Erreur de thread d'E/S SQL de réplica
  • Secondes de retard par rapport à la source
 replicastatus
Analyse des transactions Détails sur les transactions de longue durée suivies.

Pour en savoir plus sur l'interprétation des données concernant les transactions InnoDB, consultez la page The INFORMATION_SCHEMA INNODB_TRX Table dans la documentation MySQL. 		Transactions de longue durée LongRunningTransactions
Transactions arrêtées automatiquement Détails sur les transactions de longue durée arrêtées lors du cycle de sondage actuel.

Données d'arrêt automatique AutoTerminateTransaction

Filtrer les données dans un journal d'enregistrement des performances

Lorsque l'enregistrement 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 d'enregistrement des performances par libellé.

Chaque entrée de journal est libellée avec les deux libellés suivants :

  • Heure de l'événement, ou labels.EVENT_TIME : indique l'heure du journal d'entrée d'enregistrement 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 d'enregistrement des performances déclenchée par un événement de performances. Le format est INSTANCE_TYPE_SEQUENCE_NUMBER_REPORT_TYPE. Par exemple, primary_1_activequeries, qui correspond à la première entrée de journal d'enregistrement 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 à des fins d'analyse.

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

  • PROJECT_ID : ID du projet de l'instance Cloud SQL
  • TIMESTAMP: horodatage 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 pour 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 le 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 sur plusieurs 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 premier et troisième 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: horodatage de l'événement de performances déclencheur au format YYYY-MM-DDTHH:MM:SSZ. Par exemple, 2025-10-16T13:12:07Z

Rechercher 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: horodatage au format YYYY-MM-DDTHH:MM:SSZ. Par exemple, 2025-10-16T13:12:07Z

Rechercher un texte spécifique dans n'importe quel rapport d'état 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. Par exemple, SEMAPHORE WAITS