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

7.7 KiB
Raw Blame History

title, target, requested_by, date, status
title target requested_by date status
Запрос на правку контракта: installed_at у компонентов Reanimator Core — Hardware Ingest JSON Contract (текущая версия 2.13) LOGPile 2026-09-28 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[], в эту правку не входит.

Пример

"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]).