Debian 13 : tutoriel / Lire les journaux systemd et vérifier la rotation avec logrotate

Debian 13 gère les journaux en distinguant les journaux consultés avec journalctl et les fichiers journaux que les applications écrivent directement. Vous commencez par exporter les enregistrements nécessaires au dépannage, et pour les fichiers journaux, vous devez définir la rotation, la compression et le nombre d’archives conservées selon la méthode de réouverture du programme. Ce tutoriel montre le fonctionnement de logrotate avec des fichiers et des services dédiés sans supprimer les journaux opérationnels.

Distinguer le journal des fichiers journaux des applications

systemd-journald collecte la sortie standard et les erreurs des services, ainsi que les messages système dans des journaux avec des champs. journalctl est un outil pour consulter les enregistrements stockés. Inversement, les fichiers journaux d’application situés, par exemple, dans /var/log/nginx peuvent être ouverts et écrits par le programme lui-même, et logrotate les renomme, les compresse et les conserve habituellement.

Cible Principaux outils Éléments à vérifier
Journal systemd Paramètres de journalctl et journald Service, démarrage, temps, priorité, emplacement de stockage et politique de taille
Fichiers journaux des programmes Paramètres de l'application et logrotate Chemin du fichier, propriété et fichiers ouverts, réouverture après rotation et moment de la compression

Ne supprimez pas les fichiers du journal systemd avec rm comme des fichiers texte ordinaires et ne confiez pas ces fichiers journal à logrotate. Si les fichiers journaux sont supprimés mais que l'espace reste occupé, cela est également lié aux fichiers supprimés mais encore ouverts. Utilisez le laboratoire de diagnostic de l’espace disque et des fichiers supprimés encore ouverts pour comparer df et du, et identifiez d'abord les services qui écrivent des journaux.

Filtrer par service, démarrage et période

Déterminez le service et le moment où le problème s'est produit et interrogez comme suit. Remplacez l'exemple de temps par le moment réel de la panne du serveur. La sortie peut inclure des informations telles que des comptes, adresses et jetons, donc vérifiez avant de partager à l'extérieur.

sudo journalctl --list-boots --no-pager
sudo journalctl -b -u nginx.service -n 50 --no-pager
sudo journalctl -b -u nginx.service --since '2026-11-16 22:00:00' --until '2026-11-16 23:00:00' -o short-iso --no-pager
sudo journalctl -b -p warning --no-pager
sudo journalctl -b -k --no-pager

-b sélectionne le démarrage actuel, -b -1 sélectionne le démarrage précédemment enregistré. Vérifiez d'abord l'existence avec --list-boots. -u est pour les services, -k est pour les messages du noyau, -p warning limite la portée aux avertissements et aux priorités plus sévères. Si vous spécifiez le niveau d'erreur, vous pourriez manquer des indices au niveau info, donc ne regardez pas uniquement cela dès le départ.

La machine virtuelle d'entraînement avait des journaux de démarrages précédents conservés et journalctl --disk-usage indiquait 40 MiB en combinant les fichiers actifs et archivés. Ceci est l'observation dans l'exemple actuel et non la rétention par défaut pour tous les serveurs Debian. Les autorisations de requête et les filtres peuvent être vérifiés dans le manuel Debian de journalctl.

Pour un service utilisateur, utilisez journalctl --user -u UNIT, en remplaçant UNIT par le nom réel de son service. Si l'accès au journal du système est restreint, utilisez sudo pour la requête nécessaire plutôt que d'ajouter le compte à un groupe largement privilégié pour des raisons de commodité.

Créer le service de journalisation dédié complet

Ceci est un environnement de pratique dédié pour Debian 13, systemd 257, Python 3 et logrotate 3.22. L'exemple ci-dessous suppose une VM avec un utilisateur général lfstudent. Si vous utilisez un compte différent, changez l'utilisateur et le groupe de l'unité ainsi que le propriétaire indiqué par la directive create de logrotate pour correspondre au même compte existant. Vous pouvez vérifier si le compte existe avec id lfstudent.

Préparez après l'installation et la vérification du chemin. Si un nom dédié existe déjà, arrêtez-vous sans écraser les fichiers existants. Ce fichier n'enregistre que des données d'exercice et n'est pas lié aux journaux existants de Nginx.

sudo apt install logrotate python3
id lfstudent
for p in /var/log/lf-log29 /var/backups/lf-debian13-29 /usr/local/libexec/lf-log29-writer.py /etc/systemd/system/lf-log29.service; do
    if test -e "$p"; then echo "Already exists: $p" >&2; exit 1; fi
done
sudo install -d -m 755 /var/log/lf-log29 /usr/local/libexec
sudo install -d -m 700 /var/backups/lf-debian13-29
sudo install -m 640 -o lfstudent -g lfstudent /dev/null /var/log/lf-log29/app.log

Enregistrez l'intégralité du programme Python suivant. Il garde le fichier ouvert pendant l'écriture. Sur SIGHUP (le signal de déconnexion), il demande une fermeture et une réouverture du même chemin lors de son itération suivante. La boucle est limitée à 6 000 itérations, soit environ dix minutes, afin de laisser le temps d’effectuer les manipulations. Tous les services généraux ne prennent pas en charge la réouverture SIGHUP.

sudo tee /usr/local/libexec/lf-log29-writer.py > /dev/null <<'PY'
import os,signal,time
path='/var/log/lf-log29/app.log'
reopen=True
running=True
def hup(signum,frame):
    global reopen
    reopen=True
def stop(signum,frame):
    global running
    running=False
signal.signal(signal.SIGHUP,hup)
signal.signal(signal.SIGTERM,stop)
f=None
try:
    for number in range(6000):
        if not running: break
        if reopen:
            if f is not None: f.close()
            f=open(path,'a',buffering=1)
            reopen=False
            print(f'<6>opened inode={os.fstat(f.fileno()).st_ino}',flush=True)
        f.write(f'line={number:04d} sample log record\n')
        time.sleep(.1)
finally:
    if f is not None: f.close()
    print('<6>writer stopped',flush=True)
PY

Confirmez que id lfstudent réussit avant de préparer les fichiers ; arrêtez-vous si le compte ou une étape d'installation échoue. Après avoir sauvegardé l'unité, vérifiez-la avec sudo systemd-analyze verify /etc/systemd/system/lf-log29.service avant le rechargement du démon et le démarrage.

Enregistrez l'unité entière suivante. La sortie standard enregistre l'inode du fichier ouvert, et le fichier consigne des entrées numérotées. La réouverture du fichier est demandée par le HUP envoyé via ExecReload. Si appliqué tel quel à un programme réel qui ne le prend pas en charge, il peut se terminer, donc la documentation du programme doit être vérifiée.

sudo tee /etc/systemd/system/lf-log29.service > /dev/null <<'UNIT'
[Unit]
Description=LF log rotation lab 29
[Service]
Type=exec
User=lfstudent
Group=lfstudent
ExecStart=/usr/bin/python3 /usr/local/libexec/lf-log29-writer.py
ExecReload=/bin/kill -HUP $MAINPID
SyslogIdentifier=lf-log29
UNIT
sudo chmod 644 /usr/local/libexec/lf-log29-writer.py
sudo systemctl daemon-reload
sudo systemctl start lf-log29.service
sleep 1
sudo systemctl is-active lf-log29.service
sudo tail /var/log/lf-log29/app.log
sudo journalctl -b -u lf-log29.service -n 10 --no-pager

Le fichier contient des lignes numérotées, comme line=0000 sample log record. Le journal systemd affiche opened inode= suivi du numéro de l’inode ouvert. Si le programme a été terminé pendant la pratique, vérifiez les journaux et l'état, puis redémarrez uniquement le service dédié. Faites la distinction entre l'arrêt normal lors de l'atteinte du temps d'exécution maximal de l'exemple et les erreurs d'autorisation.

Créez une configuration logrotate indépendante et vérifiez le mode débogage

Les paramètres de pratique sont placés en tant que fichiers indépendants dans le dossier de sauvegarde, et non dans /etc/logrotate.d. Par conséquent, le minuteur quotidien du système ne gère pas automatiquement cet exemple, et seule une vérification manuelle est effectuée. L'utilisation d'un --state séparé ne touche également pas au fichier d'état par défaut du système.

sudo tee /var/backups/lf-debian13-29/logrotate.conf > /dev/null <<'CONF'
/var/log/lf-log29/app.log {
    size 100
    rotate 2
    compress
    delaycompress
    missingok
    notifempty
    create 0640 lfstudent lfstudent
    sharedscripts
    postrotate
        /usr/bin/systemctl reload lf-log29.service
    endscript
}
CONF
sudo chmod 600 /var/backups/lf-debian13-29/logrotate.conf
sudo logrotate --debug --state /var/backups/lf-debian13-29/logrotate.state /var/backups/lf-debian13-29/logrotate.conf
sudo ls -l /var/log/lf-log29

--debug montre le raisonnement mais ne modifie pas les journaux ni les fichiers d'état. Lors de la vérification de l'exécution, le processus d'écriture a été temporairement suspendu pour comparer les hachages, confirmant que le contenu des fichiers, les fichiers rotatifs et les fichiers d'état séparés ne changent pas. Les lecteurs n'ont pas besoin d'arrêter le processus opérationnel pour cette vérification. Le fait que le hachage du fichier en cours d'écriture ait changé ne signifie pas que le debug a modifié le fichier.

Directives Signification et critères de sélection
size 100 Ceci est une petite limite de pratique basée sur 100 octets. Ce n'est pas une fonction de surveillance de rotation en temps réel exactement à cette taille.
rotate 2 Maintenir deux copies de sauvegarde tournées. Le réglage ne garantit pas deux jours.
compress / delaycompress Compresser, mais différer la compression de l'archive la plus récente jusqu'à la rotation suivante.
create 0640 Spécifier les permissions et la propriété du nouveau journal actif.
postrotate Dans cet exemple, demandez un rechargement afin que le service ouvre un nouveau fichier après la rotation.

Le manuel logrotate de Debian décrit les options prises en charge et le comportement de débogage/état. Vérifiez la priorité lors de la combinaison de conditions telles que la taille et quotidiennement. Un seuil de petite taille n'empêche pas une croissance substantielle entre les exécutions lorsque logrotate ne s'exécute qu'une fois par jour.

Vérifier la rotation, la compression et la réouverture des fichiers

Ce qui suit est la première rotation avec --force appliqué uniquement à la configuration dédiée. C'est une exécution forcée pour clarifier les conditions lors des tests initiaux et n'est pas utilisée pour toute la configuration de production.

sudo logrotate --verbose --force --state /var/backups/lf-debian13-29/logrotate.state /var/backups/lf-debian13-29/logrotate.conf
sleep 1
sudo ls -li /var/log/lf-log29
sudo tail /var/log/lf-log29/app.log
sudo journalctl -b -u lf-log29.service -n 15 --no-pager

Lors de la première rotation, le fichier existant devient app.log.1 et le nouveau app.log a un inode différent. Ce programme ouvre le nouveau chemin lors de l'itération suivante après avoir reçu HUP. Dans ce court intervalle, les lignes écrites dans le fichier précédent peuvent rester dans l'archive précédente. Ce qui est important, c'est de savoir si les enregistrements suivants continuent d'aller dans le nouveau fichier actif. Lors de la vérification, nous avons même comparé si l'inode du descripteur de fichier ouvert dans /proc correspondait à l'inode du fichier actif.

Exécutez le bloc suivant deux fois, donnant trois rotations au total. Après chaque rotation, attendez brièvement pour vérifier que le contenu est apparu dans le fichier actif. Si le nouveau fichier est vide, il peut passer la rotation à cause de notifempty, et si le programme s'est terminé, le rechargement postrotate peut échouer.

sudo logrotate --verbose --force --state /var/backups/lf-debian13-29/logrotate.state /var/backups/lf-debian13-29/logrotate.conf
sleep 1
sudo ls -li /var/log/lf-log29
sudo gzip -t /var/log/lf-log29/app.log.2.gz
sudo gzip -cd /var/log/lf-log29/app.log.2.gz | head
Nombre de rotations Journal actif Archives
Premier Reprendre l'écriture dans app.log app.log.1, pas encore compressé
Deuxième Enregistré dans le nouveau app.log app.log.1 et app.log.2.gz
Troisième Enregistré dans le nouveau app.log Conserver deux versions de sauvegarde, supprimer d'abord le contenu de la plus ancienne sauvegarde

Lors des trois rotations réelles, la vérification gzip a été validée et app.log.3.gz n’est pas restée. Les numéros d’inode peuvent être réutilisés, donc ne vous attendez pas à ce qu’ils augmentent globalement. Si vous renommez simplement sans rouvrir, le processus peut continuer à écrire sur l’inode précédente. copytruncate n’est pas utilisé comme solution générale pour tous les programmes car il existe un risque de perte d’enregistrements entre la copie et la troncature.

Exportez le journal et conservez les journaux des fichiers avant le nettoyage

Lors de la conservation des journaux pour l’investigation, mettez ensemble les filtres d’enregistrement, les fuseaux horaires et les conditions de démarrage. Le texte est facile à lire, et le format d’exportation peut être utilisé pour maintenir ensemble les champs du journal. Le fait qu’un fichier d’exportation ait été créé ne signifie pas qu’il ait été réenregistré dans le journal principal.

sudo systemctl stop lf-log29.service
sudo journalctl --sync
sudo journalctl -b -u lf-log29.service -o short-iso --no-pager | sudo tee /var/backups/lf-debian13-29/service-journal.txt > /dev/null
sudo journalctl -b -u lf-log29.service -o export --no-pager | sudo tee /var/backups/lf-debian13-29/service-journal.export > /dev/null
sudo cp -a /var/log/lf-log29/app.log /var/log/lf-log29/app.log.1 /var/log/lf-log29/app.log.2.gz /var/backups/lf-debian13-29/
sudo ls -lh /var/backups/lf-debian13-29

En pratique, la réouverture des enregistrements et les messages de fin normale du programme d’écriture étaient inclus dans le journal exporté, et les fichiers journaux ainsi que les sauvegardes compressées étaient également copiés séparément. Si des fichiers sont ignorés en raison de rotations intermédiaires, conservez-les selon la liste réelle et ne considérez pas la sauvegarde comme complète en ignorant les échecs de copie.

Revoir la politique de conservation et supprimer le laboratoire

La politique de stockage de journald est vérifiée avec les paramètres de fusion comme suit. Storage=auto modifie la méthode de stockage en fonction de la présence du répertoire de journal permanent, etc. Pour préserver les démarrages précédents, vérifiez également si elle est effectivement stockée de manière permanente et si elle est accessible en écriture.

systemd-analyze cat-config systemd/journald.conf
sudo journalctl --disk-usage
systemctl cat logrotate.timer
systemctl list-timers logrotate.timer --no-pager

SystemMaxUse et RuntimeMaxUse dans journald sont les politiques d'utilisation pour le stockage permanent et le stockage temporaire respectivement, et MaxRetentionSec est un élément qui limite la période de rétention des anciens enregistrements. Les données peuvent être supprimées plus tôt en raison de limites de capacité, donc cela ne garantit pas une période de rétention minimale. D'après le manuel de configuration de la rétention de journald Debian, vous décidez ensemble de la disponibilité de l'espace disque, du volume de génération des journaux, et de la période de rétention requise.

Lors de la modification effective de la politique, sauvegardez les paramètres existants et spécifiez la section [Journal] dans un fichier .conf séparé que vous gérez vous-même dans /etc/systemd/journald.conf.d, puis vérifiez le résultat fusionné. Appliquez en exécutant sudo systemctl restart systemd-journald et vérifiez l'état du service et les erreurs du journal. Lors du retour en arrière, supprimez uniquement le fichier drop-in que vous avez créé et appliquez-le à nouveau. Les journaux déjà supprimés selon la politique de rétention ne sont pas restaurés en revenant aux paramètres, donc conservez d'abord toute donnée nécessaire en externe.

Cette pratique n'a pas modifié la politique de rétention existante de journald ni supprimé le journal opérationnel en utilisant vacuum. La fonction vacuum de journalctl est une opération de suppression et ne garantit pas que l'utilisation, y compris des fichiers actifs, tombera immédiatement au niveau souhaité. Ne supprimez pas les journaux en masse avant l’enquête sous prétexte que le stockage est insuffisant.

Arrêtez le service en pratique, vérifiez la copie, puis nettoyez uniquement les fichiers dédiés. Puisque rien n'a été ajouté à /etc/logrotate.d, les autres règles du minuteur système restent en place.

sudo rm -- /etc/systemd/system/lf-log29.service /usr/local/libexec/lf-log29-writer.py
sudo systemctl daemon-reload
sudo rm -- /var/log/lf-log29/app.log /var/log/lf-log29/app.log.1 /var/log/lf-log29/app.log.2.gz
sudo rmdir /var/log/lf-log29

Après vérification, le service dédié et le chemin de journal ont été supprimés, et les preuves ainsi que les fichiers de configuration et d'état ont été conservés dans /var/backups/lf-debian13-29. Seules les règles avec une taille réelle appropriée, un calendrier d'exécution et des commandes de rechargement sont ajoutées au logrotate opérationnel, et la rotation forcée de 100 octets issue de cette pratique n'est pas utilisée comme valeur par défaut opérationnelle.