Documentation sur Oracle Cloud Infrastructure

Télémétrie MySQL et OCI Log Analytics

Exporte les journaux du serveur MySQL vers OCI Log Analytics.

La télémétrie fournit une méthode pratique pour afficher et analyser les journaux du serveur MySQL à l'aide du service OCI Log Analytics au lieu de s'appuyer uniquement sur le client de ligne de commande MySQL.

Préalables

Préalables à l'envoi des journaux MySQL vers OCI Log Analytics.

Pour envoyer des journaux MySQL à Log Analytics pour OCI, assurez-vous des éléments suivants :

  • Vous avez accès au service OCI Log Analytics et aux autorisations appropriées.
    Note

    Log Analytics est un service facturable. Il n'est pas inclus dans votre abonnement au service MySQL HeatWave et doit être activé séparément. Pour plus d'informations, voir Log Analytics.
  • Vous avez créé au moins un groupe de journaux Log Analytics. Cette opération est requise pour stocker les journaux MySQL.
  • Votre système de base de données exécute MySQL version 9.6.1 ou supérieure.
  • Votre système de base de données est autonome. L'exportation des journaux MySQL vers OCI Log Analytics n'est actuellement pas prise en charge par les systèmes de base de données à haute disponibilité ou les systèmes de base de données avec des répliques de lecture.
  • Votre système de base de données n'est pas de niveau Toujours gratuit, car il n'a pas accès à Log Analytics.
  • Vous avez défini des politiques IAM telles que décrites dans les politiques.
  • Pour enregistrer des énoncés SQL dans le journal de vérification, vous devez définir des filtres de journal de vérification. Voir Filtrage des journaux de vérification.

Journaux MySQL

Exporte les journaux du serveur MySQL vers OCI Log Analytics ou vers des points d'extrémité OpenTelemetry personnalisés.

Les journaux suivants peuvent être exportés :

  • Journal d'erreurs : Contient un enregistrement des temps de démarrage et d'arrêt de mysqld. Il contient également des messages de diagnostic tels que des erreurs, des avertissements et des notes qui se produisent au démarrage et à l'arrêt du serveur, et pendant son exécution.
  • Journal d'interrogation lente : Se compose d'énoncés SQL dont l'exécution prend plus de long_query_time secondes et qui nécessitent au moins min_examined_row_limit rangées à examiner. Le journal d'interrogation lent peut être utilisé pour rechercher les interrogations dont l'exécution prend beaucoup de temps et qui sont donc susceptibles d'être optimisées.
  • Journal de vérification : Contient les détails de connexion et de déconnexion du client, ainsi que les actions qu'ils effectuent lorsqu'ils sont connectés, telles que les bases de données et les tables auxquelles ils accèdent.
  • Journal général : Enregistrement général de l'activité de mysqld. Le serveur écrit les informations dans ce journal lorsque les clients se connectent ou se déconnectent, et enregistre chaque instruction SQL reçue des clients.

Affichage des journaux MySQL dans OCI Log Analytics

Vous pouvez voir les journaux MySQL configurés dans l'explorateur de journaux Log Analytics pour OCI.

Cette tâche suppose que vous avez configuré tous les préalables requis.
  1. Naviguez jusqu'à l'explorateur de journaux OCI Log Analytics.
  2. Sélectionnez le compartiment approprié dans le filtre et cliquez sur Apply.
  3. Les sources de journaux Ouvrir les journaux de télémétrie et Journaux JSON de vérification MySQL Database sont affichés dans le tableau Source de journaux.
    Journaux de télémétrie ouverts contient les journaux d'erreurs, généraux et d'interrogation lente, et Journaux JSON de vérification MySQL Database contient les journaux de vérification.

Affichage de la télémétrie MySQL et de la table Log Analytics pour OCI

La télémétrie MySQL et la table Log Analytics pour OCI stockent les données de surveillance des journaux exportés dans le schéma de performance de MySQL Server.

Utilisation d'un client de ligne de commande

Utilisez un client de ligne de commande tel que le client MySQL ou l'interpréteur de commandes MySQL pour voir la télémétrie MySQL et la table Log Analytics pour OCI.

Cette tâche nécessite les éléments suivants :
  1. Pour l'interpréteur de commandes MySQL, passez en mode SQL en entrant la commande \sql.
  2. Entrez l'instruction SQL suivante, en indiquant la table à afficher :
    SELECT * FROM performance_schema.<table_name>;

    Par exemple, pour voir le statut des journaux exportés, utilisez la commande SQL suivante :

    SELECT * FROM performance_schema.telemetry_oci_export_status;
    Note

    Pour voir la liste complète des tables, vous pouvez spécifier dans <table_name>, voir Télémétrie MySQL et table Log Analytics pour OCI.
Vous obtenez une réponse similaire à la suivante :
+--------------+---------------+----------------------+--------------------+------------------------+----------------------+-----------------+--------------------+-----------------------+
| CHANNEL_NAME | SERVICE_STATE | EXPORT_SUCCESS_COUNT | EXPORT_ERROR_COUNT | LAST_SUCCESS_TIMESTAMP | LAST_ERROR_TIMESTAMP | LAST_ERROR_CODE | LAST_ERROR_MESSAGE | LAST_ERROR_REQUEST_ID |
+--------------+---------------+----------------------+--------------------+------------------------+----------------------+-----------------+--------------------+-----------------------+
| ERROR_LOG    | OFF           |                    0 |                  0 | NULL                   | NULL                 | NULL            | NULL               | NULL                  |
| GENERAL_LOG  | OFF           |                    0 |                  0 | NULL                   | NULL                 | NULL            | NULL               | NULL                  |
| SLOW_LOG     | OFF           |                    0 |                  0 | NULL                   | NULL                 | NULL            | NULL               | NULL                  |
+--------------+---------------+----------------------+--------------------+------------------------+----------------------+-----------------+--------------------+-----------------------+

Télémétrie MySQL et table Log Analytics pour OCI

Le schéma de performance comprend les tables suivantes de télémétrie MySQL et Log Analytics pour OCI :

table performance_schema.telemetry_oci_export_status

Tableau 17-14 : telemetry_oci_export_status Performance Schema Table

Colonne Description
CHANNEL_NAME Indique quels types de journal ont été envoyés à OCI Log Analytics.

Les valeurs valides sont : ERROR_LOG, GENERAL_LOG et SLOW_LOG.

SERVICE_STATE Indique si les données sont collectées pour chaque type de journal.
EXPORT_SUCCESS_COUNT Indique le nombre d'exportations réussies.
EXPORT_ERROR_COUNT Indique le nombre d'exportations ayant échoué.
LAST_SUCCESS_TIMESTAMP Horodatage de la dernière exportation réussie.
LAST_ERROR_TIMESTAMP Horodatage de la dernière exportation en échec.
LAST_ERROR_CODE Code d'erreur de la dernière exportation en échec.
LAST_ERROR_MESSAGE Message d'erreur de la dernière exportation en échec.
LAST_ERROR_REQUEST_ID ID demande de l'appel de l'API REST OCI Log Analytics pour le dernier échec d'exportation, le cas échéant.

Affichage de la télémétrie MySQL et des variables de statut Log Analytics pour OCI

Les variables de statut MySQL Telemetry et Log Analytics pour OCI sont des indicateurs statiques qui vous permettent de surveiller le statut des différents composants de MySQL Telemetry et Log Analytics pour OCI. Vous ne pouvez pas modifier les valeurs de ces variables.

Utilisation d'un client de ligne de commande

Utilisez un client de ligne de commande tel que le client MySQL ou l'interpréteur de commandes MySQL pour voir les variables de statut et leurs valeurs.

Cette tâche nécessite les éléments suivants :
Pour afficher les variables du moniteur d'état, procédez comme suit :
  1. Pour l'interpréteur de commandes MySQL, passez en mode SQL en entrant la commande \sql.
  2. Entrez l'instruction SQL suivante :
    show status like '<variable_name>';

    Par exemple :

    show status like 'telemetry_oci.run_level';
Vous obtenez une réponse similaire à la suivante :
+-------------------------+-----------+
| Variable_name           | Value     |
+-------------------------+-----------+
| telemetry_oci.run_level | CONFIGURE |
+-------------------------+-----------+

Variables de statut de télémétrie MySQL et Log Analytics pour OCI

Tableau 17-15 : Variables de statut de télémétrie MySQL et OCI Log Analytics

Variable de système Description Valeurs possibles
log_offload.log_analytics_last_error_code Code d'erreur de la dernière exportation en échec. Valeur de chaîne.
log_offload.log_analytics_last_error_message Message d'erreur de la dernière exportation en échec. Valeur de chaîne.
log_offload.log_analytics_last_error_opc_request_id ID demande de l'appel de l'API REST OCI Log Analytics pour le dernier échec d'exportation. Une valeur de chaîne, similaire à l'exemple suivant : /C8DBC62DADE6ECAC222ABF9CAABBC11C/13B10A00F071D7C39DAE333C3CB0DCD8
log_offload.log_analytics_last_error_timestamp Horodatage de la dernière exportation en échec. Valeur de chaîne indiquant l'heure locale avec 6 décimales microsecondes, comme dans l'exemple suivant : 2025-01-29 04:46:44.009907.
log_offload.log_analytics_ops_skipped Indique le nombre de fichiers ignorés lors de l'exportation. Une valeur entière.
telemetry_oci.exports_failed_error_log Indique le nombre d'exportations en échec pour le journal d'erreurs. Une valeur entière.
telemetry_oci.exports_failed_general_log Indique le nombre d'exportations en échec pour le journal général. Une valeur entière.
telemetry_oci.exports_failed_slow_log Indique le nombre d'exportations en échec pour le journal général. Une valeur entière.
telemetry_oci.exports_success_error_log Indique le nombre d'exportations réussies pour le journal d'erreurs. Une valeur entière.
telemetry_oci.exports_success_general_log Indique le nombre d'exportations réussies pour le journal général. Une valeur entière.
telemetry_oci.exports_success_slow_log Indique le nombre d'exportations réussies pour le journal lent. Une valeur entière.
telemetry_oci.run_level Indique l'état du composant.
  • BOOT : Le composant est en cours de chargement et l'initialisation a commencé. Cet état est transitoire.
  • CONFIGURE : Le composant est prêt pour configuration.
  • READY : Configuration réussie.
  • FAILED : Échec de la configuration.
  • UNINSTALL : Le composant est en cours de désinstallation, puis de déchargement.