LogT — Современный Explorer логов (TUI)

Легковесная альтернатива lnav с упором на UX, авто-парсинг JSON и мгновенную фильтрацию.

🚀 Возможности

Основные

• Мульти-source tailing — Слежение за несколькими файлами по шаблону (./logs/*.log)
• Ring Buffer — Хранит последние 5000 строк в памяти (настраивается)
• Stdin Support — cat app.log | logt
• Log Forwarding — Экспорт отфильтрованных логов в файл (--forward) или stdout (--forward -)
• Time Filtering — Фильтрация по времени (--since 1h, --until 2024-01-15)
• JSON Path Filtering — Мощная фильтрация JSON (--json '.level == "error"')
• Headless Mode — CLI режим без TUI (--headless --stats)
• Bookmarks — Сохранение важных строк (m, M, e)
• Shell Completions — Автодополнение для bash/zsh/fish (logt completion bash)
• Rate Calculator — Отображение скорости поступления логов в status bar

Просмотр

• Live Tail — Автопрокрутка при поступлении новых строк
• Подсветка синтаксиса — Цветовая кодировка уровней (INFO=синий, WARN=желтый, ERROR=красный)
• JSON Expand — Нажмите Enter на JSON строке для разворачивания в полноэкранное дерево

Интерактивность

• Фильтр по тексту — Нажмите / для мгновенной фильтрации по подстроке
• Regex Filter — Нажмите r для режима регулярных выражений
• Pause/Resume — Нажмите Space для паузы автопрокрутки
• Source Toggle — Нажмите Tab для показа/скрытия панели источников
• JSON Explorer — Нажмите Enter на JSON строке для просмотра ключей

🚀 Тесты производительности

Протестировано на Intel Core i3-10100 @ 3.6 GHz:

Операция	Скорость	Примечания
RingBuffer Add	~27M ops/sec	Потокобезопасный, блокировка-free чтение
JSON Парсинг	~314K строк/sec	Авто-детект + парсинг
Фильтр по тексту	~3.7M совпадений/sec	Без учёта регистра
Определение уровня	~394K строк/sec	На основе регулярных выражений
IsValidJSON	~1.3M проверок/sec	Быстрая валидация

Память: Ring buffer ограничен ~2MB для 5000 строк (настраивается)

LogT разработан для высоконагруженных окружений с минимальным потреблением CPU/RAM.

📦 Установка

Из исходников

# Клонировать репозиторий
git clone https://github.com/turkprogrammer/logt.git
cd logt
# Собрать бинарник
go build -o logt ./cmd/logt
# Или установить в GOPATH
go install ./cmd/logt

🛠️ Использование

Базовое

# Следить за одним файлом
logt ./app.log
# Следить за несколькими файлами по шаблону
logt ./logs/*.log
# Фильтр по уровню
logt --level error ./app.log
# Stdin pipe
cat app.log | logt

Тестовые логи

Windows (PowerShell)

# Простой JSON (с кавычками)
echo '{"level":"info","msg":"Server started"}'|Out-File-FilePath app.log -Encoding utf8
# JSON с доп. полями
echo '{"level":"error","msg":"Connection failed","host":"db1","port":5432}'|Out-File app.log -Encoding utf8
# Несколько строк@'{"level":"info","msg":"Starting"}{"level":"warn","msg":"Low memory"}{"level":"error","msg":"OOM killed"}{"level":"debug","msg":"GC done"}'@|Out-File app.log -Encoding utf8
# Запуск
.\logt.exe app.log
# PipeGet-Content app.log | .\logt.exe

Windows (CMD)

# Простой JSON
echo {"level":"info","msg":"Server started"} > app.log
# JSON с доп. полями - используем printf для кавычек
printf "{\"level\":\"error\",\"msg\":\"Connection failed\",\"host\":\"db1\",\"port\":5432}\n"> app.log
# Несколько строк (CMD)
(
echo {"level":"info","msg":"Starting"}
echo {"level":"warn","msg":"Low memory"}
echo {"level":"error","msg":"OOM killed"}
echo {"level":"debug","msg":"GC done"}
) > app.log
# Запуск
logt.exe app.log
# Pipe
type app.log | logt.exe

Linux / macOS

# Простой JSONecho'{"level":"info","msg":"Server started"}'> app.log
# JSON с доп. полямиecho'{"level":"error","msg":"Connection failed","host":"db1","port":5432}'> app.log
# Logfmtecho'level=info msg="Server started"'> app.log
echo'level=error msg="Connection failed" host=db1 port=5432'> app.log
# Plain text с уровнемecho'2024-01-15 10:30:00 INFO Server started'> app.log
echo'2024-01-15 10:30:01 ERROR Connection failed'> app.log
# Несколько строк
cat > app.log << 'EOF'{"level":"info","msg":"Starting application"}{"level":"info","msg":"Loading config from /etc/app.conf"}{"level":"warn","msg":"Config key 'debug' not found, using default"}{"level":"debug","msg":"Initializing database connection pool"}{"level":"info","msg":"Connected to postgres://localhost:5432/db"}{"level":"error","msg":"Query failed: relation 'users' does not exist"}{"level":"info","msg":"Running migrations..."}{"level":"info","msg":"Migration v001_create_users completed"}{"level":"info","msg":"Server listening on :8080"}{"level":"error","msg":"Unhandled panic: index out of range"}{"level":"warn","msg":"Retry attempt 1/3 for external API"}{"level":"error","msg":"External API still unavailable after 3 retries"}EOF# Запуск
./logt app.log
# Pipe
cat app.log | ./logt
# С другими командами
kubectl logs deployment/myapp | ./logt
journalctl -f | ./logt
docker logs -f mycontainer | ./logt

Мульти-формат (mixed sources)

# Создаём разные файлыecho'{"level":"info","msg":"API log"}'> api.log
echo'level=warn msg="Auth warning"'> auth.log
echo'2024-01-15 ERROR Database connection lost'> db.log
# Следим за всеми сразу
logt api.log auth.log db.log
# или
logt ./*.log

Примеры

# Следить за всеми логами сервисов
logt /var/log/services/*.log
# Найти только ошибки
logt --level error ./app.log
# Фильтрация по времени (последний час)
logt --since 1h ./app.log
# Фильтрация по времени (с 30 минут назад до 10 минут назад)
logt --since 30m --until 10m ./app.log
# Фильтрация по абсолютному времени
logt --since "2024-01-15 10:00" ./app.log
# Комбинация фильтров
logt --since 1h --level error ./app.log
# JSON Path фильтрация (только ошибки)
logt --json '.level == "error"' ./app.log
# JSON Path фильтрация (startswith)
logt --json '.message | startswith("Error")' ./app.log
# JSON Path фильтрация (contains)
logt --json '.error | contains("timeout")' ./app.log
# JSON Path + время
logt --json '.level == "error"' --since 1h ./app.log
# JSON Path + вложенные поля
logt --json '.user.role == "admin"' ./app.log
# С настроенным буфером
logt --buffer 10000 --max-buffer 20000 ./app.log
# Экспорт отфильтрованных логов в файл
logt --forward filtered.log ./app.log
# Экспорт в stdout (pipe)
logt --forward - ./app.log | grep ERROR
# С источниками из конфига
logt
# Stdin от другой команды
kubectl logs deployment/app | logt
# Headless режим + статистика
logt --headless --stats ./app.log
# Headless режим + последние N строк
logt --headless --tail 100 ./app.log
# Headless + stats + time filter
logt --headless --stats --tail 50 --since 1h ./app.log
# Shell completions
logt completion bash > /etc/bash_completion.d/logt
logt completion zsh > /usr/local/share/zsh/site-functions/_logt
logt completion fish >~/.config/fish/completions/logt.fish

⌨️ Горячие клавиши

Клавиша	Действие
Space	Пауза/Продолжить автопрокрутку
/	Открыть фильтр по подстроке
r	Переключить Fuzzy/Regex фильтр
Enter	Применить фильтр / Открыть JSON
Backspace	Удалить символ из фильтра
Esc	Очистить фильтр / Закрыть JSON просмотр
↑ / ↓	Прокрутка вверх/вниз
PgUp / PgDn	Прокрутка по страницам
Home / End	Перейти в начало/конец
g	Перейти в начало (less-style)
G	Перейти в конец (less-style)
n	Следующее совпадение
N	Предыдущее совпадение
Tab	Переключить панель источников
m	Bookmark текущую строку
M	Показать bookmarks
e	Export bookmarks в YAML
q	Выход

🏗️ Архитектура

logt/
├── cmd/logt/main.go # Точка входа, CLI
├── internal/
│ ├── config/config.go # Загрузка конфигурации (yaml, env, pflag)
│ ├── domain/
│ │ ├── domain.go # Модели, Парсеры, RingBuffer, фильтры
│ │ ├── bookmarks.go # Менеджер закладок
│ │ ├── stats.go # Статистика и агрегация
│ │ ├── rate.go # Калькулятор скорости
│ │ └── jsonpath/ # JSON Path фильтрация
│ ├── provider/
│ │ ├── provider.go # FileProvider, StdinProvider, MultiProvider
│ │ ├── watcher_unix.go # inotify/FSEvents (Linux/macOS)
│ │ └── watcher_windows.go# Polling (Windows)
│ └── ui/
│ ├── model.go # Состояние Bubble Tea
│ ├── update.go # Обработчики сообщений
│ └── view.go # Рендеринг через Lip Gloss
├── config.example.yaml # Пример конфигурации
└── README.md

Проектные решения

1. Гексагональная архитектура — Домен-ориентированный дизайн с чёткими границами
2. Channel-based Concurrency — Безопасные обновления UI через Go каналы
3. Throttling — UI обновляется максимум 20 раз/сек для предотвращения CPU spike
4. Без внешней tail библиотеки — Собственная реализация через polling

🧪 Тестирование

# Запустить все тесты
go test ./...
# С бенчмарками
go test -bench=. ./...
# Конкретный тест
go test -v -run TestRingBuffer ./...

Покрытие тестами

• RingBuffer overflow (100k → 5k limit)
• Конкурентный доступ (thread-safety)
• JSON/Logfmt/Plain парсеры с fallback
• Фильтр по тексту и regex
• Определение уровня (case-insensitive)
• Конфигурация (yaml, env, flags)

📊 Сравнение

Возможность	LogT	lnav
Размер бинарника	~6MB	~15MB
Время старта	<100ms	~200ms
JSON поддержка	Нативная	Ограниченная
Фильтр по тексту	✓	✓
Regex Filter	✓	✓
YAML конфиг	✓	✗
Требует конфиг	✗	✓

🔧 Конфигурация

LogT работает без конфига из коробки. Для кастомизации создайте файл:

# ~/.config/logt/config.yaml или ./logt.yamlbuffer-size: 5000# Размер буфераbuffer-max: 10000# Максимальный размерtheme: dark # Тема (dark)forward: filtered.log # Файл для экспортаsources: # Источники по умолчанию
- /var/log/*.log

Переменные окружения

LOGT_BUFFER_SIZE=10000
LOGT_LEVEL=error
LOGT_FORWARD=filtered.log
LOGT_THEME=dark

Флаги командной строки

-p, --path string Пути к файлам или шаблоны
-l, --level string Фильтр по уровню (debug,info,warn,error)
-b, --buffer int Размер буфера (по умолчанию: 5000)
-m, --max-buffer int Максимальный размер буфера
-f, --forward string Экспорт логов (файл или stdout)
-t, --theme string Тема (dark)
-S, --since string Фильтр с времени (1h, 30m, 2024-01-15)
-U, --until string Фильтр по время (1h, 30m, 2024-01-15)
-j, --json string JSON Path фильтр (.level == "error")
-H, --headless Режим без TUI (CLI)
-n, --tail int Последние N строк (0 = все)
-s, --stats Вывод статистики
-e, --export string Экспорт bookmarks в файл
-v, --version Версия
-h, --help Помощь

📝 Поддерживаемые форматы логов

Авто-определение

• JSON — {"level": "error", "message": "..."}
• Logfmt — level=error msg="..."
• Plain — 2024-01-01 10:00:00 ERROR message

Определение уровня

Без учёта регистра:

• FATAL, ERROR, WARN, INFO, DEBUG, TRACE

🐛 Известные ограничения

• File watching: inotify (Linux), FSEvents (macOS), polling (Windows)
• Нет удалённой поддержки логов (в планах: HTTP forwarding)

🤝 Вклад

1. Fork
2. Создайте feature branch
3. Запустите тесты: go test ./...
4. Отправьте PR

📄 Лицензия

MIT License - см. LICENSE