Конфигурация по окружению

Пустая переменная — не ошибка, а легитимное значение «не настроено», и дефолт для неё выбирается сознательно. Info — правильный ответ и для дева, и для прода: Debug-поток в деве удобен ровно до момента, когда лента перестаёт влезать в экран, а прод-объём считается не гигабайтами, а терабайтами. Дефолт должен стоять до парсинга: if level == "" { level = "info" } — две строки, после которых пустое чтение уже не сможет превратиться в сюрприз. os.Getenv возвращает пустую строку и для неустановленной переменной, и для пустой, поэтому один дефолт накрывает оба случая. Дальше строка идёт в zerolog.ParseLevel — словарь между именем уровня и числом, и на выходе получается zerolog.Level, который отдаётся zerolog.SetGlobalLevel. Подтверждающая Info-запись с принятым уровнем пишется сразу после настройки: три секунды работы, а утренние споры о том, какой порог реально вступил в силу, закрываются первой строкой ленты. И запомните порядок: чтение, дефолт, парсинг, применение, подтверждение — любое другое место для дефолта рано или поздно даст окружение, в котором конфиг есть, а порог другой.

zerolog.ParseLevel(s string) (Level, error) — словарь между строкой конфига и числовым уровнем. Он знает все имена: trace, debug, info, warn, error, fatal, panic, disabled — и сравнивает их без учёта регистра, так что INFO, Info и info дают один и тот же уровень. Помимо имён функция принимает числа: строка 2 превращается в WarnLevel — удобно для конфигов, где уровни хранятся числами, и опасно для тех, где кто-то написал 0, имея в виду «выключить»: ноль — это DebugLevel. Ошибка возвращается только когда строка не совпала ни с одним именем и не распарсилась как число в границах int8; сообщение вида Unknown Level String несёт саму строку конфига внутри, так что опечатка видна без отладчика. Сюрприз, о котором стоит знать заранее: пустая строка ошибкой не считается — ParseLevel("") возвращает NoLevel без ошибки, потому что у NoLevel пустое строковое представление, и сравнение срабатывает. Для конфигов в yaml и json есть второй вход: тип zerolog.Level реализует encoding.TextUnmarshaler, поэтому парсер, умеющий разворачивать текстовые поля, вызовет UnmarshalText сам — уровень заполнится строкой из файла без ручного вызова, а невалидное значение вернётся ошибкой парсинга. Писать собственную таблицу if-ов над именами уровней не нужно никогда: словарь уже есть, он протестирован и совпадает с тем, что zerolog пишет в поле level.

Уровень и формат — не две независимые настройки, а одна: окружение выбирает пару целиком. Дев-терминал читает цветные строки — ConsoleWriter с Out в stdout и человекочитаемым TimeFormat из урока про консольный вывод; прод читает машиночитаемый JSON из stderr, куда смотрит сборщик. Если разнести их по разным флагам, рано или поздно появится комбинация «ConsoleWriter в проде»: цветовые коды в ленте, которую парсит Loki, и ни один тест этого не поймает, потому что оба режима по отдельности легальны. Соберите ветку в одну функцию: newLogger(env) возвращает готовый логгер, и внутри неё же ставится глобальный порог — Debug для разработки, Info для прода. По той же схеме живут семплеры: в проде прореживание, в деве полный поток, и это строка в той же ветке, а не отдельная настройка в другом модуле. Timestamp добавляется в контекст в обоих случаях: JSON-ленте нужен числовой time, консольному выводу — время, отформатированное под человека.

Viper и соседи по конфиг-цеху работают так: прочитали файл, влили переменные окружения, отдали значение. Для zerolog важен только последний шаг — viper.GetString вернул строку, и дальше начинается территория zerolog: ParseLevel, SetGlobalLevel. Библиотека не знает про Viper и не должна: конфиг-менеджеры меняются, словарь уровней один. Если конфиг-парсер умеет encoding.TextUnmarshaler, путь короче: поле конфига типа zerolog.Level заполнится само — парсер вызовет UnmarshalText, внутри которого тот же ParseLevel, и невалидная строка всплывёт ошибкой парсинга файла там, где её чинить. Дефолты и тут решают: если ключ в файле отсутствует, GetString вернёт пустую строку — а пустая строка, как разобрано выше, это NoLevel, а не Info. Подставляйте дефолт до парсинга, а не после: ParseLevel над пустым чтением без дефолта — та самая тишина из «живого места», только через файл конфигурации вместо переменной. И держите в одном месте всю иерархию: окружение сильнее файла, файл сильнее дефолта — тогда спор «откуда взялся уровень» решается чтением одной функции, а не археологией по репозиторию.

Конфигурация собрана — дальше курс идёт в стыки. Следующий урок — мост с slog: стандартный структурный логгер появился в Go 1.21, часть библиотек принимает именно его хендлер, а записи должны уезжать в ту же JSON-ленту, что и zerolog. За ним — секреты: token, password и Authorization в полях, что скрывать всегда и как не потерять их в конфиге. Если конфигурация уже живёт в проде, сверьте её с чек-листом выше: порог, writer и ротация — три решения, которые принимаются один раз и правятся редко, и каждое из них обязано читаться из репозитория, а не из памяти администратора.