Производительность: ноль аллокаций

Под капотом каждого события — sync.Pool. Внутренний eventPool раздаёт структуры Event с байтовым буфером: поля дописываются в буфер сразу как JSON-байты — Str пишет строку с кавычками и экранированием, Int — число, — и никакой промежуточной карты или дерева полей не существует. Контекст логгера, собранный через With, хранится как готовые байты и приписывается к событию копированием, поэтому копия логгера с десятью предзаданными полями почти ничего не добавляет к цене записи. После Msg буфер уходит writer-у одним вызовом Write, а Event возвращается в пул для следующего события. Возврат не безусловный: буфер, разросшийся свыше шестидесяти четырёх килобайт, в пул не возвращается — гигантский дамп одним событием портит переиспользование, и zerolog просто выбрасывает его GC-у. Контраст со старым поколением логгеров разительный: logrus на каждое событие строит карту, считает рефлексией и форматирует текст — README-бенчмарки zerolog показывают на десять полей разницу в разы и на десятки аллокаций. Отсюда же и ограничения: типизированные методы Str и Int не случайны — Any с произвольным интерфейсом идёт через json.Marshal и стоит дороже, поэтому на горячем пути поля должны быть типизированными, а карта полей map[string]interface{} — исключением. Time и Dur тоже пишут числа сами, без общего маршалера: типизация — не стиль, а прямой путь мимо json.Marshal.

Порог Disabled — не «очень высокий уровень», а самый верхний из восьми: метод should сначала проверяет nil-writer и сравнивает уровень события с порогом — локальным и глобальным, — и на Disabled не проходит ни один вызов. Инфо-цепочка на отключённом логгере возвращает nil-событие, и вся остальная цепочка становится no-op: Str на nil возвращает nil, Msg на nil просто выходит. Отсюда 4 наносекунды из бенчмарка — цена нескольких сравнений. Включается режим копией: quiet := logger.Level(zerolog.Disabled), — и value-семантика делает это безопасным: базовый логгер продолжает писать как раньше. Это отличие от SetGlobalLevel(zerolog.Disabled), глушащего все логгеры разом: копия отключает один путь, глобальный порог — весь сервис. Полезное следствие — код горячего пути не нуждается в if вокруг каждой записи: debug-трассы можно оставлять в коде, а глушить уровнем, переключая копию при старте или по сигналу. Для тестов есть zerolog.Nop() — отключённый логгер одним вызовом. И следствие обратное: nil-событие экономит запись и сериализацию, но не ваш код вокруг цепочки — об этом «живое место» ниже.

Guard из «живого места» — это Event.Enabled(): метод возвращает false у nil-события, и форма if e := logger.Debug(); e.Enabled() стала идиомой zerolog. Дорогая работа прячется внутрь условия целиком — и поля, и вычисления. Для флагов есть.Bool(key, b): один типизированный вызов вместо условных конструкций «если флаг — писать поле, иначе не писать», и событие всегда имеет одинаковую схему, что ценят дашборды; приёмы условных полей разобраны в уроке про условные поля. Время тоже стоит денег: RFC3339-строка форматируется каждый вызов, а zerolog.TimeFieldFormat = zerolog.TimeFormatUnix пишет целое число секунд — дешевле, и системе сбора так же удобно. По той же логике целые миллисекунды для Dur включаются флагом DurationFieldInteger, а точность дробных полей подрезает zerolog.FloatingPointPrecision — оба меняют формат, не трогая код записи. И контраст с ConsoleWriter: там на каждую запись идёт json.Unmarshal для колонок — на горячем пути он съедает весь выигрыш, поэтому его место строго в dev, как разобрано в уроке про красивый вывод.

Бенчмарк из урока — шаблон, который стоит скопировать. Три правила честного замера. Первое: sink — io.Discard, иначе вы меряете диск и терминал, а не логгер; если нужен writer с реальным форматированием времени — оставьте With().Timestamp(), но сравнивайте варианты на одинаковом логгере. Второе: -benchmem обязателен — наносекунды без аллокаций рассказывают половину истории, а GC-давление живёт именно в B/op и allocs/op. Третье: прогоняйте несколько раз и берите стабильные цифры — планировщик, кэши и соседние процессы дают разброс; -benchtime помогает, если ветки слишком короткие. Альтернатива флагу — b.ReportAllocs() внутри самой ветки b.Run: аллокации печатаются всегда, даже если коллега запустил бенчмарк без -benchmem. Сравнивайте только свои со своими: цифры README сняты на другой машине, и «в три раза быстрее» между логгерами на вашем железе может оказаться «на двадцать процентов». Отдельный приём — добавить в b.Run вариант с ConsoleWriter против чистого JSON: спор о читаемости против скорости решается за минуту, когда оба варианта стоят рядом в одном выводе. Тот же приём работает для уровней: Info и Debug рядом в одном бенчмарке дают точную цену debug-ветки на Info-пороге — наносекунды, о которых спорят в ревью.

Скорость — половина дела; вторая половина — объём. Sampling покажет, как прореживать поток, когда отключить нельзя: BurstSampler пропускает всплеск и режет хвост. Дальше — горутины: потокобезопасность логгера и то, почему ноль аллокаций не мешает писать из сотни воркеров одновременно. Приём из этого урока, который стоит забрать в каждый сервис: debug-записи живут в коде, а решает их судьбу порог — поэтому включение подробных логов на деградирующем инстансе не требует релиза, только смены уровня. Справочное закрепление: возьмите свой самый горячий обработчик, добавьте debug-запись с дорогим полем без guard-а и замерьте через b.Run-бенчмарк на Info-пороге — разница между guard-нутой и голой версией станет аргументом для ревью, который не нужно объяснять словами.