Уровни логов: Debug, Info, Warn и Error

В slog уровень — это число, а не строка: Debug равен -4, Info — нулю, Warn — четырём, Error — восьми. Числовая шкала не украшение: обработчик сравнивает уровень записи со своим минимумом и молча пропускает всё ниже, поэтому Debug скрыт при настройке по умолчанию — ноль против -4. Шкала сортируется: записи можно фильтровать «Warn и выше», а между ступенями разрешены промежуточные значения, например Level(-2) для болтливой отладки, которая важнее Debug, но ещё не Info. Обработчик по умолчанию берёт минимум Info, и slog debug info разделяются сами собой: Info печатается, Debug пропадает. Уровень пишется заглавными буквами в каждой строке вывода — INFO, WARN, ERROR — и по нему же хранилища строят фильтры и дашборды. Главная привычка урока: выбирая уровень, вы выбираете, кто и когда обязан увидеть запись.

Debug — место для всего, что помогает воспроизвести путь выполнения: входящие параметры, выбранная ветка кода, содержимое ответа внешнего сервиса. Правило отбора: если при разборе инцидента вы пожалели, что этого нет в логе, — это Debug. Info — события, из которых складывается история сервиса: старт и остановка, принятые заказы, смена конфигурации. Не гоните сюда отладку — Info читают как ленту новостей. Warn — аномалии, которые сервис обработал сам: первая неудача перед ретраем, медленный запрос, приближение к лимиту. У Warn есть скрытый подписчик — человек и система, которые следят за частотой: рост Warn предсказывает Error. Error — операция не выполнила своё обещание: платёж не прошёл, письмо не ушло, запись потеряна. Пара slog debug info из практики: Debug отвечает на вопрос «как мы сюда попали», Error — на вопрос «что сломалось и что теперь».

Вопрос, который приходит сразу: если Debug скрыт, как его увидеть в проде без деплоя? Для обработчика по умолчанию ответ появился в Go 1.22: функция slog.SetLogLoggerLevel меняет минимум дефолтного обработчика на ходу — один вызов из обработчика сигнала или админ-эндпоинта, и Debug начинает печататься. Для собственных обработчиков тот же эффект даёт опция Level в HandlerOptions: минимум читается из переменной окружения или конфига на старте. Схема по окружению, которую чаще всего берут за основу: в разработке минимум Debug, в продакшене Info, а Warn и Error видны везде — подробнее с переменными и безопасными дефолтами разбирается восемнадцатый урок. Проверка уровня перед сборкой полей — часть производительности горячего пути: об этом четырнадцатый урок.

Мнение, которое часто путает новичков: Error — это не «в коде вернулась ошибка», а «операция не выполнила обещание, и кто-то должен это починить». Функция возвращает ошибку десятки раз за запрос — упавшее подключение, пустой кэш, отмена контекста — и почти каждая из них штатно обрабатывается. Логировать каждую на Error — значит обесценить уровень за неделю. Пара критериев, по которым ошибка заслуживает Error: эффект необратим для пользователя (платёж не прошёл) или требуется действие за пределами кода (потерялась запись, кончился лимит). Всё, что обработано ретраем, фолбэком или кэшем, — Warn максимум, а чаще Debug. Проверка на ревью простая: если бы Error попал в алерт, был бы он полезен или это просто шум? Тем же вопросом стоит проверять существующий сервис: где Error без последствий — там и место будущего игнора алертов. Ошибки как значения и их оборачивание — за кадром этого курса, они разобраны в курсе по продвинутому Go.

Распространённая ловушка — использовать уровни как систему типов событий: «заказы логирую на Info, оплаты на Warn, сбои на Error». Уровень говорит о важности для читателя, а не о виде события, поэтому одно и то же событие может пойти на разных уровнях: пользователь отменил заказ — Info, а отмена сорвалась из-за ошибки шлюза — Error. Тип события кодируется сообщением и полями, а не уровнем: заказ оформлен, payment.status=failed — и хранилище спокойно строит диаграммы по полям, не различая уровни. Попытка завести отдельный логгер под каждый вид событий ломает фильтрацию: дежурный ищет «всё, что случилось с заказом 42», а получает четыре ленты. Пара slog debug info показывает правильный разрез: один и тот же разбор запроса на Debug и одно и то же событие на Info — это два уровня значимости, а не два типа событий. Если видов событий становится много, придумывают словарь полей с именами событий — об этом стоит вспомнить, когда дойдёте до полей для сбора.