Logrotate für systemd-Journal konfigurieren

Logrotate für systemd-Journal konfigurieren
  • Das systemd-Journal schreibt binäre .journal-Dateien, die Logrotate nicht direkt rotieren kann – die Rotation übernimmt journald selbst.
  • Größenlimits setzen Sie in /etc/systemd/journald.conf über SystemMaxUse, SystemKeepFree und MaxRetentionSec.
  • Logrotate greift nur bei Textdateien, weitergeleiteten Syslog-Logs oder eigenen Diensten unter /etc/logrotate.d/.
  • Nach jeder Änderung an journald.conf ist ein systemctl restart systemd-journald zwingend erforderlich.
  • Prüfen Sie den Ist-Zustand zuerst mit journalctl --disk-usage und journalctl --verify.

Warum die Rotation von systemd-Journal-Logs wirklich wichtig ist

Bevor wir uns in die Konfigurationsdetails begeben, sollten wir die Architektur verstehen – denn genau hier liegt der häufigste Denkfehler. Das systemd-Journal speichert seine Einträge standardmäßig binär, entweder persistent unter /var/log/journal/ oder flüchtig unter /run/log/journal/. Ohne Konfiguration wachsen diese Dateien unkontrolliert.

Kurz gesagt :

  • Das systemd-Journal schreibt binäre .journal-Dateien, die journald selbst rotiert, nicht Logrotate.
  • Größenlimits werden in /etc/systemd/journald.conf über SystemMaxUse, SystemKeepFree und MaxRetentionSec gesetzt.
  • Logrotate greift nur bei Textdateien, weitergeleiteten Syslog-Logs oder eigenen Diensten unter /etc/logrotate.d/.
  • Nach jeder Änderung an journald.conf ist ein systemctl restart systemd-journald erforderlich.

Ich habe in den letzten Jahren zahlreiche Server evaluiert, bei denen das Journal mehrere Gigabyte belegte. Ein Fall ist mir besonders in Erinnerung: Ein Kundensystem lief auf einer 40-GB-Partition, und das Journal fraß davon über 9 GB – knapp 23 % des Root-Dateisystems. Die Anwendung schrieb weiter, die Partition lief voll, und der Dienst startete nicht mehr. Bref, das muss nicht sein.

Sie sehen das Problem? Die Lösung ist zweistufig. journald kontrolliert seine eigenen Dateien, Logrotate kümmert sich um alles, was als Textzeile daneben liegt. Beide Mechanismen müssen sauber zusammenspielen.

Wie funktioniert journalctl und wie beende ich es?

journalctl ist das Lesewerkzeug für das binäre Journal und liest die Dateien indexbasiert aus, während journald im Hintergrund weiter schreibt – beenden müssen Sie es in der Regel gar nicht, weil es kein Dienst ist, sondern ein kurzlebiger Client-Prozess.

Viele Anwender verwechseln hier etwas. Wenn Sie journalctl -f aufrufen, folgt der Prozess dem Journal live. Mit Strg+C beenden Sie diese Ansicht sofort. Das ist alles. Der eigentliche Dienst heißt systemd-journald und läuft dauerhaft.

  • Live-Ansicht beenden: Strg+C im Terminal – der Client terminiert, journald läuft weiter.
  • Pager verlassen: q drücken, wenn die Ausgabe in less geöffnet ist.
  • Dienst stoppen (nur wenn nötig): systemctl stop systemd-journald – Achtung, danach schreibt kein Prozess mehr ins Journal.
  • Dienst neu starten: systemctl restart systemd-journald nach Konfigurationsänderungen.

Für mich ist das ein klassischer Performance-Engpass im Kopf vieler Admins: Sie suchen den Fehler im Client, dabei liegt er in der Konfiguration des Dienstes. Kennen Sie den Unterschied? Er entscheidet über jede weitere Diagnose.

Den aktuellen Speicherverbrauch des Journals analysieren

Eine fundierte Analyse beginnt immer mit dem Ist-Zustand, und dafür liefert journald Ihnen die passenden Werkzeuge direkt mit – ohne externe Skripte, ohne Raten.

  1. Speicherbelegung mit journalctl --disk-usage ermitteln – die Ausgabe zeigt die tatsächliche Größe inklusive aller Journal-Dateien.
  2. Verzeichnisgröße mit du -sh /var/log/journal gegenprüfen, um Dateisystem-Overhead zu erkennen.
  3. Aktuelle Header und Metadaten mit journalctl --header einsehen – hier sehen Sie, welche Dateien aktiv sind.
  4. Verfügbaren Speicherplatz mit df -h vergleichen, idealerweise auf der Root-Partition.
  5. Wachstumsrate über mehrere Tage beobachten, etwa mit einem täglichen Cron-Eintrag, der die Ausgabe protokolliert.

In meinen Audits hat sich gezeigt: Auf typischen Webservern wächst das Journal bei mittlerer Last um 150 bis 400 MB pro Woche. Auf Datenbank-Hosts mit hohem Log-Aufkommen sind Werte über 1 GB pro Woche keine Seltenheit. Diese Größenordnung sollten Sie kennen, bevor Sie Limits setzen.

Die journald-Konfiguration für Größenlimits anpassen

Die zentrale Stellschraube ist die Datei /etc/systemd/journald.conf, in der Sie Speichergrenzen, Dateigrößen und Aufbewahrungsfristen festlegen – die Werte greifen erst nach einem Neustart des Dienstes.

Öffnen Sie die Datei mit einem Editor Ihrer Wahl. Ich empfehle, die Originalzeilen auskommentiert zu lassen und eigene Werte darunter zu setzen. Das erleichtert spätere Reviews erheblich.

[Journal]
Storage=persistent
SystemMaxUse=500M
SystemKeepFree=2G
SystemMaxFileSize=50M
SystemMaxFiles=10
MaxRetentionSec=30d

Was bedeuten diese Zeilen konkret? Storage=persistent erzwingt die Ablage unter /var/log/journal/ statt im RAM. SystemMaxUse begrenzt den Gesamtverbrauch auf 500 MB. SystemKeepFree reserviert zusätzlich 2 GB freien Speicher, damit die Partition nie vollläuft. SystemMaxFileSize deckelt die Einzeldatei bei 50 MB, und SystemMaxFiles begrenzt die Anzahl der Dateien auf zehn. MaxRetentionSec schließlich verwirft Einträge, die älter als 30 Tage sind.

Ein wichtiger Hinweis zur Konsistenz: Wenn SystemKeepFree größer ist als der tatsächlich freie Speicher, greift journald bevorzugt diese Grenze – nicht SystemMaxUse. Auf kleinen VPS mit 20 GB Platte habe ich genau das erlebt. Das Journal blieb winzig, obwohl 500 MB erlaubt waren. Prüfen Sie also immer beide Werte im Verhältnis.

Danach laden Sie die Konfiguration neu:

systemctl restart systemd-journald
journalctl --disk-usage

Die Aufbewahrungsdauer und Rotation über journald steuern

journald kennt zwei Rotationsachsen – Größe und Zeit – und Sie sollten beide bewusst konfigurieren, weil eine rein größenbasierte Grenze bei geringem Log-Aufkommen monatelang nichts rotiert.

Die zeitbasierte Steuerung läuft über MaxRetentionSec. Setzen Sie den Wert auf 30d, verschwinden Einträge nach 30 Tagen. Wollen Sie zusätzlich die Dateianzahl begrenzen, nutzen Sie SystemMaxFiles. Beide Parameter wirken unabhängig voneinander; es gewinnt die restriktivere Regel.

Vergleich der journald-Parameter für Größe, Zeit und Dateianzahl
ParameterWirkungEmpfohlener WertFallstrick
SystemMaxUseMaximaler Gesamtverbrauch500M bis 2GZu hoch auf kleiner Partition
SystemKeepFreeReservierter freier Speicher2G bis 5GÜberschreibt MaxUse bei Platzmangel
SystemMaxFileSizeMaximale Größe einer Datei50M bis 100MZu klein erhöht Dateizahl
SystemMaxFilesMaximale Anzahl Dateien10 bis 20Begrenzt Rotation bei kleiner Dateigröße
MaxRetentionSecZeitliche Aufbewahrung30d bis 90dZu kurz erschwert Forensik

Ein Praxisbeispiel aus meiner Arbeit: Für einen Webserver mit 30 Tagen Aufbewahrung bei maximal 500 MB hat sich folgende Kombination bewährt – SystemMaxUse=500M, SystemMaxFileSize=50M, SystemMaxFiles=10, MaxRetentionSec=30d. Das ergibt rechnerisch maximal zehn Dateien à 50 MB, also exakt die Obergrenze. Sauber, skalierbar, nachvollziehbar.

Wollen Sie die Rotation manuell auslösen, etwa nach einem Vorfall, hilft journalctl --rotate. Das ist kein Ersatz für Konfiguration, aber ein nützliches Werkzeug bei der Fehlersuche.

Logrotate-Regeln für weitergeleitete oder eigene Log-Dateien erstellen

Logrotate wird immer dann relevant, wenn Dienste ihre Ausgaben als Textdatei schreiben oder wenn Sie das Journal per ForwardToSyslog=yes an einen klassischen Syslog-Daemon weiterleiten – dann entstehen echte Textdateien in /var/log/.

Die Konfiguration liegt unter /etc/logrotate.d/. Legen Sie dort eine Datei pro Dienst an, etwa mein-dienst. Der Aufbau folgt einem festen Muster: Zielpfad, geschweifte Klammer, Direktiven.

/var/log/mein-dienst/*.log { daily rotate 14 size 100M compress delaycompress missingok notifempty create 0640 www-data adm sharedscripts postrotate systemctl kill -s HUP mein-dienst.service endscript
}

Die Direktiven im Einzelnen: daily rotiert täglich, rotate 14 behält 14 Generationen, size 100M erzwingt zusätzlich eine Rotation bei Überschreitung. compress spart Platz, delaycompress verschiebt die Kompression um einen Zyklus, damit der Dienst noch in die alte Datei schreiben kann. missingok verhindert Fehler bei fehlender Datei, notifempty überspringt leere Dateien. Der postrotate-Block signalisiert dem Dienst per SIGHUP, das Dateihandle neu zu öffnen.

Fehlt dieser Block, schreibt der Prozess weiter in die bereits umbenannte Datei. Das ist einer der häufigsten Fehler, die ich in Audits finde – die vermeintlich rotierten Logs wachsen munter weiter, während die neue Datei leer bleibt. Croyez-moi, das fällt oft erst nach Wochen auf.

Wie teste ich die Logrotate-Konfiguration, bevor sie scharf läuft?

Ein Trockenlauf mit logrotate --debug zeigt Ihnen jede geplante Aktion, ohne eine einzige Datei anzufassen – dieses Vorgehen sollte bei jeder Änderung zur Pflicht werden.

  • Trockenlauf: logrotate --debug /etc/logrotate.d/mein-dienst – zeigt Rotation, Kompression und Skriptausführung.
  • Erzwungene Ausführung: logrotate -f /etc/logrotate.d/mein-dienst – ignoriert Zeitpläne, ideal zum Verifizieren.
  • Journal-Integrität: journalctl --verify – prüft die binären Dateien auf Konsistenz.
  • Ergebnis prüfen: ls -lh /var/log/mein-dienst/ – kontrolliert neue Dateien und Archive.
  • Dienststatus: systemctl status mein-dienst – bestätigt, dass der Dienst nach SIGHUP weiterläuft.

Ich empfehle, den Trockenlauf in Ihre Deployment-Pipeline zu integrieren. Ein fehlerhaftes Logrotate-Skript kann einen Dienst lahmlegen, und das merken Sie im schlechtesten Fall nachts um drei. Eine Zeile im CI-Skript verhindert das.

Die Rotation automatisieren und überwachen

Logrotate läuft auf modernen Distributionen über einen systemd-Timer, den Sie mit systemctl status logrotate.timer prüfen – ist er inaktiv, werden Ihre Regeln nie ausgeführt.

Der Timer ersetzt den klassischen Cron-Eintrag und startet logrotate.service in der Regel zweimal täglich. Prüfen Sie den Status aktiv, und schauen Sie sich die letzten Läufe im Journal an:

systemctl status logrotate.timer
journalctl -u logrotate --since "7 days ago"

Für die Überwachung empfehle ich zwei Ebenen. Erstens ein täglicher Check der Journal-Größe gegen einen Schwellwert, etwa per Skript mit journalctl --disk-usage. Zweitens eine Alarmierung, wenn der Timer länger als 24 Stunden nicht gelaufen ist. Beides lässt sich mit gängigen Monitoring-Werkzeugen abbilden.

Ein Hinweis zur Resilienz: Auf Systemen mit vielen Diensten kann der Logrotate-Lauf mehrere Sekunden dauern. Der Timer-Typ OnCalendar mit Persistent=true sorgt dafür, dass ein verpasster Lauf nachgeholt wird – wichtig für Server, die zeitweise offline sind.

Häufige Fehler, die Sie vermeiden sollten

Die meisten Probleme entstehen nicht durch fehlende Konfiguration, sondern durch falsch kombinierte Parameter – hier sind die Stolperfallen, die mir in der Praxis am häufigsten begegnen.

  • Logrotate direkt auf .journal-Dateien anwenden wollen – das binäre Format macht das unmöglich.
  • systemctl restart systemd-journald nach Änderungen vergessen – die alten Werte bleiben aktiv.
  • SystemMaxUse höher setzen als der verfügbare Speicherplatz hergibt.
  • Das postrotate-Skript weglassen, sodass Dienste in die alte Datei weiterschreiben.
  • Keine Obergrenze für die Dateianzahl definieren – die Partition füllt sich trotz Größenlimit.
  • Änderungen ohne Trockenlauf einspielen und den Fehler erst im Betrieb bemerken.
  • Storage=volatile setzen und sich wundern, warum nach dem Neustart alle Logs fehlen.

Häufig gestellte Fragen zur Logrotate-Konfiguration für systemd-Journal

Kann Logrotate das systemd-Journal direkt rotieren?

Nein, das ist technisch ausgeschlossen, weil das Journal ein binäres Format mit eigenem Index verwendet und journald die Rotation selbst über journald.conf steuert – Logrotate greift ausschließlich bei Textdateien.

Was ist der Unterschied zwischen SystemMaxUse und MaxRetentionSec?

SystemMaxUse begrenzt den Speicherplatz in Byte, MaxRetentionSec die Aufbewahrungsdauer in Sekunden – beide Grenzen wirken parallel, und es greift jeweils die restriktivere Regel.

Wo finde ich die Journal-Dateien auf dem Dateisystem?

Im persistenten Modus liegen sie unter /var/log/journal/, im flüchtigen Modus unter /run/log/journal/ – bei letzterem verschwinden alle Einträge beim Neustart.

Muss ich nach Änderungen an journald.conf etwas neu starten?

Ja, ein systemctl restart systemd-journald ist erforderlich, damit die neuen Werte greifen – ein bloßes daemon-reload genügt hier nicht.

Wie prüfe ich, ob meine Konfiguration tatsächlich funktioniert?

Kombinieren Sie journalctl --disk-usage zur Größenkontrolle, journalctl --verify zur Integritätsprüfung und einen Trockenlauf via logrotate --debug für die Textdateien.

Wie Sie Ihre Logs dauerhaft im Griff behalten

Die Kernbotschaft lautet: journald und Logrotate sind zwei getrennte Werkzeuge für zwei getrennte Aufgaben – wer das einmal verinnerlicht hat, konfiguriert beide Systeme in wenigen Minuten sauber und skalierbar.

Meine Empfehlung aus der Praxis: Setzen Sie die journald-Limits bewusst und dokumentieren Sie sie im Repository. Prüfen Sie die Werte vierteljährlich gegen das tatsächliche Wachstum. Und behalten Sie den Logrotate-Timer im Monitoring, denn ein stillstehender Timer ist ein stiller Fehler.

Prüfen Sie noch heute Ihre Journal-Größe mit journalctl --disk-usage und passen Sie Ihre Konfiguration entsprechend an – so vermeiden Sie unangenehme Überraschungen beim Speicherplatz und gewinnen gleichzeitig eine belastbare Grundlage für Forensik und Fehleranalyse.

Anna Berger
Anna Berger
IT-Sicherheitsanalystin und Tech-Journalistin

Schon als Kind war ich fasziniert von der Logik hinter Computern und der unendlichen Welt der Daten. Was als spielerische Neugier mit dem Zerlegen alter PCs begann, entwickelte sich schnell zu einer tiefen Leidenschaft für die Informatik. Heute sehe ich es als meine Berufung, komplexe digitale Themen greifbar zu …

Tous les articles de Anna Berger →