Anime-Sanctuary

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
  1. Qu'est-ce qu'un journal
  2. Lire les dernières lignes
  3. Ne garder qu'un service
  4. Choisir la période et la gravité
  5. Suivre le journal en direct
  6. Trouver pourquoi un service ne démarre pas
  7. Garder des journaux de taille raisonnable
  8. Si ça échoue
  9. La suite
  10. Sources

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.

Sur le serveur
sudo journalctl -n 5

Cinq 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 :

Une ligne du journal
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 lirez Accepted 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.

Sur le serveur
sudo journalctl -u ssh | grep Accepted | tail -2
Résultat attendu
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:24:02 mon-serveur sshd-session[4008]: Accepted password for alice from 192.0.2.50 port 55284 ssh2

Vos 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 :

  • --since et --until bornent 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).
  • -b garde les lignes depuis le dernier démarrage de la machine, appelé boot. -b -1 montre le démarrage précédent, utile après un plantage suivi d'un redémarrage.
  • -p garde 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 :

NiveauNomSens
0emergla machine est inutilisable
1alertagir tout de suite
2critpanne grave
3errune erreur
4warningun avertissement
5 à 7notice, info, debugsimple information

L'option -p err garde ce niveau et tous les plus graves. Voici les erreurs de la dernière heure :

Sur le serveur
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.

Sur le serveur
sudo journalctl -f -u ssh

La 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.

Sur le serveur
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 demo

La 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.

Sur le serveur
sudo systemctl status demo
Résultat attendu
     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 :

Sur le serveur
sudo journalctl -u demo --no-pager
Résultat attendu
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'.

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.

Sur le serveur
sudo rm /etc/systemd/system/demo.service
sudo systemctl daemon-reload
sudo systemctl reset-failed demo
Obtenir 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.

Sur le serveur
sudo journalctl --disk-usage
Résultat attendu
Archived 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.

Sur le serveur
sudo journalctl --vacuum-size=200M

La 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.

Sur le serveur
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-journald

Si ç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 de sudo.
  • -- No entries -- Aucune ligne ne correspond. Vérifiez le nom du service (ssh et non sshd) 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. Tapez q pour le lecteur, Ctrl et C pour -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.

Sources (consultées le 4 novembre 2026)

  • Journal : journalctl(1), journald.conf(5) (10 % du disque, plafond de 4 Go).
  • Commandes : essais sous Debian 13.7 (systemd 257.13) avec un vrai serveur SSH ; adresses d'exemple.