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>
122 lines
7.7 KiB
Markdown
122 lines
7.7 KiB
Markdown
---
|
||
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]`).
|