Строка лога полезна ровно настолько, насколько по ней можно восстановить контекст.

Строка лога полезна ровно настолько, насколько по ней можно восстановить контекст.

Обязательный минимум:
— время с часовым поясом или в общем поясе для всех машин;
— уровень записи;
— источник: сервис, модуль, а лучше и версия;
— идентификатор запроса или операции, общий для всех записей одной цепочки;
— само событие, сформулированное как факт, а не как «ошибка».

Идентификатор цепочки — самый недооценённый пункт. Без него разбор запроса, прошедшего через несколько сервисов, превращается в сопоставление по времени, а время на разных машинах слегка расходится всегда.

Отдельно про формулировки. Запись «не удалось сохранить» бесполезна: непонятно что, для кого и почему. Полезная запись отвечает на три вопроса — что пытались сделать, с каким объектом, чем закончилось.

Хорошая проверка: дайте свой лог человеку, который не писал этот код, и попросите объяснить, что произошло. Если он не справился, лог придётся читать вам, причём ночью.

—
Чтобы быть в курсе рынка — подпишись на @lidy_i_lave