Бесплатный урок

Структурированные журналы без секретов

Структурированные журналы без секретов — Надёжная работа AI-процессов. Стабильная схема события; Разрешённый список полей; Корреляция без личных данных. Практическое задание: Структурированные журналы без секретов.

Демо-версия. Материалы проходят редакторскую проверку.

Что рассмотрим

  • Стабильная схема события
  • Разрешённый список полей
  • Корреляция без личных данных

Стабильная схема события

JSON полезен как журнал, когда поля и типы стабильны. Если один worker пишет duration, другой elapsedSeconds, третий «долго», агрегация ненадёжна. Определи schemaVersion, timestamp UTC, level, event, jobId, attempt, durationMs и errorCode. Успешный шаг — event=artifact.persisted, не произвольная фраза. Ниже собственная учебная схема, не OTLP. durationMs=240 выдумано для примера. Проверяй записи до сохранения: durationMs — неотрицательное число, timestamp — корректное время, jobId присутствует у событий задания. Не меняй смысл поля без миграции потребителя. Одна duration с разными единицами вызовет ложную тревогу о тысячекратном замедлении. Суффикс Ms делает ошибку единиц заметнее. Полную полезную нагрузку модели в такую запись не добавляй.

{"schemaVersion":1,"timestamp":"2026-11-18T10:00:00Z","level":"info","event":"artifact.persisted","jobId":"job-7","attempt":1,"durationMs":240,"errorCode":null}

Разрешённый список полей

Проще избежать утечки, не копируя объект ошибки целиком. Выбери нужные поля, неизвестные отбрось. Учебная ошибка содержит code=TIMEOUT, request.headers.Authorization=TRAINING_SECRET и body с текстом встречи. Записываем code и operationName, не заголовок или body. Маскирование регулярным выражением полезно дополнительно, но может пропустить новый токен или вложенный массив. Allowlist ограничивает объём заранее. Проверь canary во вложенных полях, URL-параметрах и exception. Не используй настоящий секрет. Установи права чтения, срок хранения и поведение при заполнении диска: бесконечные debug-журналы способны остановить workflow. Удаление старых записей следует политике, а не случайной очистке при инциденте. Пример должен сохранять полезный код ошибки после удаления лишних данных.

Корреляция без личных данных

Чтобы найти события job-7, достаточно стабильного ID; имя человека или текст встречи не нужны. Передай jobId каждому этапу и добавь traceId при настроенной трассировке. В очереди сохраняй их как служебные метаданные, не создавай новый jobId на retry. При этом ID не даёт права читать артефакт: доступ к частному summary.json проверяется отдельно. В метриках не используй jobId как label: новое значение у каждой задачи быстро множит серии. Достаточно stage, status и service, а конкретный jobId ищется в журнале или trace. Такое разделение даёт агрегированные счётчики и возможность расследовать один запуск. Проверь на двух одновременных учебных заданиях, чтобы события не смешивались и не требовали личных данных для различения.

Практическое задание

Структурированные журналы без секретов

Перейти к обучению

Программа курса

  1. Что означает «процесс работает»
  2. Структурированные журналы без секретов
  3. Трассировка и задержка без ложной арифметики
  4. Повторы, идемпотентность и границы расходов
  5. Сигналы, ведущие к конкретному действию
  6. Checkpoint, резервная копия и доказательство восстановления