🪵 Instalar o lnav mais recente no Debian

O que é o lnav?

O lnav, the Logfile Navigator, é um visualizador de logs para o terminal que junta arquivos de log de várias fontes em uma única visão ordenada por timestamp. Aponte para alguns arquivos, um diretório ou um arquivo compactado e ele descobre os formatos sozinho (syslog, o journal do systemd, logs de acesso do Apache e do nginx, JSON lines e muitos outros), intercala as mensagens pelo horário, colore erros e avisos para que se destaquem e continua acompanhando os arquivos conforme crescem. A partir daí você filtra, pesquisa, pula de um erro para outro e, quando uma pergunta exige mais que uma busca, consulta as mensagens com SQL. Ele abre logs remotos por ssh tão facilmente quanto os locais. O lnav é escrito em C++ por Tim Stack, sob licença BSD-2-Clause.

⚡ Principais recursos do lnav

📦 Instalação a partir do 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

# Instalar a versão mais recente do lnav (substitui o lnav mais antigo da distribuição)
sudo apt install lnav

# Verificar a instalação
dpkg -s lnav | grep Version

# Instalar a versão mais recente do lnav (substitui o lnav mais antigo da distribuição)
apt install lnav

# Verificar a instalação
dpkg -s lnav | grep Version

# Os logs em /var/log podem ser lidos pelo root e pelo grupo adm
sudo lnav /var/log

# Sem rsyslog (o padrão do Debian)? Leia o journal do systemd como JSON
journalctl -o json | lnav

# Os seus próprios logs não precisam de sudo; o formato é detectado
lnav ~/app/logs/

# Aperte ? dentro do lnav para a ajuda embutida, q para sair

# Os logs em /var/log podem ser lidos pelo root e pelo grupo adm
lnav /var/log

# Sem rsyslog (o padrão do Debian)? Leia o journal do systemd como JSON
journalctl -o json | lnav

# Os seus próprios logs não precisam de sudo; o formato é detectado
lnav ~/app/logs/

# Aperte ? dentro do lnav para a ajuda embutida, q para sair

🎯 Exemplos básicos de uso

Lendo e acompanhando logs:

# Logs rotacionados e compactados abrem direto, assim como arquivos
lnav /var/log/nginx/access.log.2.gz support-bundle.tar.gz

# Várias fontes, juntas em uma linha do tempo por timestamp
lnav /var/log/nginx/ ~/app/logs/app.log

# Um log em outra máquina, pela sua configuração ssh de sempre
lnav user@host:/var/log/syslog

Filtros e SQL:

# Dentro do lnav: e / E pulam para o erro seguinte / anterior, w / W para os avisos
# :filter-in error         manter só as linhas que casam
# :filter-out healthcheck  esconder as linhas que casam
# ;SELECT c_ip, count(*) AS hits FROM access_log GROUP BY c_ip ORDER BY hits DESC

# A mesma consulta sem a interface, para scripts
lnav -n -c ';SELECT sc_status, count(*) FROM access_log GROUP BY sc_status' /var/log/nginx/access.log

Mantendo em dia:

# O lnav é atualizado junto com o resto do sistema
sudo apt update && sudo apt upgrade

# Qual versão está instalada e qual é a mais recente disponível
apt policy lnav

# Remover
sudo apt remove lnav

# O lnav é atualizado junto com o resto do sistema
apt update && apt upgrade

# Qual versão está instalada e qual é a mais recente disponível
apt policy lnav

# Remover
apt remove lnav

🚀 Por que escolher o deb.griffo.io?

• ✅ O mesmo nome de pacote do Debian: o pacote se chama lnav, exatamente como no arquivo do Debian, então este repositório atualiza o lnav padrão no lugar com apt upgrade e um apt remove depois não deixa nada para trás
• ✅ O build estático oficial: o binário estático musl do próprio upstream, sem nenhuma dependência em tempo de execução e com o mesmo comportamento em todas as versões
• ✅ Pacote completo: o binário lnav e a sua página man, com openssh-client recomendado para logs remotos e wl-clipboard ou xclip sugeridos para copiar linhas
• ✅ Atualizações automáticas: os pacotes são atualizados poucas horas após cada lançamento upstream
• ✅ Duas arquiteturas: amd64 e arm64 em todas as versões, então o mesmo lnav roda em servidores, notebooks e placas ARM como o Raspberry Pi
• ✅ Multi-distribuição: funciona no Bookworm, Trixie, Forky e Sid
• ✅ Manutenção simples: atualizações com os comandos apt de sempre

📦 Repositório de build do pacote

Os pacotes Debian são construídos e mantidos automaticamente neste repositório do GitHub:

• 🪵 lnav-debian - Builds dos últimos lançamentos

🔗 Pacotes relacionados

Também disponíveis no deb.griffo.io:

• lazydocker - Uma interface de terminal para o Docker, para achar o contêiner cujos logs você precisa
• k9s - Uma interface de terminal para clusters Kubernetes e seus pods
• ripgrep - Busca recursiva rápida, para pesquisar uma árvore inteira de logs de uma vez
• bottom - Um monitor do sistema para o terminal, para o que os logs não contam
• fzf - Um buscador fuzzy para escolher o log a abrir