P29 · 2020-07 · Структурированные логи

Статус: принят в publication registry 31 июля 2026 года. Registry применяет revision по стабильным slug, сохраняя дату и автора базового архива.

editorial-2020-07-practice-structured-logs;
editorial-2020-07-mechanism-structured-logs;
editorial-2020-07-field-structured-logs.

Рамка и границы утверждений

Голос — М3, июль 2020 года. Автор связывает backend, HTTP-границы, delivery и диагностику, но не объявляет локальный JSONL-разбор зрелой платформой наблюдаемости. В каждой статье логика идёт по маршруту «симптом → причина → проверка → действие».

Пакет ограничен одним синтетическим HTTP-запросом и его request_id. Внутренний X-Request-Id явно назван конвенцией конкретного проекта, а не стандартом протокола. Он помогает собрать известные записи одного действия, но не создаёт spans, не доказывает причинность, не строит critical path и не измеряет SLO.

Все id, сервисы, маршруты, JSONL-строки, ошибки, заголовки и команды поиска помечены как учебные и синтетические. В примерах нет реальных пользователей, production-инцидентов, учётных данных или приватных endpoint.

Pass 1 — факты и техника

RFC 5424 использован как основание для тезиса, что событие выигрывает от разделённых, машиночитаемых полей. Статья не утверждает, что её JSON буквально является сообщением RFC 5424: это разные форматы.
RFC 8259 использован для требования валидного JSON. Пример сериализует объект через JSON.stringify, а не собирает псевдо-JSON строковой конкатенацией.
Официальная документация Pino использована только как ссылка на API дочернего логгера и redact. Текст требует проверить возможности версии, установленной в конкретном проекте; не приписывает пакету незафиксированную версию или конфигурацию.
OWASP Logging Cheat Sheet сверена для границы чувствительных полей. authorization, cookie, password, token и secret не выводятся в учебном fixture в исходном виде.
Детерминированный fixture проверяет семь обязательных полей, формат синтетического request_id и redaction двух учебных placeholder-значений. Он не выполняет HTTP-запрос, не читает production журнал и не моделирует конкурентную нагрузку.
Словарь event, шаблон route, различие request_id/operation_id, redaction до сериализации и высокая кардинальность request_id описаны без вывода, что они уже измеряются в реальном контуре.
Вердикт: технические утверждения имеют источники, учебный пример проверяем локально и ограничения не скрыты.

Pass 2 — редактура и голос

Первые два абзаца каждой статьи называют наблюдаемый сбой и цену: ложный диагноз по времени, разрыв между сервисами, лишние данные и бесконечный словарь значений.
Три текста отвечают на разные вопросы: практика задаёт контракт события; механизм проводит один request_id через границы; разбор выбирает поля, redaction и правило кардинальности.
Речь не заменяет решение оценками. Каждый существенный тезис связан с проверкой: форма JSON, одноимённый request_id в трёх записях, точный redacted output, шаблон маршрута или нормализованный error code.
Draft gate подтверждает объём основного текста 11 512 / 10 845 / 11 529 знаков. Внутренняя проверка чистой прозы без таблиц, рисунков и кода: 8 421 / 8 092 / 8 514 знаков; это соответствует целевому коридору П29 7–9 тыс. знаков.
В каждом тексте есть доступная таблица с caption и thead, figure, JSON или JavaScript-пример, нумерованный маршрут и четыре официальных/первичных источника.
Вердикт: статьи достаточно развёрнуты, но не выдают поздний опыт observability-платформы за практику автора в 2020 году.

Pass 3 — визуал и выпуск

Для практики создана вертикальная схема контракта события: базовые поля, идентификатор, локальный контекст и redaction до stdout.
Для механизма создан маршрут gateway → дочерний логгер и заголовок → catalog API → учебный JSONL-поиск. В подписи и самом рисунке прямо сказано, что это не trace critical path.
Для разбора создано дерево решения: диагностический вопрос, чувствительное значение, высокая кардинальность, безопасный контекст и финальный синтетический запрос.
Все SVG используют title, desc, встроенный текст и фигуры без скриптов, внешних изображений или растровых заменителей. Каждый отрендерен Sharp на ширине 375 px: вертикальная компоновка сохранилась, текста и рамки не обрезаются, горизонтальный overflow не обнаружен.
У фигур в статьях есть содержательные alt-тексты и подписи. Узкие таблицы помещены в table-scroll; в коде каждой таблицы есть caption, thead и scope="col".
Основной редактор повторно просмотрел финальные PNG на 375 px. После подключения registry strict audit и production build пройдены; browser-review и assistive-technology проверка не выполнялись и не подменяются сборкой.
Вердикт: тройное ревью пройдено; статические выпускные проверки не выданы за реальную проверку внешнего лог-коллектора.

Выполненные проверки

Проверка	Команда	Результат
Node syntax	`node --check scripts/upgrade-2020-07.mjs` из `web/`	успешно
JSON-only CLI и import-safe export	`npm run audit:draft -- scripts/upgrade-2020-07.mjs` из `web/`	успешно: 11 512 / 10 845 / 11 529 body chars
Контрактный fixture	`node scripts/upgrade-2020-07.mjs --run-fixture` из `web/`	успешно: 7 обязательных полей, `req-demo-20200714-01`, `[REDACTED]`
XML	`xmllint --noout public/assets/editorial/2020/structured-log-event-2020.svg public/assets/editorial/2020/structured-log-correlation-2020.svg public/assets/editorial/2020/structured-log-diagnosis-2020.svg` из `web/`	успешно
Мобильный preflight	Sharp render всех трёх SVG на ширине 375 px	просмотрено вручную: без обрезания и горизонтального overflow
Strict audit после подключения registry	PASS: 11 512 / 10 845 / 11 529 знаков; 2 table и 2 code example у каждой revision
`npm run build`	PASS, code 0, 374 статические страницы
Scope/self-review	PASS: в revision нет `date`/`author`, `articles.json` не перезаписан

Ограничения автономной партии

articles.json, редакционный стандарт, очередь и package config не перезаписывались; registry заменяет только редакционные поля.
Browser, CI, Docker, HTTP-сервер и внешний лог-коллектор не запускались.
Учебный JSONL-запрос показывает корреляцию известных событий; он не доказывает доставку журналов, порядок параллельных операций или производительность реального контура.

Выпусковой вердикт: пакет принят к публикации. Публикационный слой не означает, что учебная корреляция была проверена на реальных событиях.

11 KiB Raw Blame History Unescape Escape