Observability — read-модель движка о самом себе
Observability (modules/observability) — один из 30 модулей; подобно
live-ingest, он выполняет архитектурную роль,
а не занимает слот возможности. Это read-модель движка о самом себе: три
read-only поверхности под /v1/m/observability/, отвечающие на вопросы, которые
раздел System в админ-консоли отображает, без владения хотя бы одной сущностью
хранилища.
Три поверхности
Заголовок раздела «Три поверхности»| Маршрут | На что отвечает |
|---|---|
GET /ingestion-health | что втекает в движок и вытекает из него по каждому стандарту взаимодействия — стандарты, которые движок закрепляет (OTel GenAI semconv, OCSF, ASIM, унифицированные форматы SIEM, push в реестр, Prometheus text, W3C Trace Context), каждый с подтверждённой версией |
GET /traces, GET /traces/{id} | что W3C-коррелированный audit ledger сообщает о трассировке — аудиторский взгляд на распределённую трассировку, соединённый по Trace Context |
GET /attestation | что доказуемо верно относительно цепочки поставок работающего бинарника — поверхность аттестации, которую питает цепочка проверки релиза |
Все три — это чтения с правами, ограниченными модулем; ничто здесь ничего не изменяет.
Почему это вообще модуль
Заголовок раздела «Почему это вообще модуль»Админ-консоли нужен авторитетный ответ на вопрос «что этот движок на самом деле поддерживает и на какой закреплённой версии?» — и честный способ его отдавать исходит из самого движка, а не из документации, которая может расходиться с реальностью. Таблица ingestion-health генерируется из тех же закреплений, под которые компилируются коннекторы и экспортёры, поэтому при сдвиге закрепления поверхность сдвигается вместе с ним.
Ограниченный контекст, сформулированный прямо
Заголовок раздела «Ограниченный контекст, сформулированный прямо»- Она не владеет сущностями хранилища и ничего не хранит — это чистая read-модель поверх субстратов, которые уже существуют (закрепления, audit ledger, свидетельства аттестации).
- Это не модуль XXII (health/SLA), который ограничен надёжностью агентов и MCP-серверов estate. Этот модуль — про сам движок.
- Это не эндпоинт метрик: операционные временные ряды живут на
/metrics; этот модуль отдаёт структурированные ответы, а не ряды.
Связанное
Заголовок раздела «Связанное»- Мониторинг через Prometheus — операционные метрики и SLO.
- Справочник событий — словарь шины, по которому отчитывается таблица ingestion.
- Проверка релиза — свидетельства цепочки поставок, которые отражает поверхность аттестации.