Présentation des journaux de base de données Aurora MySQL - Amazon Aurora
Journaux des erreurs Aurora MySQLJournal des requêtes lentes et journal général Aurora MySQLJournal d'audit Aurora MySQLJournal d'instance Aurora MySQLRenouvellement et rétention des journaux pour Aurora MySQLPublication de journaux Aurora MySQL sur Amazon CloudWatch Logs

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Présentation des journaux de base de données Aurora MySQL

Vous pouvez surveiller les types de fichiers journaux Aurora MySQL suivants :

  • Journal des erreurs

  • Journal des requêtes lentes

  • Journal général

  • Journal d'audit

  • Journal d'instance

  • Journal des erreurs d'authentification de base de données IAM

Le journal des erreurs Aurora MySQL est généré par défaut. Vous pouvez générer le journal des requêtes lentes et le journal général en définissant les paramètres nécessaires dans votre groupe de paramètres de base de données.

Journaux des erreurs Aurora MySQL

Aurora MySQL écrit les erreurs dans le fichier mysql-error.log. Le nom du fichier journal comporte l'heure à laquelle le fichier a été généré (au format UTC). Les fichiers journaux comportent également un horodatage permettant de déterminer le moment où les entrées du journal ont été écrites.

Aurora MySQL écrit dans le journal des erreurs uniquement au moment du démarrage, de l'arrêt et lorsqu'une erreur survient. Une instance de base de données peut fonctionner pendant des heures ou des jours sans qu'aucune nouvelle entrée soit écrite dans le journal des erreurs. Si aucune entrée récente ne figure, cela signifie que le serveur n'a pas rencontré d'erreur justifiant une entrée de journal.

Par défaut, les journaux des erreurs sont filtrés de sorte que seuls les événements inattendus tels que les erreurs soient affichés. Toutefois, les journaux des erreurs contiennent également des informations supplémentaires sur la base de données, comme la progression des requêtes, qui ne sont pas affichées. Par conséquent, même en l'absence d'erreurs réelles, la taille des journaux des erreurs peut augmenter en raison des activités en cours sur la base de données. Et même si vous pouvez voir une certaine taille en octets ou en kilo-octets pour les journaux d'erreurs dans le AWS Management Console, ils peuvent contenir 0 octet lorsque vous les téléchargez.

Aurora MySQL écrit mysql-error.log sur le disque toutes les 5 minutes. Il ajoute le contenu du journal à mysql-error-running.log.

Aurora MySQL assure la rotation du fichier mysql-error-running.log toutes les heures.

Note

La période de conservation des journaux est différente pour Amazon RDS et Aurora.

Journal des requêtes lentes et journal général Aurora MySQL

Vous pouvez écrire le journal des requêtes lentes et le journal général Aurora MySQL dans un fichier ou dans une table de base de données. Pour ce faire, définissez les paramètres de votre groupe de paramètres de base de données. Pour plus d'informations sur la création et la modification d'un groupe de paramètres DB, consultez Groupes de paramètres pour Amazon Aurora (). Vous devez définir ces paramètres avant de pouvoir consulter le journal des requêtes lentes ou le journal général dans la console Amazon RDS ou à l'aide de l'API Amazon RDS, de la CLI Amazon RDS ou. AWS SDKs

Vous pouvez contrôler la journalisation Aurora MySQL à l'aide des paramètres de cette liste :

  • slow_query_log : Pour créer le journal des requêtes lentes, définir sur 1. La valeur par défaut est 0.

  • general_log : Pour créer le journal général, définir sur 1. La valeur par défaut est 0.

  • long_query_time : Pour empêcher l'enregistrement des requêtes rapides dans le journal des requêtes lentes, indiquez la valeur de la durée d'exécution de requête la plus courte devant être journalisée, en secondes. La valeur par défaut est de 10 secondes et la valeur minimum est 0. Si log_output = FILE, vous pouvez indiquer une valeur à virgule flottante avec une résolution en microseconde. Si log_output = TABLE, vous devez indiquer un nombre entier avec une résolution en seconde. Seules les requêtes dont la durée d'exécution dépasse la valeur long_query_time sont journalisées. Par exemple, si vous définissez long_query_time sur 0,1, les requêtes s'exécutant pendant moins de 100 millisecondes ne sont pas enregistrées.

  • log_queries_not_using_indexes : Pour enregistrer toutes les requêtes n'utilisant pas d'index dans le journal des requêtes lentes, définir sur 1. Les requêtes n'utilisant pas d'index sont journalisées même si la durée de leur exécution est inférieure à la valeur du paramètre long_query_time. La valeur par défaut est 0.

  • log_output option : Vous pouvez spécifier l'une des options suivantes pour le paramètre log_output.

    • TABLEAU – Écrit les requêtes générales dans le tableau mysql.general_log et les requêtes lentes dans le tableau mysql.slow_log.

    • FICHIER – Écrit les fichiers des requêtes générales et lentes dans le fichier système.

    • AUCUNE– Désactive la journalisation.

    Pour les versions 2 et 3 d'Aurora MySQL, la valeur par défaut log_output estFILE.

Pour que les données de requête lentes apparaissent dans Amazon CloudWatch Logs, les conditions suivantes doivent être remplies :

  • CloudWatch Les journaux doivent être configurés pour inclure les journaux des requêtes lentes.

  • slow_query_logdoit être activé.

  • log_output doit être défini sur FILE.

  • La durée de la requête doit être plus longue que celle configurée pourlong_query_time.

Pour plus d'informations sur le journal des requêtes lentes et le journal général, accédez aux rubriques suivantes dans la documentation MySQL :

Journal d'audit Aurora MySQL

La journalisation d'audit pour Aurora MySQL se nomme « audit avancé ». Pour activer l'audit avancé, définissez certains paramètres de cluster de bases de données. Pour de plus amples informations, veuillez consulter Utilisation de l'audit avancé avec un cluster Amazon Aurora My SQL DB.

Journal d'instance Aurora MySQL

Aurora crée un fichier journal distinct pour les instances de base de données pour lesquelles la pause automatique est activée. Ce fichier instance.log enregistre toutes les raisons pour lesquelles ces instances de base de données n'ont pas pu être mises en pause comme prévu. Pour plus d'informations sur le comportement des fichiers journaux d'instance et la fonctionnalité de pause automatique d'Aurora, consultez la section Surveillance de l'activité de pause et de reprise d'Aurora Serverless v2.

Renouvellement et rétention des journaux pour Aurora MySQL

Lorsque la journalisation est activée, Amazon Aurora procède à la rotation ou à la suppression des fichiers journaux à intervalles réguliers. Cette précaution permet de limiter la possibilité qu'un fichier journal volumineux ne bloque l'utilisation de la base de données ou n'affecte les performances. Aurora MySQL gère la rotation et la suppression des journaux comme suit :

  • La taille des fichiers journaux des erreurs Aurora MySQL est limitée à 15 % maximum de l'espace de stockage local pour une instance de base de données. Pour maintenir ce seuil, les journaux sont automatiquement renouvelés toutes les heures. Aurora MySQL supprime les journaux au bout de 30 jours ou lorsque 15 % de l'espace disque est atteint. Si la taille de l'ensemble des fichiers journaux après la suppression dépasse le seuil, les fichiers journaux les plus anciens sont supprimés jusqu'à ce que la taille des fichiers journaux ne soit plus supérieure au seuil.

  • Aurora MySQL supprime les journaux d'audit, généraux et de requêtes lentes au bout de 24 heures ou lorsque 15 % du stockage est utilisé.

  • Lorsque la journalisation FILE est activée, les fichiers journaux généraux et les fichiers journaux des requêtes lentes sont examinés toutes les heures et ceux datant de plus de 24 heures sont supprimés. Dans certains cas, la taille des fichiers journaux combinés restant après la suppression peut dépasser le seuil de 15 % de l'espace local d'une instance de base de données. Le cas échéant, les fichiers journaux les plus anciens sont supprimés jusqu'à ce que la taille des fichiers journaux ne soit plus supérieure au seuil.

  • Lorsque la journalisation TABLE est activée, les tables des journaux ne font l'objet d'aucune rotation ou suppression. Les tables des journaux sont tronquées lorsque la taille de tous les journaux combinés est trop grande. Vous pouvez vous abonner à la catégorie d'low storageévénements pour être averti lorsque les tables de log doivent être pivotées ou supprimées manuellement pour libérer de l'espace. Pour de plus amples informations, veuillez consulter Utilisation des notifications d'RDSévénements Amazon.

    Vous pouvez effectuer une rotation manuelle de la table mysql.general_log en appelant la procédure mysql.rds_rotate_general_log. Vous pouvez effectuer une rotation de la table mysql.slow_log en appelant la procédure mysql.rds_rotate_slow_log.

    Lors de la rotation manuelle des tables de journaux, la table de journal actuelle est copiée vers une table de journal de sauvegarde et les entrées de la table de journal actuelle sont supprimées. Si la table de journal de sauvegarde existe déjà, elle est supprimée avant que la table de journal actuelle ne soit copiée dans la sauvegarde. Si besoin, vous pouvez interroger la table de journal de sauvegarde. La table de journal de sauvegarde de la table mysql.general_log est nommée mysql.general_log_backup. La table de journal de sauvegarde de la table mysql.slow_log est nommée mysql.slow_log_backup.

  • Les journaux d'audit Aurora MySQL font l'objet d'une rotation lorsque la taille des fichiers atteint 100 Mo. Ils sont supprimés au bout de 24 heures.

  • Amazon RDS fait pivoter les fichiers journaux d'erreurs d'authentification de base de données IAM supérieurs à 10 Mo. Amazon RDS supprime les fichiers journaux d'erreurs d'authentification de base de données IAM datant de plus de cinq jours ou de plus de 100 Mo.

Pour utiliser les journaux de la console Amazon RDS, de l'API Amazon RDS, de l'interface de ligne de commande Amazon RDS, AWS SDKs ou définissez log_output le paramètre sur FILE. A l'instar du journal des erreurs Aurora MySQL, ces fichiers journaux font l'objet d'une rotation horaire. Les fichiers journaux qui ont été générés au cours des dernières 24 heures sont conservés. Veuillez noter que la période de rétention est différente pour Amazon RDS et pour Aurora.

Publication de journaux Aurora MySQL sur Amazon CloudWatch Logs

Vous pouvez configurer votre cluster de base de données Aurora MySQL pour publier les données de journal dans un groupe de CloudWatch journaux dans Amazon Logs. Avec CloudWatch Logs, vous pouvez effectuer une analyse en temps réel des données du journal, puis les utiliser CloudWatch pour créer des alarmes et afficher des métriques. Vous pouvez utiliser CloudWatch les journaux pour stocker vos enregistrements de journal dans un espace de stockage hautement durable. Pour de plus amples informations, veuillez consulter Publication des journaux Amazon Aurora MySQL sur Amazon CloudWatch Logs.