🪵 最新の lnav を Debian にインストール

lnav とは

lnav (Logfile Navigator) は、複数のソースのログファイルをひとつにまとめ、タイムスタンプ順に表示するターミナル向けのログビューアです。いくつかのファイルやディレクトリ、圧縮アーカイブを指定するだけで、フォーマット (syslog、systemd ジャーナル、Apache や nginx のアクセスログ、JSON Lines など多数) を自動で判別し、メッセージを時刻順に並べ、エラーと警告を色分けして目立たせ、ファイルが伸びていくのを追いかけ続けます。そこからフィルタ、検索、エラー間のジャンプができ、検索では足りない疑問には SQL でログメッセージを問い合わせられます。ssh 越しのリモートのログも、ローカルと同じ手軽さで開けます。lnav は Tim Stack が C++ で書いたもので、BSD-2-Clause ライセンスです。

⚡ lnav の主な機能

📦 deb.griffo.io からインストールする

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(. /etc/os-release; echo ${DEBIAN_CODENAME:-${UBUNTU_CODENAME:-$VERSION_CODENAME}}) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt update

install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(. /etc/os-release; echo ${DEBIAN_CODENAME:-${UBUNTU_CODENAME:-$VERSION_CODENAME}}) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update

sudo apt install extrepo
sudo extrepo enable griffo
sudo apt update

# 最新の lnav をインストール (ディストリビューションの古い lnav をその場で置き換えます)
sudo apt install lnav

# インストールを確認
dpkg -s lnav | grep Version

# 最新の lnav をインストール (ディストリビューションの古い lnav をその場で置き換えます)
apt install lnav

# インストールを確認
dpkg -s lnav | grep Version

# /var/log 以下のログは root と adm グループが読めます
sudo lnav /var/log

# rsyslog がない (Debian の既定) なら、systemd ジャーナルを JSON で読む
journalctl -o json | lnav

# 自分のログなら sudo は不要。フォーマットは自動判別されます
lnav ~/app/logs/

# lnav の中で ? を押すと組み込みヘルプ、q で終了

# /var/log 以下のログは root と adm グループが読めます
lnav /var/log

# rsyslog がない (Debian の既定) なら、systemd ジャーナルを JSON で読む
journalctl -o json | lnav

# 自分のログなら は不要。フォーマットは自動判別されます
lnav ~/app/logs/

# lnav の中で ? を押すと組み込みヘルプ、q で終了

🎯 基本的な使用例

ログを読んで追いかける:

# ローテートされた圧縮ログも、アーカイブもそのまま開けます
lnav /var/log/nginx/access.log.2.gz support-bundle.tar.gz

# 複数のソースを、タイムスタンプ順のひとつのタイムラインに
lnav /var/log/nginx/ ~/app/logs/app.log

# 別のマシンのログを、いつもの ssh 設定で
lnav user@host:/var/log/syslog

フィルタと SQL:

# lnav の中で: e / E で次 / 前のエラーへ、w / W で警告へ
# :filter-in error         一致する行だけを残す
# :filter-out healthcheck  一致する行を隠す
# ;SELECT c_ip, count(*) AS hits FROM access_log GROUP BY c_ip ORDER BY hits DESC

# 同じクエリを UI なしで、スクリプト向けに
lnav -n -c ';SELECT sc_status, count(*) FROM access_log GROUP BY sc_status' /var/log/nginx/access.log

最新に保つ:

# lnav はシステムの他の部分と一緒に更新されます
sudo apt update && sudo apt upgrade

# インストール済みのバージョンと、利用可能な最新バージョン
apt policy lnav

# アンインストール
sudo apt remove lnav

# lnav はシステムの他の部分と一緒に更新されます
apt update && apt upgrade

# インストール済みのバージョンと、利用可能な最新バージョン
apt policy lnav

# アンインストール
apt remove lnav

🚀 deb.griffo.io を選ぶ理由

• ✅ Debian と同じパッケージ名: パッケージ名は Debian のアーカイブと同じ lnav なので、apt upgrade で標準の lnav がその場でアップグレードされ、後で apt remove しても何も残りません
• ✅ 公式の静的ビルド: 上流自身による musl の静的バイナリなので、実行時の依存関係はまったくなく、どのバージョンでも同じように動作します
• ✅ 完全なパッケージ: lnav バイナリと man ページ。リモートログ用に openssh-client を推奨し、行のコピー用に wl-clipboard または xclip を提案しています
• ✅ 自動更新: 上流のリリースから数時間以内にパッケージを更新
• ✅ 2 つのアーキテクチャ: すべてのバージョンで amd64 と arm64。サーバーでも、ノート PC でも、Raspberry Pi のような ARM ボードでも同じ lnav が動きます
• ✅ マルチディストリビューション: Bookworm、Trixie、Forky、Sid で動作
• ✅ 手間のかからない運用: 更新は通常の apt コマンドだけ

📦 パッケージのビルドリポジトリ

Debian パッケージは、この GitHub リポジトリで自動的にビルド・管理されています:

• 🪵 lnav-debian - 最新リリースのビルド

🔗 関連パッケージ

deb.griffo.io では、こちらも配布しています:

• lazydocker - Docker 向けのターミナル UI。ログを見たいコンテナを探すのに
• k9s - Kubernetes クラスターと Pod のためのターミナル UI
• ripgrep - 高速な再帰検索。ログのツリー全体を一度に grep するのに
• bottom - ターミナル向けのシステムモニター。ログでは分からないことのために
• fzf - 開くログファイルを選ぶためのファジーファインダー