--- title: "Запрос на правку контракта: installed_at у компонентов" target: Reanimator Core — Hardware Ingest JSON Contract (текущая версия 2.13) requested_by: LOGPile date: "2026-09-28" status: 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 1. **Время `COMPONENT_INSTALLED`.** Если ingest обнаруживает новую установку компонента в слот и `installed_at` передан, событие датируется `installed_at`, а не временем ingest. Это продолжает правило «Use component event time over ingest time whenever possible». 2. **Замена в слоте.** Если в тот же `machine + slot` ранее был установлен другой компонент, его `REMOVED` датируется тем же `installed_at`: BMC фиксирует замену одной записью (SN A → B). 3. **`first_seen_at`.** `installed_at` становится ещё одним кандидатом в «First Seen Rules» (минимум из кандидатов). 4. **Не влияет на статус.** Как и прочие non-status события, `installed_at` не меняет health. 5. **Валидация.** - `installed_at` позже `collected_at` → поле игнорируется, с предупреждением в `summary`. - `installed_at` раньше `collected_at` предыдущего ingest, в котором компонента в этом слоте не было → противоречие; поле игнорируется, остаётся текущее поведение. 6. **Повторный импорт того же `installed_at`** — no-op. Изменившийся `installed_at` для уже открытой установки — коррекция времени по аналогии с `COMPONENT_FIRST_SEEN_CORRECTED`, без повторного `COMPONENT_INSTALLED`. ### Правила для интеграторов - Не синтезировать: не передавать `installed_at` из `collected_at`, времени первого появления в логах, времени первого Assert и т.п. Только явная запись источника об установке или замене именно этого `serial_number`. - Если записей несколько (переустановка), передавать самую позднюю установку этого серийника в этот слот. - Удалённые компоненты в снимке отсутствуют, поэтому их время передаётся через `installed_at` нового компонента в том же слоте (п. 2). Отдельное время снятия без замены этим полем не покрывается. Если оно понадобится, это отдельная секция `component_events[]`, в эту правку не входит. ### Пример ```json "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]`).