Files
alex d517820088
PLBA package CI / Python tests (push) Failing after 2s
PLBA package CI / Package version increment (push) Skipped
PLBA2-2. Архивация спек
2026-10-10 20:55:13 +03:00

4.3 KiB
Raw Permalink Blame History

Spec Delta

Purpose

Агрегировать текущий health приложения из runtime, workers и health contributors.

ADDED Requirements

Requirement: Агрегация health-состояния

ID: HL.AG-01

Health aggregator SHALL формировать единый отчёт по lifecycle приложения и текущему состоянию компонентов.

Scenario: Получение health-отчёта

Участники
  • Приложение, runtime, workers и health contributors.
Предусловия
  • Каждый worker и contributor предоставляет состояние по health-контракту.
Основной поток
  1. Собираем состояния runtime и компонентов — aggregator формирует отчёт по HL.AG-01.FR-01.
  2. Рассчитываем общий статус и завершаем с HEALTH_REPORT_CREATED по HL.AG-01.FR-02.
Альтернативы и ошибки
  • Входной статус не соответствует контракту — возвращаем HEALTH_INPUT_INVALID по HL.AG-01.FR-02.
Результат

Приложение получает единый статус и детализацию состояния каждого запущенного worker.

Коды завершения
Код Смысл Связанные FR
HEALTH_REPORT_CREATED Отчёт сформирован из валидных состояний HL.AG-01.FR-02
HEALTH_INPUT_INVALID Состояние не соответствует health-контракту HL.AG-01.FR-02

Функциональные требования

HL.AG-01.FR-01: Состав и приоритет статусов

Worker сообщает status, critical, detail и meta через health-контракт. Отчёт содержит application_id, lifecycle приложения и состояния каждого запущенного worker/contributor. Worker с disabled: true исключён из набора ожидаемых компонентов и не ухудшает health. Статусы упорядочены как ok < degraded < unhealthy; применяется худший итоговый статус. Для критичного компонента учитывается переданный status. Для некритичного компонента unhealthy ограничивается до degraded; отсутствие некритичного worker также даёт не ниже degraded. Отсутствующий критичный worker даёт unhealthy. Lifecycle new и failed даёт unhealthy, starting и stopping — не ниже degraded. Когда lifecycle приложения stopped, общий health status — stopped независимо от прежних статусов компонентов.

HL.AG-01.FR-02: Результат агрегации

Health-статус является данными. Валидные агрегированные ok, degraded, unhealthy и stopped возвращаются в отчёте; stopped обозначает lifecycle приложения, а статусы запущенных worker/contributor остаются ok, degraded или unhealthy. Ошибка появляется только при нарушении контракта входного состояния.

Код Текст сообщения Дальнейшее поведение
HEALTH_REPORT_CREATED Сообщение отсутствует Отчёт возвращается вызывающему коду для представления клиенту
HEALTH_INPUT_INVALID Сообщение отсутствует; ошибка контракта передаётся вызывающему коду Отчёт не формируется; приложение исправляет contributor