Начало работы

LogSense собирает и индексирует журналы приложений на локальной машине. Коллектор читает файлы и stdin, нормализует события и сохраняет их в локальном индексе.

Требования

• текстовые логи или события в формате JSON Lines;
• Windows, Linux или macOS;
• 128 МБ свободной памяти для небольшого локального индекса.

Установка

Поместите исполняемый файл LogSense в системный каталог. Для Linux:

sudo install -m 0755 ./logsense /usr/local/bin/logsense
logsense version

Первый источник логов

Референсный коллектор читает файлы построчно. Каждая строка может быть обычным текстом или JSON-объектом:

{"time":"2026-07-31T09:12:03Z","level":"info","service":"gateway","message":"request completed","latency_ms":42}

Минимальная конфигурация:

server:
  listen: 127.0.0.1:4173

sources:
  - name: gateway
    type: file
    path: ./fixtures/gateway.log
    format: jsonl

index:
  directory: ./.logsense/index
  retention: 7d

Сохраните файл как logsense.yml. Предлагаемый интерфейс запуска:

logsense start --config ./logsense.yml

Проверка события

После индексации событие должно содержать как минимум четыре поля:

Поле	Тип	Назначение
time	RFC 3339	Время события в UTC
level	string	debug, info, warn или error
service	string	Имя приложения или компонента
message	string	Текст события

Дополнительные поля сохраняются без изменений и становятся доступными для фильтрации.

Следующие шаги

• Настройте несколько источников в разделе Конфигурация.
• Подключите поиск и управление источниками через API Reference.
• Проверьте историю выпусков в Changelog.