Lire les journaux
Un service refuse de démarrer et la machine ne dit rien ? Elle a tout noté, au contraire. Apprenons à lire ses journaux avec journalctl pour trouver la cause en deux minutes.
- Parcours
- Tutoriel 14 sur 35
- Durée
- 20 min de lecture
- Vérifié avec
- Commandes : essais sous Debian 13.7 (systemd 257)
Ce que vous saurez faire
- Lire les dernières lignes du journal et comprendre une ligne.
- Filtrer par service, par période et par gravité.
- Suivre le journal en direct.
- Trouver pourquoi un service ne démarre pas.
Avant de commencer : Mises à jour et paquets.
Sommaire
Comment lire les journaux d'un serveur Debian avec journalctl ? Quand un programme se comporte mal, la réponse se trouve presque toujours dans son journal, et non sur l'écran. Nous allons apprendre cinq gestes : lire les dernières lignes, choisir un service, choisir une période, filtrer par gravité et suivre en direct. Vous aurez déjà de quoi diagnostiquer vos premières pannes. Vous vous servez de sudo et d'apt, expliqués dans Mises à jour et paquets.
Qu'est-ce qu'un journal
Un journal est le cahier où le serveur note, ligne après ligne, ce que chaque programme lui raconte : une connexion réussie, un échec, une erreur. Sous Debian, un seul programme tient ce cahier pour tous les autres, et la commande journalctl le lit. Pas besoin de fouiller dans des dizaines de fichiers, tout est au même endroit.
Une règle d'abord. Le journal complet est réservé à l'administrateur, donc chaque commande de cet article commence par sudo. Sans lui, alice ne voit que ses propres lignes, et la commande le dit en tête de sa réponse : Hint: You are currently not seeing messages from other users and the system. Voyons maintenant à quoi ressemble ce cahier.
1Lire les dernières lignes
Pour lire la fin du journal, on ajoute -n, suivi du nombre de lignes voulues. Demandons les cinq dernières.
sudo journalctl -n 5Cinq lignes apparaissent, les plus récentes en bas. Si la réponse est plus longue que l'écran, un lecteur s'ouvre : les flèches font défiler, q le ferme. Chaque ligne se lit de gauche à droite, comme celle-ci, tirée d'une connexion d'alice :
Nov 05 01:23:25 mon-serveur sshd-session[3840]: Accepted password for alice from 192.0.2.50 port 44846 ssh2- Nov 05 01:23:25 : la date et l'heure de l'événement.
- mon-serveur : le nom de la machine qui a écrit la ligne.
- sshd-session[3840] : le programme à l'origine du message, puis son numéro de processus entre crochets. Ce numéro change à chaque lancement.
- Accepted password for alice from 192.0.2.50… : le message lui-même. Ici, alice s'est connectée avec son mot de passe depuis l'adresse
192.0.2.50. Avec une clé, vous lirezAccepted publickey.
Avec la date, le programme et le message, vous savez qui a fait quoi et quand. Mais le journal mélange tous les programmes, et la ligne qui vous intéresse se noie vite. Il faut apprendre à trier.
2Ne garder qu'un service
L'option -u, pour unit (« unité »), ne garde que les lignes d'un seul service, c'est-à-dire d'un programme qui tourne en permanence. Gardons celles de SSH, le service qui reçoit vos connexions, et cherchons les connexions réussies avec grep, qui ne garde que les lignes contenant un mot.
sudo journalctl -u ssh | grep Accepted | tail -2Nov 05 01:23:25 mon-serveur sshd-session[3840]: Accepted password for alice from 192.0.2.50 port 44846 ssh2
Nov 05 01:24:02 mon-serveur sshd-session[4008]: Accepted password for alice from 192.0.2.50 port 55284 ssh2Vos lignes auront d'autres dates et d'autres adresses. Remarquez le nom donné à -u : ssh, et non sshd. Sous Debian, le service s'appelle ssh ; avec sshd, la réponse est -- No entries --, ce qui fait croire à tort que le journal est vide.
Retrouver le nom exact d'un service
La commande systemctl list-units --type=service liste les noms des services en marche.
Le journal d'un service peut compter des milliers de lignes. Combiné à -n, -u n'en montre que la fin : sudo journalctl -u ssh -n 20. Reste à choisir de quand à quand lire.
3Choisir la période et la gravité
Trois options réduisent le journal à ce qui compte. Chacune se combine avec -u et avec les autres :
--sinceet--untilbornent la période :--since "1 hour ago"(depuis une heure),--since yesterday(depuis hier) ou--since "2026-11-05 01:00:00"(une date précise).-bgarde les lignes depuis le dernier démarrage de la machine, appelé boot.-b -1montre le démarrage précédent, utile après un plantage suivi d'un redémarrage.-pgarde les lignes d'une certaine gravité, de 0 (la plus grave) à 7 (la plus bavarde).
Chaque message du journal porte un niveau de gravité. Les voici, du plus grave au moins grave :
| Niveau | Nom | Sens |
|---|---|---|
| 0 | emerg | la machine est inutilisable |
| 1 | alert | agir tout de suite |
| 2 | crit | panne grave |
| 3 | err | une erreur |
| 4 | warning | un avertissement |
| 5 à 7 | notice, info, debug | simple information |
L'option -p err garde ce niveau et tous les plus graves. Voici les erreurs de la dernière heure :
sudo journalctl -p err --since "1 hour ago"Sur un serveur en bonne santé, la réponse est courte, voire -- No entries -- : aucune erreur sur la période. C'est le bon premier réflexe quand quelque chose cloche : -p err d'abord, le reste du journal ensuite. Et si vous voulez voir les lignes arriver au lieu de les chercher après coup ?
4Suivre le journal en direct
L'option -f, pour follow (« suivre »), garde la commande ouverte et affiche chaque nouvelle ligne dès qu'elle est écrite. C'est l'équivalent de regarder le cahier pendant que quelqu'un écrit dedans. Suivons SSH, puis connectons-nous depuis un second terminal.
sudo journalctl -f -u sshLa commande ne rend pas la main : elle attend. Ouvrez une seconde connexion SSH depuis votre ordinateur, et des lignes apparaissent, dont l'Accepted de votre arrivée. Appuyez sur Ctrl et C ensemble pour arrêter. C'est idéal pour relancer un service dans un terminal et voir son journal réagir dans l'autre. Passons à un cas réel : que faire quand un service ne démarre pas ?
5Trouver pourquoi un service ne démarre pas
Quand un service échoue, deux commandes donnent presque toujours la cause : systemctl status pour voir l'état, puis journalctl -u pour lire le détail. Pour s'entraîner sans rien casser, créons un faux service, demo, dont le programme n'existe pas. Le fichier ci-dessous décrit le service à systemd, le programme qui démarre et surveille tous les services de Debian.
sudo tee /etc/systemd/system/demo.service > /dev/null <<'EOF'
[Service]
ExecStart=/usr/local/bin/demo-introuvable
EOF
sudo systemctl daemon-reload
sudo systemctl start demoLa commande daemon-reload dit à systemd de relire ses fichiers, pour qu'il découvre le nôtre. Le démarrage ne répond rien, et pourtant tout a échoué. Demandons l'état.
sudo systemctl status demo Loaded: loaded (/etc/systemd/system/demo.service; static)
Active: failed (Result: exit-code) since Thu 2026-11-05 01:23:41 UTC; 10ms ago
Duration: 40ms
Invocation: b96e3fdcef2f4ecf9b7764bbe3dea061
Process: 3921 ExecStart=/usr/local/bin/demo-introuvable (code=exited, status=203/EXEC)
Main PID: 3921 (code=exited, status=203/EXEC)
Mem peak: 1.7M
CPU: 7ms
Nov 05 01:23:41 mon-serveur systemd[1]: Started demo.service.
Nov 05 01:23:41 mon-serveur (rouvable)[3921]: demo.service: Unable to locate executable '/usr/local/bin/demo-introuvable': No such file or directory
Nov 05 01:23:41 mon-serveur (rouvable)[3921]: demo.service: Failed at step EXEC spawning /usr/local/bin/demo-introuvable: No such file or directory
Nov 05 01:23:41 mon-serveur systemd[1]: demo.service: Main process exited, code=exited, status=203/EXEC
Nov 05 01:23:41 mon-serveur systemd[1]: demo.service: Failed with result 'exit-code'.Vos dates et vos numéros seront les vôtres. Ne lisez que trois choses : Loaded dit que le service est connu, Active: failed dit qu'il est tombé, et les lignes datées en bas sont un extrait du journal. Parmi elles, Unable to locate executable … No such file or directory donne la cause en clair : le programme n'existe pas à cet endroit. Le reste est facultatif : Invocation est l'identifiant unique de ce lancement, Process et Main PID décrivent le programme qui a échoué (status=203/EXEC veut dire qu'il n'a pas pu être lancé), et Duration, Mem peak et CPU donnent la durée de vie, la mémoire maximale et le temps de calcul. Quant à (rouvable), c'est le nom provisoire du programme, coupé par le système : il reprend la fin de demo-introuvable. Pour lire tout le journal du service, sans se limiter à ces lignes :
sudo journalctl -u demo --no-pagerNov 05 01:23:41 mon-serveur systemd[1]: Started demo.service.
Nov 05 01:23:41 mon-serveur (rouvable)[3921]: demo.service: Unable to locate executable '/usr/local/bin/demo-introuvable': No such file or directory
Nov 05 01:23:41 mon-serveur (rouvable)[3921]: demo.service: Failed at step EXEC spawning /usr/local/bin/demo-introuvable: No such file or directory
Nov 05 01:23:41 mon-serveur systemd[1]: demo.service: Main process exited, code=exited, status=203/EXEC
Nov 05 01:23:41 mon-serveur systemd[1]: demo.service: Failed with result 'exit-code'.L'option --no-pager affiche tout d'un coup au lieu d'ouvrir le lecteur. Le réflexe à retenir tient en trois temps : status pour l'état, journalctl -u pour la cause, puis on corrige et on relance. Pour ranger, supprimons le faux service ; reset-failed efface la mention « failed » qu'systemd garde en mémoire.
sudo rm /etc/systemd/system/demo.service
sudo systemctl daemon-reload
sudo systemctl reset-failed demoObtenir des explications en plus : -xe
Ajoutez -x pour que journalctl intercale des paragraphes d'explication sous certaines lignes, et -e pour sauter directement à la fin : sudo journalctl -xeu demo. C'est ce que suggèrent souvent les messages d'erreur de systemctl.
Vous savez trouver la cause d'une panne. Un dernier souci, plus discret : un journal qui grossit sans fin.
6Garder des journaux de taille raisonnable
Le journal grossit tant que le serveur tourne, mais Debian le borne : par défaut il occupe au plus 10 % du disque, et jamais plus de 4 Go. Vérifiez sa taille actuelle avec --disk-usage.
sudo journalctl --disk-usageArchived and active journals take up 16M in the file system.Votre chiffre sera différent. Si le journal prend trop de place, --vacuum-size supprime les plus vieilles lignes jusqu'à la taille demandée, et --vacuum-time supprime tout ce qui dépasse un âge.
sudo journalctl --vacuum-size=200MLa commande répond Vacuuming done, freed …, avec la place libérée. Elle n'agit qu'une fois. Pour fixer une limite définitive, écrivez-la dans un petit fichier de réglages.
Fixer une limite permanente : SystemMaxUse
Ce fichier plafonne le journal à 200 Mo. Il vit dans un dossier à vous, que les mises à jour ne touchent pas.
sudo mkdir -p /etc/systemd/journald.conf.d
sudo tee /etc/systemd/journald.conf.d/taille.conf > /dev/null <<'EOF'
[Journal]
SystemMaxUse=200M
EOF
sudo systemctl restart systemd-journaldSi ça échoue
Quatre messages reviennent le plus souvent :
Hint: You are currently not seeing messages from other users and the system.Vous avez oubliésudo. Relancez la même commande précédée desudo.-- No entries --Aucune ligne ne correspond. Vérifiez le nom du service (sshet nonsshd) et élargissez la période, par exemple--since yesterday.No journal boot entry found for the specified boot (-1).Il n'y a pas de démarrage précédent, car la machine n'a pas redémarré depuis son installation. C'est normal.- La commande semble figée. Vous êtes dans le lecteur ou dans
-f. Tapezqpour le lecteur,CtrletCpour-f.
La suite
Vous savez maintenant demander au serveur ce qu'il a fait et pourquoi quelque chose a échoué. Mais le journal ne raconte que le passé : si le disque tombe en panne ou si vous effacez un fichier par erreur, il ne rendra rien. L'article suivant, Première sauvegarde avec rsync, met vos données à l'abri avec une première sauvegarde.