Структурированные логи и JSON: зачем перестать печатать просто строку

Проблема «просто строки»

Когда приложение пишет User login failed for john, человек на экране что-то понимает. Для машины это непарсибельный шум: нет уровня, нет кода ошибки, нет корреляции с запросом.

Структурированный лог — это запись в виде JSON (или key=value) с фиксированными полями: timestamp, level, service, message, плюс контекст: user_id, trace_id, http.status, error.code.

Минимальный контракт для сервиса

1. Время в ISO-8601 UTC — иначе сортировка и «окна» по времени ломаются.
2. Уровень — одна из согласованных меток: DEBUG, INFO, WARN, ERROR (без «warn» и «WARN» вперемешку).
3. Идентификатор сервиса — совпадает с именем источника в платформе приёма (например auth-api).
4. trace_id / request_id — один ID на цепочку вызовов между микросервисами.

Что даёт JSON на практике

• Фильтры level=ERROR AND service=payment без regex.
• Агрегации: сколько 5xx за 5 минут по route.
• Алерты по полю http.status >= 500, а не по тексту «Internal Server Error».

Связь с Logoric

Платформа принимает JSON-полезную нагрузку и индексирует поля для поиска, паттернов и алертов. Чем стабильнее схема полей, тем проще строить правила и инциденты без ложных срабатываний.

Перейти к приёму логов и интеграциям: облачный сервис Logoric.