Les journaux de MariaDB, que les administrateurs appellent le plus souvent par leur nom anglais de logs, sont des fichiers dans lesquels le serveur de base de données consigne, au fil de l'eau, ce qui se passe en son sein : connexions des utilisateurs, requêtes reçues, opérations trop lentes, erreurs rencontrées ou modifications apportées aux données. Un peu comme le journal de bord d'un navire ou la boîte noire d'un avion, ces fichiers permettent de reconstituer après coup le déroulement des événements, de comprendre l'origine d'une panne, de repérer les traitements qui ralentissent un site web ou de détecter une tentative d'intrusion. MariaDB, système de gestion de bases de données libre issu de MySQL et très utilisé pour faire fonctionner des sites et des applications, propose plusieurs journaux distincts, chacun ayant une fonction précise : le journal général, le journal des requêtes lentes, le journal d'erreurs et le journal binaire, sans compter des journaux plus techniques liés à la réplication ou au moteur de stockage. Cette page explique, sans supposer de connaissances poussées, à quoi sert chacun d'eux, comment les activer et les consulter, comment éviter qu'ils n'encombrent le disque et pourquoi il faut les protéger avec soin.
Qu'est-ce qu'un journal (log) dans MariaDB ? Définition
Un journal, ou log, est un fichier texte ou binaire dans lequel un logiciel écrit automatiquement des lignes datées décrivant son activité. Presque tous les programmes serveurs en tiennent : le serveur web note les pages demandées, le système d'exploitation consigne les démarrages et les incidents, et le serveur de base de données enregistre ses propres événements. Dans le cas de MariaDB, une base de données dite relationnelle, qui range les informations dans des tables reliées entre elles et s'interroge à l'aide du langage SQL, les journaux répondent à des besoins très différents, d'où leur multiplicité. Certains servent au dépannage (comprendre pourquoi le serveur refuse de démarrer), d'autres à l'optimisation (trouver les requêtes trop gourmandes), d'autres encore à la sécurité (savoir qui s'est connecté et ce qu'il a fait) ou à la sauvegarde et la réplication (garder la trace exacte de chaque modification pour pouvoir la rejouer ailleurs). Chaque journal peut être activé ou désactivé indépendamment, soit à chaud depuis une session SQL, soit de façon permanente dans le fichier de configuration du serveur, nommé selon les installations my.cnf ou placé dans un dossier de configuration dédié.
À quoi servent les journaux de MariaDB ?
Sans journaux, un administrateur de base de données travaillerait à l'aveugle. Lorsqu'un site affiche soudain une erreur de connexion à la base, c'est le journal d'erreurs qui indique si le serveur a manqué de mémoire, rencontré un fichier corrompu ou été arrêté par le système. Lorsqu'une page met plusieurs secondes à s'afficher, le journal des requêtes lentes désigne précisément les instructions SQL responsables. Lorsqu'il faut restaurer les données telles qu'elles étaient juste avant une fausse manipulation, le journal binaire permet de rejouer les modifications jusqu'à la minute voulue. Lorsqu'on soupçonne un accès indu, le journal général, ou un module d'audit dédié, révèle qui s'est connecté et quelles commandes ont été exécutées. Chacun de ces outils a cependant un coût : écrire sur le disque prend du temps et de la place, et certains journaux, très bavards, peuvent ralentir le serveur ou remplir un disque en quelques heures sur une base très sollicitée. Tout l'art consiste donc à activer les bons journaux au bon moment, à les faire tourner régulièrement et à les analyser avec des outils adaptés. Le tableau ci-dessous récapitule les principaux journaux et leurs variables de configuration.
| Journal MariaDB | Ce qu'il enregistre | Variable principale | Usage conseillé |
|---|---|---|---|
| Journal général (general log) | Connexions, déconnexions et toutes les requêtes reçues | general_log | Débogage ponctuel, désactivé en production |
| Requêtes lentes (slow query log) | Requêtes dépassant un seuil de durée | slow_query_log, long_query_time | Optimisation des performances |
| Journal d'erreurs (error log) | Démarrages, arrêts, avertissements et erreurs du serveur | log_error | Toujours actif, premier réflexe en cas de panne |
| Journal binaire (binary log) | Toutes les modifications de données | log_bin | Réplication et restauration à un instant précis |
| Journal de relais (relay log) | Modifications reçues d'un serveur principal | relay_log | Serveurs répliques uniquement |
Le journal général et le journal des requêtes lentes de MariaDB
Le journal général est le plus exhaustif des journaux de MariaDB : il consigne chaque connexion et déconnexion d'un client, ainsi que chaque requête SQL envoyée au serveur, telle qu'elle a été reçue. Il est donc extrêmement utile pour comprendre ce que fait réellement une application, diagnostiquer un problème de connexion ou repérer une activité inhabituelle. Cette exhaustivité est aussi son principal défaut : sur une base qui traite des centaines de requêtes par seconde, le fichier grossit à une vitesse impressionnante et l'écriture permanente pèse sur les performances. On ne l'active donc que pour de courtes périodes, le temps d'un débogage. L'activation peut se faire à chaud, depuis une session disposant des droits d'administration, avec la commande SET GLOBAL general_log = 'ON';, et l'emplacement du fichier se règle avec SET GLOBAL general_log_file = '/chemin/vers/general.log';, à condition que le serveur ait le droit d'écrire dans le dossier choisi. Une commande SET GLOBAL n'est valable que jusqu'au prochain redémarrage : pour un réglage durable, il faut l'inscrire dans le fichier de configuration. On peut aussi demander à MariaDB d'écrire ce journal dans une table plutôt que dans un fichier, grâce à la variable log_output, ce qui permet de l'interroger en SQL.
Le journal des requêtes lentes (slow query log)
Le journal des requêtes lentes est sans doute le plus précieux pour améliorer les performances d'un site ou d'une application. Il n'enregistre que les requêtes dont la durée d'exécution dépasse un seuil défini par la variable long_query_time, fixé par défaut à dix secondes, une valeur généralement jugée trop élevée pour un site web, où l'on descend volontiers à une ou deux secondes, voire moins. Pour chaque requête retenue, il indique notamment sa durée, le nombre de lignes examinées et renvoyées, l'utilisateur concerné et le texte de la requête. On l'active avec SET GLOBAL slow_query_log = 'ON';, on règle le seuil avec SET GLOBAL long_query_time = 2; et on choisit le fichier avec la variable slow_query_log_file. Une option complémentaire permet aussi de consigner les requêtes qui n'utilisent aucun index, ces structures qui permettent à la base de retrouver rapidement une information sans parcourir toute une table, à la manière de l'index d'un livre. Une requête lente révèle souvent un index manquant, une jointure mal construite ou une recherche portant sur une table devenue trop volumineuse. Comme le journal général, celui-ci peut grossir rapidement si le seuil est très bas, d'où l'intérêt de l'activer avec discernement.
Le journal d'erreurs et le journal binaire de MariaDB
Le journal d'erreurs est le seul journal de MariaDB qui soit pratiquement toujours actif, et c'est lui qu'il faut consulter en premier lorsque quelque chose ne va pas. Il enregistre les messages émis au démarrage et à l'arrêt du serveur, les avertissements (une option de configuration obsolète, une table qui doit être réparée), les erreurs graves (un fichier de données illisible, un disque plein, une mémoire insuffisante) et, en cas de plantage, des informations techniques utiles pour en comprendre la cause. Pour savoir où il se trouve, il suffit d'exécuter la requête SHOW VARIABLES LIKE 'log_error';. Selon les distributions Linux, ce journal peut être écrit dans un fichier situé sous /var/log, dans le dossier de données de MariaDB ou être confié au gestionnaire de journaux du système, auquel cas on le consulte avec les outils de ce dernier. Sa lecture demande un peu d'habitude, car les messages sont techniques et en anglais, mais leur contenu, recopié dans un moteur de recherche ou la documentation officielle, mène généralement assez vite à la cause du problème. Il est recommandé d'en surveiller régulièrement le contenu, même lorsque tout semble fonctionner, car certains avertissements annoncent des difficultés à venir.

Le journal binaire, mémoire des modifications
Le journal binaire (binary log, souvent abrégé en binlog) occupe une place à part. Il n'enregistre pas les simples lectures, mais toutes les opérations qui modifient les données ou la structure de la base : insertions, mises à jour, suppressions, créations de tables. Il est écrit dans un format binaire compact, réparti sur une série de fichiers numérotés, et se lit avec un utilitaire dédié, mariadb-binlog (anciennement mysqlbinlog). Son premier usage est la réplication : un serveur principal transmet son journal binaire à un ou plusieurs serveurs répliques, qui rejouent les mêmes modifications pour rester synchronisés, ce qui permet de répartir la charge ou de disposer d'une copie de secours prête à prendre le relais. Son second usage est la restauration à un instant précis : en partant d'une sauvegarde complète réalisée la nuit, on peut rejouer les modifications du journal binaire jusqu'à la minute qui précède une erreur, par exemple une suppression accidentelle. On l'active dans le fichier de configuration avec l'option log_bin, puis on liste les fichiers existants avec SHOW BINARY LOGS;. Une durée de conservation doit être prévue, faute de quoi ces fichiers s'accumulent indéfiniment.
Gérer les journaux de MariaDB : rotation, analyse et performances
Un journal qui grossit sans limite finit par poser problème : il occupe un espace disque croissant, devient difficile à ouvrir et peut, dans le pire des cas, saturer le disque et arrêter le serveur. La réponse s'appelle la rotation des journaux : à intervalles réguliers, le fichier en cours est renommé et archivé, souvent compressé, puis un nouveau fichier vide prend le relais, tandis que les archives les plus anciennes sont supprimées au-delà d'un certain nombre. Sur les systèmes Linux, l'outil le plus courant pour automatiser ce travail est logrotate, configuré par un petit fichier qui précise la fréquence (quotidienne, hebdomadaire), le nombre d'archives à conserver et la compression. Plutôt que de redémarrer MariaDB après chaque rotation, ce qui interromprait le service, on lui demande simplement de rouvrir ses fichiers de journal, grâce à la commande SQL FLUSH LOGS ou à son équivalent en ligne de commande ; de nombreuses distributions fournissent d'ailleurs une configuration toute prête. Le journal binaire dispose de son propre mécanisme : une variable fixe la durée de conservation, et la commande PURGE BINARY LOGS supprime les fichiers devenus inutiles, en veillant à ne pas effacer ceux dont une réplique a encore besoin.
Analyser les journaux de MariaDB
Enregistrer des informations ne sert à rien si personne ne les lit. Pour un premier coup d'œil, les commandes classiques de Linux suffisent : less pour parcourir un fichier page par page, tail -f pour suivre en direct les nouvelles lignes, grep pour rechercher un mot comme « ERROR ». Pour le journal des requêtes lentes, l'utilitaire mariadb-dumpslow (aussi connu sous son ancien nom mysqldumpslow) regroupe les requêtes similaires et les classe, par exemple par temps total d'exécution : la commande mariadb-dumpslow -s t -t 10 suivie du chemin du fichier affiche les dix plus coûteuses. Dans les infrastructures plus importantes, on préfère centraliser les journaux de tous les serveurs dans une même plateforme. La pile ELK, composée d'Elasticsearch pour le stockage et la recherche, de Logstash pour la collecte et la transformation, et de Kibana pour les tableaux de bord, est l'une des solutions les plus connues, souvent complétée par un petit agent de collecte installé sur chaque serveur. Graylog, autre plateforme répandue, offre des fonctions de recherche et d'alerte comparables, utiles pour être prévenu automatiquement lorsqu'une erreur se répète.
Trouver le bon équilibre entre journalisation et performances
Chaque ligne écrite dans un journal de MariaDB consomme un peu de temps de calcul et d'accès au disque. Pris isolément, ce coût est négligeable, mais sur un serveur qui traite un grand nombre de transactions, l'accumulation peut se traduire par une latence supplémentaire, surtout si plusieurs journaux détaillés sont actifs en même temps et écrits sur le même disque que les données. La règle générale est donc de n'activer en production que les journaux réellement utiles : le journal d'erreurs, indispensable, le journal binaire si l'on pratique la réplication ou la restauration à un instant précis, et le journal des requêtes lentes avec un seuil raisonnable. Le journal général, en revanche, doit rester désactivé hors des phases de diagnostic, ce que l'on garantit en inscrivant general_log = 0 dans le fichier de configuration. D'autres réglages permettent d'affiner le compromis, comme le choix du format du journal binaire ou la fréquence à laquelle il est réellement écrit sur le disque, un paramètre qui arbitre entre rapidité et garantie de ne rien perdre en cas de coupure. Ces décisions dépendent du contexte : un petit site personnel ne réclame pas les mêmes précautions qu'une plateforme de commerce en ligne.
Sécurité des journaux MariaDB et cas d'usage concrets
Les journaux de MariaDB contiennent souvent des informations sensibles : le journal général et le journal des requêtes lentes recopient le texte des requêtes, qui peut inclure des adresses électroniques, des données personnelles ou, si une application est mal conçue, des mots de passe. Le journal binaire contient quant à lui l'historique des modifications de toute la base. Ces fichiers doivent donc être protégés avec le même soin que les données elles-mêmes. Sur un serveur Linux, cela passe d'abord par des permissions de fichiers strictes : les commandes chown mysql:mysql et chmod 640 (ou 660 si le groupe doit pouvoir écrire), appliquées au fichier de journal, réservent son accès au compte sous lequel tourne MariaDB et à son groupe. Il convient aussi d'éviter de journaliser des secrets, de limiter la durée de conservation des archives, de chiffrer les journaux lorsque la base contient des données sensibles (MariaDB propose cette option pour certains d'entre eux) et de transmettre les journaux centralisés par des connexions chiffrées. Pour un suivi fin des accès, exigé par certaines réglementations, MariaDB fournit en outre un module d'audit dédié, plus adapté que le journal général car il permet de filtrer les événements à enregistrer.
Trois situations où les journaux font la différence
Quelques scénarios concrets montrent l'intérêt des journaux de MariaDB. Premier cas : un serveur cesse brusquement de répondre et le site affiche une erreur. En ouvrant le journal d'erreurs, l'administrateur découvre que le processus a été arrêté par le système faute de mémoire disponible ; il ajuste alors la configuration ou augmente les ressources de la machine, puis met en place une surveillance pour éviter que la situation ne se reproduise. Deuxième cas : les pages d'une boutique en ligne deviennent lentes aux heures de pointe. Le journal des requêtes lentes, analysé avec mariadb-dumpslow, révèle qu'une recherche de produits parcourt toute une table à chaque appel ; l'ajout d'un index adapté divise le temps de réponse de façon spectaculaire. Troisième cas : des tentatives de connexion répétées et refusées apparaissent depuis une adresse inconnue ; repérées dans les journaux, elles conduisent à bloquer cette adresse et à renforcer les mots de passe. Pour s'entraîner à ces manipulations sans risque, rien ne vaut une base de test, que l'on peut administrer et interroger depuis une interface web comme phpMyAdmin, qui permet notamment d'afficher les variables de journalisation du serveur et d'exécuter les requêtes présentées sur cette page.