Безкоштовний урок

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

Структуровані журнали без секретів — Надійна робота 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, коли налаштоване трасування. У черзі збережи ці ID як службові метадані, не генеруй новий jobId при кожному retry. Водночас ID не є дозволом читати артефакт: доступ до приватного summary.json перевіряється окремо. Для метрик не використовуй jobId як label: у кожного завдання нове значення, і число серій швидко росте. У метриці достатньо stage, status і service; конкретний jobId шукай у журналі чи trace. Цей поділ дає агреговані лічильники без втрати можливості дослідити один запуск. Перевір на двох одночасних навчальних завданнях, щоб їхні події не змішувалися.

Практичне завдання

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

Перейти до навчання

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

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