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:
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]`).
|
||||
Reference in new issue
Block a user