feat(export): contract-conformant event_logs event_time and is_active

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>
This commit is contained in:
Mikhail ChusavitinandClaude Opus 5.5 committed 2026-09-28 13:01:46 +03:00
1 parent 693906ceba
commit 2ce60280c3
10 files changed
+423 -11

No files matched your search

@@ -0,0 +1,121 @@
---
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]`).