lnav

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

lnav (Logfile Navigator) ist ein Betrachter für Protokolldateien im Terminal. Er erkennt gängige Formate wie Syslog, das systemd-Journal oder die Zugriffsprotokolle von nginx selbstständig, färbt Fehler rot und Warnungen gelb ein und mischt mehrere Dateien nach Uhrzeit zu einer gemeinsamen Ansicht. Mit einem Tastendruck springst du zum nächsten Fehler, blendest Zeilen per Filter aus oder zeigst ein Balkendiagramm, wann wie viele Meldungen auftraten. Wer mehr wissen will, fragt die Protokolle sogar mit SQL ab, etwa welche Adressen am häufigsten auf die Website zugreifen.

Vorbemerkungen

  • Installation über apt: Ubuntu 26.04 liefert lnav 0.13.2. Es ist ein einzelnes Paket ohne weitere Abhängigkeiten.
  • Leserechte: Die meisten Dateien unter /var/log gehören der Gruppe adm. Der erste Benutzer, der bei der Installation von Ubuntu angelegt wurde, gehört dieser Gruppe an und kann sie ohne sudo lesen. Ob das bei dir so ist, zeigt id -nG. Fehlt adm in der Liste, brauchst du sudo lnav.
  • Nur lesen: lnav verändert die Protokolle nicht. Es merkt sich Filter und die zuletzt angesehene Stelle in ~/.config/lnav.
  • Englische Oberfläche: Hilfe, Statuszeilen und Befehle sind englisch.
  • Version: Getestet mit lnav 0.13.2 am 3. Oktober 2026.

Installation

1. Paketlisten aktualisieren

Damit apt die aktuellen Versionen kennt.

sudo apt update

2. lnav installieren

sudo apt install lnav

3. Version prüfen

lnav -V

Prüfen: Die Ausgabe lautet lnav 0.13.2.

Protokolle ansehen

4. Systemprotokoll öffnen

Ohne Angabe öffnet lnav das Systemprotokoll /var/log/syslog.

lnav

Prüfen: Das Terminal zeigt die Meldungen mit Datum und Uhrzeit, Fehler rot, Warnungen gelb. Die Ansicht steht am Ende, also bei den neuesten Meldungen, und neue Zeilen erscheinen laufend. Oben stehen Uhrzeit und Statuszeile, unten Hinweise zur Bedienung.

5. Durch die Meldungen bewegen

TasteWirkung
↑ ↓eine Zeile hoch oder runter
Bild↑ Bild↓eine Seite hoch oder runter
g / Gzum Anfang / zum Ende
E / ezum vorigen / nächsten Fehler
W / wzur vorigen / nächsten Warnung
D / d24 Stunden zurück / vor
←zeigt am Zeilenanfang, aus welcher Datei die Meldung stammt

Drücke zum Ausprobieren E: lnav springt zur letzten Fehlermeldung über der aktuellen Stelle. Steht die Ansicht am Ende und du drückst e, meldet die untere Zeile, dass es danach keinen Fehler mehr gibt.

6. Text suchen

Drücke /, tippe einen Suchbegriff wie nginx und bestätige mit Enter. Schon während des Tippens werden Treffer hervorgehoben. n springt zum nächsten, N zum vorigen Treffer. Der Suchbegriff ist ein regulärer Ausdruck, fail|error findet also beide Wörter.

7. Meldungen über die Zeit anzeigen

Drücke i. lnav zeigt ein Balkendiagramm mit der Zahl der Meldungen je Zeitabschnitt, aufgeteilt in normale Meldungen, Fehler und Warnungen. So fällt auf, wann sich Fehler gehäuft haben. z und Z zoomen hinein und hinaus. Ein weiterer Druck auf i führt zurück zu den Meldungen.

8. Hilfe aufrufen

? öffnet die eingebaute Hilfe mit allen Tasten und Befehlen. q schließt sie wieder.

9. lnav beenden

Drücke q. In einer Unteransicht wie dem Balkendiagramm führt q zuerst zurück zu den Meldungen, ein weiteres q beendet lnav.

Mehrere Protokolle zusammen

10. Dateien gemeinsam öffnen

Gibst du mehrere Dateien an, sortiert lnav ihre Meldungen nach der Uhrzeit ineinander. So siehst du zum Beispiel, was im Systemprotokoll geschah, kurz bevor sich jemand per sudo angemeldet hat.

lnav /var/log/syslog /var/log/auth.log

Mit ← blendest du am linken Rand ein, aus welcher Datei jede Zeile stammt. Auch Ordner lassen sich angeben, z. B. lnav /var/log/nginx. Gepackte ältere Dateien wie access.log.2.gz liest lnav ebenfalls.

11. systemd-Journal ansehen

Viele Dienste schreiben nur ins systemd-Journal. journalctl gibt es im JSON-Format aus, und lnav liest es über eine Pipe. Dieser Befehl zeigt alle Meldungen seit dem letzten Systemstart:

journalctl -b -o json | lnav

Auf einen Dienst beschränkt, z. B. nginx:

journalctl -u nginx -o json | lnav

Filtern

12. Nur passende Zeilen zeigen

Befehle beginnen in lnav mit einem Doppelpunkt. Tippe in der laufenden Ansicht:

:filter-in sudo

und bestätige mit Enter. Nun erscheinen nur noch Zeilen, die sudo enthalten. Die Statuszeile nennt, wie viele Zeilen ausgeblendet sind.

13. Zeilen ausblenden

Umgekehrt blendet :filter-out passende Zeilen aus, etwa die vielen Meldungen eines gesprächigen Programms:

:filter-out google-chrome

Mehrere Filter wirken gleichzeitig.

14. Nur Fehler zeigen

:set-min-log-level error

Damit erscheinen nur noch Meldungen der Stufe Fehler und schlimmer. :set-min-log-level warning lässt auch Warnungen durch.

15. Filter verwalten

Tab öffnet unten die Liste der Filter. Mit ↑ und ↓ wählst du einen aus, Leertaste schaltet ihn aus und ein, D löscht ihn. Tab oder q führt zurück zu den Meldungen. lnav merkt sich die Filter für das nächste Öffnen derselben Dateien.

Mit SQL auswerten

16. SQL-Abfrage stellen

Abfragen beginnen mit einem Semikolon. Jedes erkannte Format ist eine Tabelle, das Systemprotokoll heißt syslog_log. Diese Abfrage zählt die Meldungen je Stufe:

;SELECT log_level, count(*) AS anzahl FROM syslog_log GROUP BY log_level

Nach Enter erscheint das Ergebnis als Tabelle, z. B. mit den Zeilen info, warning und error. q führt zurück zu den Meldungen, v wieder zum Ergebnis.

17. Zugriffe auf nginx auswerten

Die Zugriffsprotokolle von nginx und Apache erscheinen als Tabelle access_log mit Spalten wie c_ip (Adresse des Besuchers), cs_uri_stem (aufgerufene Seite) und sc_status (Antwortcode). Weil die Datei nur für die Gruppe adm lesbar ist, gilt dasselbe wie bei Syslog.

lnav /var/log/nginx/access.log
;SELECT c_ip, count(*) AS anzahl FROM access_log GROUP BY c_ip ORDER BY anzahl DESC LIMIT 10

Das Ergebnis listet die zehn Adressen mit den meisten Zugriffen.

18. Ohne Oberfläche auswerten

Mit -n läuft lnav ohne Bildschirmoberfläche und gibt das Ergebnis direkt aus. Das eignet sich für Skripte. -c übergibt den Befehl.

lnav -n -c ';SELECT log_level, count(*) AS anzahl FROM syslog_log GROUP BY log_level' /var/log/syslog

Prüfen: Es erscheint eine kleine Tabelle mit den Spalten log_level und anzahl.

Genauso funktionieren Filter. Dieser Befehl gibt nur die Fehlermeldungen aus:

lnav -n -c ':set-min-log-level error' /var/log/syslog

Wie geht es weiter?

  • Weitere Formate: lnav -i extra installiert zusätzliche Formatbeschreibungen aus dem Projekt, eigene Formate lassen sich als JSON-Datei hinzufügen.
  • Entfernte Rechner: lnav öffnet Protokolle auch über SSH, z. B. lnav benutzer@server:/var/log/syslog. Auf dem anderen Rechner muss dafür nichts installiert sein.
  • Webzugriffe als Bericht: Für eine Übersicht über die Besucher einer Website eignet sich GoAccess.
  • Dokumentation: https://docs.lnav.org sowie die Hilfe mit ? in lnav

Deinstallieren

1. lnav entfernen

sudo apt purge lnav

2. Eigene Einstellungen löschen

lnav legt Einstellungen, gespeicherte Filter und den Verlauf in deinem Home-Ordner ab. Diese Dateien gehören zu keinem Paket.

rm -rf ~/.config/lnav

Prüfen: Der Befehl wird nicht mehr gefunden.

lnav -V

Quellen und Lizenz

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.

Autor: Thorsten · Installationsanleitungen für Ubuntu

Alle Anleitungen ohne Gewähr. Befehle mit sudo verändern das System – vorher lesen, dann ausführen.