v2.1API
Командная строка
Команды parse, stats и tail с флагами, форматами вывода и кодами возврата.
Команда sverlo — тонкая обёртка над библиотекой для работы с логами из терминала.
sverlo <команда> [файл...] [флаги]Если файл не указан или указан -, читается стандартный ввод.
Команды#
| Команда | Что делает |
|---|---|
parse | Разбирает записи и печатает их |
stats | Печатает сводку: число строк, долю ошибок, диапазон времени, счёт по уровням |
tail | Как parse, но следит за файлом и печатает новые записи (с версии 2.1) |
Флаги#
| Флаг | Описание |
|---|---|
--format <имя> | Встроенный формат |
--pattern <шаблон> | Свой шаблон |
--query <запрос> | Запрос для фильтрации |
--out json|table|count | Вид вывода; по умолчанию json (по записи на строку) |
--since, --until | Границы времени, 2026-10-01 или с временем |
--limit <n> | Остановиться после n записей |
--timezone <зона> | Зона для строк без смещения |
--strict | Любая нераспознанная строка завершает работу с кодом 3 |
Примеры#
# пять последних ошибок из gzip-архива
zcat access.log.gz | sverlo parse --format nginx-combined --query 'status:5xx' --out table --limit 5
# число предупреждений за час
sverlo parse app.log --pattern '{ts:iso} {level:level} {msg:rest}' \
--since 2026-10-01T09:00:00Z --until 2026-10-01T10:00:00Z --query 'level:warn' --out countКоды возврата#
| Код | Значение |
|---|---|
0 | Успех |
1 | Ошибка использования: неизвестный флаг, нет --format и --pattern |
2 | Файл не найден или недоступен |
3 | Нераспознанные строки при --strict |
Конвейеры
Закрытый получатель вывода, например | head, не считается ошибкой: команда тихо завершается с кодом 0.