Files
mtusi2026lab4/openspec/changes/upload-consistency/specs/service-logging/spec.md
T
2026-10-21 05:17:35 +03:00

2.2 KiB
Raw Blame History

Spec Delta

ADDED Requirements

Requirement: Журнал уборщика

Уборщик незавершённых загрузок (capability storage-consistency) SHALL писать журнал в формате этой capability: JSON-записи в stdout, в каждой instance_id процесса уборщика. Записи:

  • старт — интервал, grace, размер выборки, адрес S3, bucket и имя базы;
  • каждая убранная загрузка — id вложения, ключ объекта и возраст загрузки;
  • проход, который убрал хотя бы одну загрузку или прервался отказом хранилища, — сколько убрано, сколько пропущено (их держит другой процесс), причина прерывания и длительность;
  • отказ S3 или PostgreSQL — уровень warning, непредвиденная ошибка — error с traceback;
  • остановка процесса.

Проход, которому нечего убирать, SHALL писаться не выше уровня debug. Записи уборщика MUST NOT содержать ключи доступа и секреты S3, ключ подписи, подписи запросов, filename вложений и байты объектов.

Scenario: Проход уборщика

  • WHEN уборщик убирает незавершённую загрузку
  • THEN в журнале есть запись с id вложения, ключом объекта и возрастом и запись прохода с числом убранных, а секретов S3 и filename в журнале нет

Scenario: Отказ S3 во время прохода

  • WHEN S3 остановлен, а уборщику есть что убирать
  • THEN в журнале запись уровня warning о прерванном проходе с причиной, без секретов, а метаданные загрузки на месте