wikicmd(1)Handbuch der Kommandozeile
wikicmd.de

Stand 17. November 2026

Handbuchseite

13. November 2026

journalctl eingrenzen: Zeitfenster, Priorität und Einheit kombinieren

journalctl ohne Filter liest 1,8 Millionen Zeilen. Mit --since, -p und -u bleiben 41 Zeilen in 0,3 Sekunden. Was -p wirklich einschließt und wo Zeitangaben in die Falle führen.

journalctl --since "-2h" -p warning -u nginx ist die Abfrage, die bei einem Vorfall zuerst gebraucht wird: aus einem Journal mit 2,1 GB und rund 1,8 Millionen Einträgen bleiben 41 Zeilen übrig, gelesen in 0,3 Sekunden. Die drei Filter wirken in dieser Reihenfolge: Zeitfenster schneidet den Index, -u die Einheit, -p die Schwere. Wer sie einzeln einsetzt, liest zu viel; wer sie kombiniert, bekommt eine Liste, die auf eine Bildschirmseite passt.

Zeitfenster mit --since und --until

--since und --until akzeptieren absolute und relative Angaben. Absolut sind "2026-11-13 09:00:00" und die Kurzform "2026-11-13", relativ sind "yesterday", "today", "-1h", "2 hours ago" und "@1762992000" für Sekunden seit der Epoche. Die vollständige Grammatik steht in der Dokumentation zu systemd.time.

Die Falle liegt in der Zeitzone. Das Journal speichert Zeitstempel in UTC, aber --since wird ohne Zusatz in der lokalen Zeitzone interpretiert. Auf einem Server mit Europe/Berlin bedeutet --since "09:00" neun Uhr Ortszeit, nicht neun Uhr UTC. Wer aus einem UTC-Log eines anderen Systems kopiert, verschiebt das Fenster um ein oder zwei Stunden. Ein angehängtes Z oder +00:00 macht die Absicht eindeutig, --utc stellt zusätzlich die Ausgabe um.

Zweite Falle: Bei der Zeitumstellung existiert eine Stunde zweimal, und --since "02:30" trifft dann eine der beiden. Für Nachweise nimmt man absolute Zeitstempel mit Offset, nicht die lokale Kurzform.

Grenzen des Journals

Ein Zeitfilter zeigt nur, was noch da ist. Ohne /var/log/journal schreibt systemd flüchtig nach /run/log/journal, und nach einem Neustart ist der Vorfall verschwunden. Standardmäßig begrenzt SystemMaxUse das Journal auf 10 Prozent des Dateisystems, höchstens 4 GB; ältere Einträge werden rotiert. Und je Dienst werden standardmäßig 10.000 Zeilen in 30 Sekunden angenommen, darüber hinausgehende Meldungen verwirft systemd und vermerkt das im Journal. Wenn eine Störungsserie fehlt, ist das der erste Verdacht, nicht der Filter.

Priorität: was -p wirklich einschließt

-p err bedeutet nicht "nur err". Es bedeutet "err und alles Schwerere". Die Stufen sind durchnummeriert, und ein Filter auf eine Stufe schließt alle kleineren Werte ein:

WertNameBedeutung
0emergSystem unbrauchbar
1alertsofortiges Eingreifen
2critkritischer Zustand
3errFehler
4warningWarnung
5noticenormal, aber bemerkenswert
6infoInformation
7debugDiagnose

Neuere Fassungen akzeptieren auch Bereiche wie -p 3..4, also err bis warning ohne crit und emerg. Namen und Zahlen sind austauschbar; -p 4 und -p warning sind dasselbe. Wichtig für die Praxis: -p warning ist der übliche Einstieg bei Fehlersuche, weil Stufe 3 oft schon von einem Neustart herrührt und die Ursache in Stufe 4 steht.

Kombinieren, verengen, belegen

-u filtert auf eine Einheit, -b auf einen Boot, -k auf Kernel-Meldungen. -g durchsucht die Nachricht per regulärem Ausdruck, was auf großen Journalen teuer ist, weil dafür jede Meldung gelesen wird; erst Zeitfenster und Einheit setzen, dann -g. -o short-iso-precise liefert Zeitstempel mit Offset, -o cat nur die Nachricht ohne Kopfzeilen, was für Pipes und Auswertungen besser ist.

journalctl --since "2026-11-13 08:00:00+01:00" \
  --until "2026-11-13 09:00:00+01:00" \
  -u nginx.service -p 4 -o short-iso-precise --no-pager

Zur Gegenprobe gehört ein Blick auf die tatsächlich enthaltenen Stufen: journalctl -u nginx -p 4 --since "-1h" -o json | jq -r '.PRIORITY' | sort | uniq -c. Erscheint dort eine 6 oder 7, hat der Filter nicht gegriffen, meist wegen einer zweiten Konfigurationsdatei oder weil die Meldung von einer anderen Einheit stammt. Feldnamen wie PRIORITY, _SYSTEMD_UNIT und SYSLOG_FACILITY sind in systemd.journal-fields dokumentiert und lassen sich direkt als Match verwenden, etwa PRIORITY=3 oder _SYSTEMD_UNIT=nginx.service.

Für die Bestandsfrage genügt journalctl --disk-usage. Aufräumen mit --vacuum-time=2weeks ist ein eigener Schritt und sollte nie Teil einer Diagnoseabfrage sein: Er löscht, was nach dem Aufräumen nicht mehr für den Vergleich zur Verfügung steht. Die vollständige Optionsliste steht in der journalctl-Handbuchseite.

Bei Neustarts hilft --list-boots: Es nummeriert die Läufe, und -b -1 liest den vorigen, -b -2 den davor. Wer -b und --since gemeinsam setzt, bekommt die Schnittmenge beider Fenster. Passt der Zeitstempel nicht zum gewählten Boot, ist die Ausgabe leer, und leer heißt hier nicht "keine Fehler", sondern "falsches Fenster".

Für die Ausgabeform gilt dasselbe Prinzip wie für die Filter: so schmal wie möglich. -o cat liefert nur die Nachricht und eignet sich für Pipes, -o short-iso-precise liefert Zeitstempel mit Offset und eignet sich für einen Nachweis, -o json ist für Auswertungen gedacht, kostet aber ein Vielfaches an Zeilen. Ein -o verbose auf einem vollen Journal erzeugt schnell mehrere Megabyte, die niemand liest.

Ein typischer Ablauf bei einem hängenden Dienst sieht so aus: journalctl -u dienst.service -b -p 4 --no-pager für den Überblick, dann dasselbe mit --since auf die Minute des Ausfalls, dann -g auf den vermuteten Fehlertext, und zuletzt -o json mit jq, wenn ein Zeitstempel exakt belegt werden muss. Jeder Schritt verkleinert die Menge, statt sie neu zu durchsuchen.

Belege

← Zur Startseite