4.3 KiB
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-контракту.
Основной поток
- Собираем состояния runtime и компонентов — aggregator формирует отчёт по HL.AG-01.FR-01.
- Рассчитываем общий статус и завершаем с
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 |