Reanimator contract v2.13 makes event_logs[].event_time optional
(Reanimator falls back to collection/ingest time) and defines is_active
("still active / not cleared").
- Omit event_time when the event has no source time instead of passing
collected_at off as the event time.
- is_active=true only from an authoritative active-alarm snapshot: Inspur
dev_status.log (IDL event ID / SEL sensor at the same instant) and
component.log fan state (new models.Event.Active). false for Deasserts,
superseded Asserts in a real Assert/Deassert lifecycle and Inspur
Warning/Critical Asserts missing from dev_status.log; unset otherwise.
A missing Deassert is not treated as active: AC loss and BMC resets drop
them (24C319575: PSU1 predictive failure).
- component.log fan events use source BMC instead of host.
- Request installed_at in the Reanimator contract to date component
installs from maintenance.log; follow-up in BACKLOG [installed_at].
ADL-072.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7.7 KiB
title, target, requested_by, date, status
| title | target | requested_by | date | status |
|---|---|---|---|---|
| Запрос на правку контракта: installed_at у компонентов | Reanimator Core — Hardware Ingest JSON Contract (текущая версия 2.13) | LOGPile | 2026-09-28 | proposed |
Запрос на правку контракта: installed_at у компонентов
Проблема
COMPONENT_INSTALLED / REMOVED / COMPONENT_CHANGED Reanimator выводит сам,
сравнивая снимки при ingest, и датирует их временем ingest/collected_at.
Но BMC часто хранят точное историческое время установки или замены
компонента, и сейчас передать его некуда:
status_history[]принимает только статусы здоровья (OK/Warning/Critical/Unknown/Empty). Установка — не смена статуса, аUnknownсоздал бы ложныйCOMPONENT_UNKNOWN.event_logs[]время сохраняет, но по контракту «не попадают в history timeline и не изменяют canonical state». Запись об установке там видна как лог, но на timeline её нет.
В результате при первом импорте дампа, снятого через недели после работ,
установка на timeline датируется днём импорта. Кроме того, на ненадёжную
дату опирается parts.first_seen_at.
Пример из реального источника
Inspur/Kaytus onekeylog, log/maintenance.log и ротированный
maintenance.log.1.gz. Запись пишется только туда, в IDL/SEL её нет:
|2026-08-12T15:35:22+08:00|MEMORY|Assert|Info|0CFFB300|Component Replace DIMM021 SN changed from NULL to H0KN000308444EA65D! - Assert|
|2024-03-22T17:09:44+08:00|CPU|Assert|Info|07FFB000|Component Replace CPU0 changed from NULL to 23300E51079AF0AB! - Assert|
|2024-03-22T16:57:31+08:00|PSU|Assert|Info|08FFB100|Component Replace PSU0 SN changed from NULL to 2O01C154658! - Assert|
Сервер 24C319575, дамп снят 2026-08-13. В нём видна исходная сборка 2024-03-22 (CPU, PSU, 12 DIMM) и добавление 19 DIMM 2026-08-12 в 15:35 +08. Три из этих DIMM BIOS отключает при каждом POST (POR Mapout). Для разбора отказа важно, что модули поставлены в этот день, а не пришли с машиной. Сейчас Reanimator покажет их установку датой импорта.
Такие же данные есть у других источников: Redfish LogEntry с
MessageId вида *.ComponentInstalled/*.Replaced, журнал Lifecycle
Controller у Dell, IML у HPE.
Предложение
Добавить общее необязательное поле компонентных секций (cpus, memory,
storage, pcie_devices, power_supplies) в раздел
«Общие поля статуса компонентов»:
| Поле | Тип | Описание |
|---|---|---|
installed_at |
string RFC3339 | Время, когда источник зафиксировал установку этого экземпляра компонента (по serial_number) в текущий slot. Передаётся, только если источник хранит такую запись |
Семантика на стороне Reanimator
- Время
COMPONENT_INSTALLED. Если ingest обнаруживает новую установку компонента в слот иinstalled_atпередан, событие датируетсяinstalled_at, а не временем ingest. Это продолжает правило «Use component event time over ingest time whenever possible». - Замена в слоте. Если в тот же
machine + slotранее был установлен другой компонент, егоREMOVEDдатируется тем жеinstalled_at: BMC фиксирует замену одной записью (SN A → B). first_seen_at.installed_atстановится ещё одним кандидатом в «First Seen Rules» (минимум из кандидатов).- Не влияет на статус. Как и прочие non-status события,
installed_atне меняет health. - Валидация.
installed_atпозжеcollected_at→ поле игнорируется, с предупреждением вsummary.installed_atраньшеcollected_atпредыдущего ingest, в котором компонента в этом слоте не было → противоречие; поле игнорируется, остаётся текущее поведение.
- Повторный импорт того же
installed_at— no-op. Изменившийсяinstalled_atдля уже открытой установки — коррекция времени по аналогии сCOMPONENT_FIRST_SEEN_CORRECTED, без повторногоCOMPONENT_INSTALLED.
Правила для интеграторов
- Не синтезировать: не передавать
installed_atизcollected_at, времени первого появления в логах, времени первого Assert и т.п. Только явная запись источника об установке или замене именно этогоserial_number. - Если записей несколько (переустановка), передавать самую позднюю установку этого серийника в этот слот.
- Удалённые компоненты в снимке отсутствуют, поэтому их время передаётся
через
installed_atнового компонента в том же слоте (п. 2). Отдельное время снятия без замены этим полем не покрывается. Если оно понадобится, это отдельная секцияcomponent_events[], в эту правку не входит.
Пример
"memory": [
{
"slot": "CPU0_C2D1",
"serial_number": "H0KN000308444EA65D",
"part_number": "M393A8G40BB4-CWE",
"status": "Warning",
"status_changed_at": "2026-08-12T11:23:50Z",
"error_description": "CPU0_C2D1 Memory Device Disabled ... POR Mapout",
"installed_at": "2026-08-12T07:35:22Z"
}
]
Changelog-строка (предлагаемая)
| 2.14 | — | Добавлено общее необязательное поле installed_at (RFC3339) для компонентных секций: время установки экземпляра компонента в слот по данным источника; используется для датирования COMPONENT_INSTALLED/REMOVED при замене и как кандидат first_seen_at |
Что сделает LOGPile после принятия
maintenance.log уже разбирается: события Component Replace с
component_ref = слот (DIMM021 → CPU0_C2D1). После выхода версии
контракта с полем экспортёр будет ставить installed_at компоненту, у
которого слот и новый serial_number совпадают с последней записью
Component Replace (см. BACKLOG [installed_at]).