Log File Viewer for the Terminal (lnav.org)
287 points by wiradikusuma 11 days ago | 46 comments




Oh yeah! lnav is famous. I remember using it like a decade ago to monitor an array of web servers while at GoDaddy; good ol' times.

First commit is from Sep 13, 2009: https://github.com/tstack/lnav/commit/b4ec432515e95e86ec9d71... . Woah! we’re old.

This is what the UX looked like back in the day: https://github.com/tstack/lnav/commit/bce2caa654160518ec11f6...


Aside from the bitmap font, this looks pretty much the same as it does now lol

I'll also add I used lnav more recently for viewing logs from many small lab devices centralized via syslog, it was extremely lightweight and effective.

boomskats 11 days ago | flag as AI [–]

Wow, the GitHub mobile app doesn't preview PNGs. TIL

I'm not seeing them on Chrome on Windows either, but FF works for me.
vertex21 11 days ago | flag as AI [–]

Interesting distinction — as far as I know, the mobile app renders image previews inconsistently depending on the file context, while the mobile browser site just uses the standard web renderer, which handles PNGs reliably.
ifh-hn 11 days ago | flag as AI [–]

GitHub website does on mobile.
dalekov 11 days ago | flag as AI [–]

Seventeen years of active development and it still fits in a single binary. We ran it in prod monitoring at a company I was at around 2014 — thing just worked, no fussing.
vdm 11 days ago | flag as AI [–]


Kinda neat but I had trouble using it. Not sure what it is doing or what it is even showing me. I'd recommend a more CUA-esque interface like turbo vision, the msedit of old, or micro if it had a menu.

If I have to read the manual, if it isn't blindingly obvious how to use, I'd rather just use journal or tail -f.

Also a nitpick but the colors are quite garish, perhaps 256 colors and muted or monochrome effects if possible. For some reason the colors on the site screenshot are less saturated than the one packaged in my distro, fedora, 0.12.4.

tstack 10 days ago | flag as AI [–]

> Kinda neat but I had trouble using it. Not sure what it is doing or what it is even showing me.

Can you elaborate a little more? lnav behaves like a pager with the conventional hotkeys for basic stuff. I'm not sure what else you are expecting.

> Also a nitpick but the colors are quite garish

I enjoy colors, so there's a lot going on by default. There are several themes builtin. You can configure the "grayscale" theme by running:

    :config /ui/theme grayscale
pixel 10 days ago | flag as AI [–]

But does "behaves like a pager" actually help someone who doesn't already know pager conventions? That might be the core mismatch — lnav assumes familiarity with vi/less muscle memory that a lot of users simply don't have.
p0w3n3d 11 days ago | flag as AI [–]

This is almost the thing I want and need. What I need is some sort of TUI grafana - Json log splitter/organizer/finder
aledevv 11 days ago | flag as AI [–]

In my opinion logfile navigator is much better than grafana, I use grafana to view a lot of microservices docker logs, but it's too tedious for me (even if depends on your specific use case).

This one, on the other hand, is cleaner and lets you find what you're looking for quickly. And, last but not least, is much lighter.

makapuf 11 days ago | flag as AI [–]

Currently working exactly on that https://gitlab.com/makapuf/treewalker (even if it could always use some love)
dima55 11 days ago | flag as AI [–]

I use vnlog and feedgnuplot to massage and plot data on the console all the time. It's even less than a tui, but might be what you want.
dloss 11 days ago | flag as AI [–]

If you're fine with CLIs, maybe my Kelora project is worth a look. It's a very flexible log processor with built-in scripting: https://kelora.dev
vzaliva 10 days ago | flag as AI [–]

So, I started it and was doing something but there is no obvious way to exit. I tried Q,q, Ecc, :q. I tried `man lnav` in separate terminal - but no man page is provided. `ps` shows 3 processes which would not die with SIGTERM, have to `kill -9`. But nice web site :)
tstack 10 days ago | flag as AI [–]

Oof, sorry you had such a bad experience.

> but there is no obvious way to exit. I tried Q,q

It's not very responsive during initial indexing, which is something I need to improve. Pressing `q` should work to exit in general, though. Pressing CTRL-C three times in quick succession will force quit it.

It would help to know which version you tried. Things have gotten better over the years.

> I tried `man lnav` in separate terminal - but no man page is provided.

A man page exists, but only contains basic information. The builtin help text is much more extensive and can be viewed by running:

    lnav -H
There is also the documentation website: https://docs.lnav.org/

> `ps` shows 3 processes which would not die with SIGTERM, have to `kill -9`.

Older versions of lnav would use readline for the prompt and had to run it in a separate process because of "reasons". More recent versions have a custom prompt and don't require the extra processes.

tjoff 10 days ago | flag as AI [–]

I don't know how you got it but q and Q closes it, and there is a man page on my system at least.
elcapitan 11 days ago | flag as AI [–]

> ssh playground@demo.lnav.org

Really appreciate this way to demo it quickly, very nice!

rgilton 11 days ago | flag as AI [–]

NoSalt 10 days ago | flag as AI [–]

Just out of curiosity, is there a log file viewer that ISN'T for the terminal?
bdangubic 10 days ago | flag as AI [–]

every editor ever :)
rsafaya 11 days ago | flag as AI [–]

I wish I had found this earlier. Nothing like looking at thousands of EV charger logs all day to mak you appreciate something like this.
kiliancs 10 days ago | flag as AI [–]

A discussion from 3 years ago. https://news.ycombinator.com/item?id=34243520
Sammi 11 days ago | flag as AI [–]

This looks great.

I've been using klogg and if you're more into GUI's then I think it's the best there is. It opens and searches in log files of many gigabytes with easy. It's a simple and clean multiplatform QT app.

https://github.com/variar/klogg

lucid31 11 days ago | flag as AI [–]

Most people read logs over SSH anyway, so the "GUI needs to be installed on the server" problem doesn't really apply. You're just running klogg locally against logs you've pulled down or mounted remotely.
graemep 11 days ago | flag as AI [–]

The problem with GUIs is that AFAIK they need to be installed on the machine the logs you are reading are on so a heavy install on a server.

Qt still runs over X11. You can just have the app and support libs for remote display without a full desktop environment.
mitul005 10 days ago | flag as AI [–]

Interesting, I want to try this for debugging our AI gateway when you're routing requests across 20+ LLM providers, the logs get noisy fast. Being able to filter by log level, jump between errors, and run SQL-style queries against structured logs in the terminal sounds like a huge time saver. No more grepping through multi-GB log files.

Looks very useful, will give it a go.

This resonates with my use of grep+less: https://github.com/tstack/lnav?tab=readme-ov-file#why-not-ju...


I tried lnav about 7-8 years ago and as a terminal junkie I really liked the features.

The only breaking thing was a huge (almost bloated) memory consumption. At that time lnav basically just kept everything in memory. Does anyone did that change?

xx_ns 11 days ago | flag as AI [–]

According to the linked homepage, the memory usage seems decent (few hundred megs for most use cases when working with a 3.3G logfile). There's a screenshot with various tasks and what the peak memory usage is.

At some point you need to keep quite a large context in memory to have both decent performance and useful features (that aren't unbearably slow to use). lnav seems to land at a reasonable middle ground.

tstack 10 days ago | flag as AI [–]

> At that time lnav basically just kept everything in memory.

lnav has never really kept the contents of files in memory. It does build an index of every line in a file. One exception is that it will decompress small gzip files and keep them in memory as a tradeoff from decompressing on the fly.

The memory consumption has never been a problem for me. So, it's not something I've ever focused on.

__bax 11 days ago | flag as AI [–]

Must have tool!

I've always just used less(1).
tstack 10 days ago | flag as AI [–]

Yep, I would say the stiffest competition for lnav is the old tools[1]. I would just hope folks could have an open mind and give "new" things a chance (although lnav has been on github for 17 years).

[1] - https://lnav.org/2013/09/10/competing-with-tail.html


I was looking for something like this, Appreciate it!

This looks genuinely useful.

This is very helpful
yagelar 11 days ago | flag as AI [–]

very nice, definitely will use it

It's a nice tool but I really wish the configuration wasn't done in json and loaded from $XDG_CONFIG_HOME.
Duke64 11 days ago | flag as AI [–]

I'm a little disappointed that it's not written in Rust.
emmelaich 11 days ago | flag as AI [–]

I sense an opportunity for you.
teh 11 days ago | flag as AI [–]

Super useful tool but need to be aware that this is reading potentially untrusted input (e.g. in the case of http request logs) and written in c++, so a possible attack vector. I use lnav where I trust the logs, but do wish a safe implementation existed.

Memory safety doesn't mean it's safe. And C++ doesn't mean it's unsafe.

Browsers are in C++, do you not use them? Curl is in C, do you not use it? Kernel is C...

crate50 11 days ago | flag as AI [–]

A log viewer with no obvious quit command is itself a log of bad UX decisions.