LOGORIC / KNOWLEDGE

Инструкции и шаблоны

Настройка каждого раздела, проверка результата и готовые сценарии для вашего проекта.

Наблюдаемость · Руководство на русском

Логи: хранение, поиск и живой поток

Модуль «Логи» сохраняет записи из всех источников организации и даёт полнотекстовый поиск, фильтры по полям, гистограмму, live tail, экспорт и алерты по запросу. Пароли, токены и ключи маскируются до сохранения.

Порядок настройки

  1. Подключите модуль: «Тариф и модули» → «Модули» → «Логи». Модуль входит в тарифы Pro, Team и Enterprise с разным сроком хранения и объёмом или подключается отдельно; аддон расширяет лимиты тарифа.
  2. Отправьте логи любым источником: OTLP (HTTP /v1/logs или gRPC :4317), HTTP JSON (/api/v1/ingest) или агент. Атрибуты OTLP, resource-атрибуты (service.name, host.name), trace_id и span_id сохраняются автоматически; поля JSON и logfmt из текста сообщения разбираются в атрибуты.
  3. Откройте «Логи». Ищите словами и фразами в кавычках; условия объединяются через И. Фильтры: service:api,worker, level>=warn, status>=500, duration>1000, trace:abc, template:DB_TIMEOUT. Любое другое поле — атрибут: user_id:42, http.route:/v1/* (звёздочка — префикс). Минус исключает условие: -level:info.
  4. Кликните на столбец гистограммы, чтобы сузить период, или на значение в фасетах слева, чтобы добавить фильтр. В раскрытой записи все атрибуты кликабельны; «Контекст ±25» показывает соседние записи того же сервиса, «Вся трасса» — все записи trace_id.
  5. Включите Live — новые записи появляются каждые 2 секунды с учётом текущего запроса. Сохраните частые запросы кнопкой «Сохранить запрос». Экспортируйте выборку в NDJSON или CSV (до 100 000 записей).
  6. Создайте алерт: «Алерт по запросу» откроет правило типа log_query — инцидент откроется, когда число записей за окно превысит порог. Алерт использует каналы оповещений и дежурства.
  7. Настройте хранение (owner/admin): срок в пределах тарифа, маскирование email и IP, исключаемые уровни и фильтр исключения (например "GET /health"). Исключённые записи не хранятся и не расходуют квоту.
timeout service:checkout level>=warn -"GET /health"

Ожидаемый результат

Логи всех сервисов доступны в одном поиске, а важные шаблоны превращаются в инциденты.

Если не получается

  • Записей нет — проверьте, что модуль подключён и источник отправляет события (раздел «Источники»). Записи до подключения модуля не сохраняются.
  • Внизу страницы видны объём за месяц и число отброшенных записей. Если квота исчерпана, новые записи не сохраняются до следующего месяца или расширения модуля.
  • Метки времени принимаются в пределах ±2 минут от времени сервера: проверьте синхронизацию часов (NTP).