Zum Inhalt springen
SONOYA.com
Raspberry Pi & Linux

journalctl: Fehler unter Linux in den Logs finden

Mit journalctl findest Du heraus, warum ein Dienst streikt oder der Pi neu startet: nach Dienst, Zeit und Priorität filtern, Journal dauerhaft speichern.

Von

Lupe neben Textzeilen als helles Linien-Icon auf dunkelrotem Verlauf als Sinnbild für die gezielte Suche nach Fehlermeldungen im systemd-Journal unter Linux

Ein Dienst startet nicht, der Raspberry Pi hat sich über Nacht neu gestartet, oder ein Skript läuft im Cronjob still ins Leere. Die Antwort steht fast immer im Systemprotokoll, nur gehen die entscheidenden Zeilen zwischen Tausenden harmlosen Meldungen unter. Mit journalctl und einer Handvoll Filter holst Du genau die Zeilen heraus, die Du brauchst, und sorgst dafür, dass die Protokolle auch einen Neustart überleben.

Die Befehle gelten für alle Systeme mit systemd, also für Raspberry Pi OS auf Basis von Debian 13 „Trixie“, Debian 13 selbst sowie Ubuntu 24.04 und 26.04. Ich habe sie mit den Handbuchseiten journalctl(1) und journald.conf(5) abgeglichen, Stand November 2026 mit systemd 257 unter Debian und 259 unter Ubuntu 26.04.

Die Grundlage: Journal lesen und darin blättern

Ohne weitere Angaben zeigt journalctl das komplette Journal vom ältesten Eintrag an. Das ist selten hilfreich. Für den Anfang reichen die letzten Meldungen:

Code
journalctl -e

-e öffnet die Anzeige direkt am Ende. Du blätterst mit den Pfeiltasten oder Bild auf und Bild ab, suchst mit / gefolgt von einem Suchbegriff und Enter, und verlässt die Anzeige mit q. Eine Zeile sieht typischerweise so aus:

Code
Nov 17 08:12:03 raspberrypi sshd-session[812]: Accepted publickey for pi from 192.168.1.20 port 51522 ssh2

Von links nach rechts stehen dort Zeitpunkt, Rechnername, das Programm mit seiner Prozessnummer in eckigen Klammern und die eigentliche Meldung.

Siehst Du stattdessen den Hinweis Hint: You are currently not seeing messages from other users and the system., fehlt Deinem Benutzer die Leseberechtigung für die Systemprotokolle. Setz dann ein sudo vor den Befehl. Der Standardbenutzer von Raspberry Pi OS und der beim Installieren von Ubuntu Server angelegte Benutzer gehören bereits zur Gruppe adm und dürfen alles lesen.

Die wichtigsten Filter

Die Stärke von journalctl liegt darin, dass Du die Filter beliebig kombinieren kannst. Jeder zusätzliche Filter grenzt die Ausgabe weiter ein.

Nach Dienst filtern

Willst Du wissen, was ein bestimmter Dienst gemeldet hat, nennst Du ihn mit -u:

Code
journalctl -u ssh -e

Statt ssh setzt Du den Namen des Dienstes ein, der Dir Sorgen macht, zum Beispiel docker, cron, nginx oder Deinen eigenen. Wie die Dienste auf Deinem System heißen, zeigt systemctl list-units --type=service. Hast Du einen eigenen Dienst nach der Anleitung Eigenen systemd-Dienst anlegen: Skripte dauerhaft starten eingerichtet, landet jede Ausgabe Deines Skripts genau hier.

Live mitlesen

Beim Einrichten ist es praktisch, die Meldungen in Echtzeit zu sehen, während Du in einem zweiten Terminal einen Dienst neu startest:

Code
journalctl -u ssh -f

-f zeigt die letzten zehn Zeilen und danach jede neue Meldung, sobald sie entsteht. Mit Strg + C beendest Du die Anzeige.

Nur Fehler und Warnungen

Jede Meldung trägt eine Priorität von emerg (0, das System ist unbrauchbar) bis debug (7). Mit -p siehst Du nur die angegebene Stufe und alles, was noch wichtiger ist:

Code
journalctl -p err -b

Das zeigt alle Fehler seit dem letzten Systemstart, -b steht dabei für den aktuellen Boot. Ist Dir das zu wenig, nimm -p warning, dann kommen die Warnungen dazu. Oft reicht dieser eine Befehl schon, um die Ursache eines Problems zu sehen.

Nach Zeit eingrenzen

Weißt Du ungefähr, wann es passiert ist, grenzt Du den Zeitraum ein:

Code
journalctl --since "2026-11-17 08:00" --until "2026-11-17 09:00"

Ersetze Datum und Uhrzeit durch Deinen Zeitraum. Die Sekunden darfst Du weglassen. Auch Angaben wie --since today, --since yesterday oder --since "1 hour ago" versteht journalctl.

Nach einem Begriff suchen

Mit -g durchsuchst Du die Meldungstexte. Schreibst Du den Suchbegriff klein, ignoriert die Suche die Groß- und Kleinschreibung:

Code
journalctl -b -g "failed"

Der Suchbegriff ist ein regulärer Ausdruck, "failed|error" findet also beide Wörter.

Nur Kernelmeldungen

Probleme mit Hardware, USB-Geräten, der Stromversorgung oder dem Speicher meldet der Kernel. Diese Meldungen allein bekommst Du mit:

Code
journalctl -k

Beim Raspberry Pi stehen hier zum Beispiel Hinweise auf Unterspannung, deren Ursachen der Artikel Raspberry Pi 5: Unterspannung und das richtige Netzteil erklärt.

Warum hat sich der Rechner neu gestartet?

Für diese Frage brauchst Du die Meldungen aus der Zeit vor dem Neustart. Welche Startvorgänge das Journal kennt, zeigt:

Code
journalctl --list-boots

Die Ausgabe listet jeden Boot mit einer Nummer: 0 ist der aktuelle, -1 der davor und so weiter. Daneben stehen der erste und der letzte Eintrag jedes Boots. Das Ende des vorherigen Laufs siehst Du so:

Code
journalctl -b -1 -e

Endet das Protokoll mit geordneten Meldungen zum Herunterfahren, wurde der Neustart ausgelöst, etwa durch ein automatisches Update oder einen Befehl. Bricht es dagegen mitten im normalen Betrieb ab, ging die Stromversorgung verloren oder das System ist hängen geblieben, bis ein Watchdog es neu gestartet hat. Ergänzend lohnt ein Blick auf journalctl -b -1 -p warning und journalctl -k -b -1.

Bedenke dabei: journald schreibt normale Meldungen nur alle fünf Minuten auf den Datenträger. Bei einem plötzlichen Stromausfall können die letzten Minuten deshalb fehlen. Nur kritische Meldungen landen sofort auf der Platte.

Meldet journalctl -b -1 einen Fehler oder listet --list-boots nur einen einzigen Eintrag, speichert Dein System das Journal nicht dauerhaft. Das ist der nächste Abschnitt.

Das Journal dauerhaft speichern

Das Journal kann im Arbeitsspeicher oder auf dem Datenträger liegen. Im Arbeitsspeicher ist es nach jedem Neustart leer. Wie Dein System das handhabt, hängt von der Distribution ab:

SystemStandard
Raspberry Pi OS Trixienur im Arbeitsspeicher, um die SD-Karte zu schonen
Debian 13 (Neuinstallation)dauerhaft auf dem Datenträger
Ubuntu 26.04dauerhaft auf dem Datenträger
Ubuntu 24.04dauerhaft, sofern /var/log/journal existiert

Auf dem Raspberry Pi ist das eine bewusste Entscheidung von Raspberry Pi: Weniger Schreibzugriffe verlängern die Lebensdauer der SD-Karte. Für die Fehlersuche heißt das aber, dass nach einem unerwarteten Neustart alle Spuren weg sind. Läuft Dein Pi von einer SSD, oder willst Du einem wiederkehrenden Problem auf den Grund gehen, schaltest Du das dauerhafte Speichern mit einer Obergrenze ein. Lege dazu den Ordner für Zusatzeinstellungen an:

Code
sudo mkdir -p /etc/systemd/journald.conf.d

Danach schreibst Du die Einstellung in eine eigene Datei:

Code
printf '[Journal]\nStorage=persistent\nSystemMaxUse=200M\n' | sudo tee /etc/systemd/journald.conf.d/90-persistent.conf

Storage=persistent speichert das Journal unter /var/log/journal, und SystemMaxUse=200M sorgt dafür, dass es nie mehr als 200 MB belegt, ältere Einträge werden dann automatisch gelöscht. Die Zahl 90 im Dateinamen ist wichtig: Raspberry Pi OS bringt eine eigene Datei mit dem Präfix 40 mit, und bei widersprüchlichen Einstellungen gewinnt die Datei, deren Name alphabetisch später kommt. Aus demselben Grund ersetzt die Obergrenze von 200 MB eine kleinere, die Du vielleicht schon früher in einer Datei mit niedrigerer Nummer festgelegt hast. Starte den Journal-Dienst neu, damit die Änderung greift:

Code
sudo systemctl restart systemd-journald

Ob es geklappt hat, siehst Du nach dem nächsten Neustart: journalctl --list-boots zeigt dann mindestens zwei Einträge. Willst Du die SD-Karte später wieder schonen, löschst Du die Datei mit sudo rm /etc/systemd/journald.conf.d/90-persistent.conf und startest den Dienst erneut. Welche weiteren Einstellungen einem Pi im Dauerbetrieb guttun, zeigt Raspberry Pi im Dauerbetrieb: SD-Karte schonen, stabil laufen.

Platz prüfen und alte Einträge löschen

Wie viel Platz das Journal belegt, zeigt dieser Befehl:

Code
journalctl --disk-usage

Die Antwort lautet etwa Archived and active journals take up 56.0M in the file system. Ist es Dir zu viel, löschst Du alles, was älter als zwei Wochen ist:

Code
sudo journalctl --rotate --vacuum-time=2weeks

--rotate schließt zuerst die aktuell beschriebene Datei ab, denn aufgeräumt werden nur abgeschlossene Dateien. Statt einer Zeit kannst Du mit --vacuum-size=100M auch eine Größe angeben.

Wenn Du mit der Ausgabe weiterarbeiten willst

Für eine Fehlermeldung in einem Forum oder einem Bugreport kopierst Du die Zeilen am besten ohne die Blätteranzeige:

Code
journalctl -u ssh -b --no-pager -n 50

Das gibt die letzten 50 Meldungen des Dienstes aus dem aktuellen Boot direkt im Terminal aus. Mit > ssh-log.txt am Ende des Befehls landen sie in einer Datei, die Du weitergeben kannst. Prüf vorher, ob darin IP-Adressen oder Benutzernamen stehen, die Du nicht teilen möchtest.

Kurz gesagt

Für die meisten Probleme genügen drei Befehle: journalctl -u <dienst> -e für einen streikenden Dienst, journalctl -p err -b für alle Fehler seit dem Start und journalctl -b -1 -e für die Frage, was vor dem letzten Neustart passiert ist. Auf dem Raspberry Pi funktioniert Letzteres erst, wenn Du das Journal dauerhaft speicherst, und genau dieser Schritt ist es, der Dir beim nächsten rätselhaften Neustart die Antwort liefert.

Weiterlesen.