Группы: WithGroup и вложенные поля

Разбор slog group начинается с функции Group: она принимает имя и любое число атрибутов и возвращает Attr, который обработчик развернёт в подобъект. Её место — внутри вызова записи, рядом с обычными атрибутами: slog.Info("запрос обработан", slog.Group("user", slog.Int("id", 7), slog.String("role", "admin"))). Второй способ — метод WithGroup на логгере: logger.WithGroup("http") возвращает новый логгер, у которого все последующие атрибуты получат группу http. Разница в охвате: Group действует на один вызов и расставляет поля локально, WithGroup — на весь остаток жизни конкретного логгера, поэтому его место в конструировании, рядом с With, а не в горячем коде обработчика. Способы сочетаются: логгер с WithGroup("http") внутри записи получает ещё и slog.Group("user"), и в выводе поля окажутся на пути http.user.id. Как и With, метод WithGroup не меняет родителя — исходный логгер продолжает писать без префикса, а дочерние логгеры можно наслаивать друг на друга.

Формат определяет, как именно вложенные поля лога доедут до читателя. JSONHandler разворачивает группу в настоящий вложенный объект: поля оказываются на путях вида http.user.id, и парсер коллектора читает их как дерево — это главная причина заводить группы в сервисах, чьи логи собирает Loki или ELK. TextHandler группирует иначе: вложенности нет, вместо неё точечная нотация — путь склеивается в один ключ http.user.id=7, потому что текстовый формат не умеет вложенные объекты. Формы разные, путь один, поэтому схемы полей, о которых пойдёт речь в семнадцатом уроке, переносятся между форматами без переделки. Есть и правила отбрасывания, одинаковые для штатных обработчиков. Группа, в которой не осталось ни одного непустого атрибута, в вывод не попадает вовсе: условия часто порождают пустые ветки, и лог не раздувается секциями-пустышками. Атрибут с пустым ключом внутри группы отбрасывается так же, как и на верхнем уровне. Свой Handler из двенадцатого урока вправе вести себя иначе — это его контракт, но до поры до времени держитесь поведения штатных.

WithGroup влияет на атрибуты, добавленные после него, и только на них. Служебные поля записи — время, уровень, сообщение и, при AddSource, место вызова — остаются на верхнем уровне в любом формате: дежурному нужно, чтобы msg и level находились поиском по одному и тому же пути во всех строках, а не в разных ветках дерева. Метод WithGroup с пустой строкой — операция без действия: он возвращает тот же логгер без группы, чем удобно пользоваться в шаблонном коде, где префикс приходит переменной, которая иногда пуста. Отсюда же практическая граница: вложенность глубже двух уровней превращает путь в строку, которую сложно напечатать в фильтре, а конфликт имён решается и на одном уровне, если подсистемы названы аккуратно. Ещё одна граница — порядок конструирования: группа применяется к атрибутам, добавленным после WithGroup, но не к тем, что логгер унаследовал от родительского With до разветвления; вспомните это, когда поле неожиданно окажется не в той ветке.

Соглашение, которое держится в проектах без усилий: одна группа верхнего уровня на подсистему и не больше одной вложенной. http, db, cache, auth — четыре префикса закрывают большинство сервисов, а внутри них пути второго уровня вроде http.request или db.query уточняют контекст. Такое дерево читается в фильтрах и не спорит с полями соседей: db.id и http.id живут раздельно, хотя ключ называется одинаково. Второе правило — называть группы именами подсистем, а не именами типов: группа user про доменную сущность уместна, а группа string, названная по типу значения, лишняя. Третье — не дублировать имена атрибутов внутри одной группы: поле id в двух разных группах — норма, поле id и рядом второй id в одной — глюк для парсера. Схему полей полезно держать рядом с кодом, потому что дежурный, строящий фильтр, смотрит в неё, а не в исходники; подробнее о схеме для сборщиков — в семнадцатом уроке. А про то, как логгер с префиксами доехал бы до конкретного запроса целиком, — восьмой урок про With и логгер на запрос.