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