Files
logpile/bible-local/docs/reanimator-contract-request-installed-at.md
T
Mikhail ChusavitinandClaude Opus 5.5 2ce60280c3 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>
2026-09-28 13:01:46 +03:00

122 lines
7.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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]`).