Строка лога полезна ровно настолько, насколько по ней можно восстановить контекст.
Обязательный минимум:
— время с часовым поясом или в общем поясе для всех машин;
— уровень записи;
— источник: сервис, модуль, а лучше и версия;
— идентификатор запроса или операции, общий для всех записей одной цепочки;
— само событие, сформулированное как факт, а не как «ошибка».
Идентификатор цепочки — самый недооценённый пункт. Без него разбор запроса, прошедшего через несколько сервисов, превращается в сопоставление по времени, а время на разных машинах слегка расходится всегда.
Отдельно про формулировки. Запись «не удалось сохранить» бесполезна: непонятно что, для кого и почему. Полезная запись отвечает на три вопроса — что пытались сделать, с каким объектом, чем закончилось.
Хорошая проверка: дайте свой лог человеку, который не писал этот код, и попросите объяснить, что произошло. Если он не справился, лог придётся читать вам, причём ночью.
—
Чтобы быть в курсе рынка — подпишись на @lidy_i_lave
Логи и Ротация
@logs_rotation_n1k_n1k
Строка лога полезна ровно настолько, насколько по ней можно восстановить контекст.
Этот пост опубликован в Telegram-канале Логи и Ротация. Подписаться можно по ссылке: @logs_rotation_n1k_n1k.