v2.1Начало работы
Установка
Как поставить Сверло через npm, проверить установку и подключить CLI.
Версии Node.js
Сверло 2.x работает на Node.js 20 и новее. Ветка 1.x поддерживает Node.js 14 и выше, но получает только исправления безопасности.
Библиотека#
npm install sverloПакет написан на чистом JavaScript с файлами типов, нативных модулей нет, компилятор не нужен. После установки проверьте, что версия совпадает с ожидаемой:
node -e "import('sverlo').then(m => console.log(m.version))"Для ESM используйте import { createParser } from 'sverlo'. Для CommonJS в версии 2 нужен динамический import(); синхронного require у пакета нет, причина описана в миграции.
Командная строка#
Команда sverlo ставится вместе с пакетом. Глобальная установка нужна, только если вы запускаете её вне проекта:
npm install --global sverlo
sverlo --versionОдноразовый запуск без установки:
npx sverlo parse access.log --format nginx-combined --limit 5Все флаги описаны в разделе CLI.
Проверка#
Создайте файл sample.log и разберите его:
2026-10-01T09:14:07Z ERROR db: connection reset by peer attempt=3
2026-10-01T09:14:08Z INFO db: reconnected attempt=4sverlo parse sample.log --pattern "{ts:iso} {level:level} {msg:rest}" --out jsonЕсли вы увидели два JSON-объекта, установка в порядке. Дальше — быстрый старт.