可观测性 —— 引擎对自身的只读模型

可观测性（modules/observability）是 32 个模块之一 —— 与实时摄取一样，它承担的是架构性角色，而非填补某个能力槽位。它是引擎对自身的只读模型：/v1/m/observability/ 下的三个只读表面，回答管理控制台 System（系统）区域所渲染的问题，且不拥有任何一个存储实体。

三个表面

路由	回答的问题
`GET /ingestion-health`	按互操作标准列出流入和流出引擎的内容 —— 引擎所固定的标准（OTel GenAI semconv、OCSF、ASIM、统一的 SIEM 格式、账本推送、Prometheus 文本格式、W3C Trace Context），每项都附带其已校验的版本
`GET /traces`、`GET /traces/{id}`	经 W3C 关联的审计账本对某条追踪的记述 —— 一条分布式追踪在审计侧的视图，通过 Trace Context 关联
`GET /attestation`	关于运行中二进制文件供应链可被证明为真的内容 —— 发布校验链所馈送的证明（attestation）表面

这三者都是带有模块作用域权限的读取操作；这里不会对任何东西进行变更。

它为何会是一个模块

管理控制台需要一个权威的答案来回答“这个引擎究竟支持什么，以及处于哪个固定的版本？”—— 而诚实的提供方式是来自引擎本身，而非可能漂移的文档。 ingestion-health 表是从连接器（connector）和导出器编译所依据的同一组固定版本生成的，因此当某个固定版本变动时，该表面也随之变动。

明确陈述的界限上下文

它不拥有任何存储实体，也不持久化任何数据 —— 一个建立在已有底层之上的纯只读模型（固定版本、账本、证明证据）。
它不是模块 XXII（健康/SLA），后者的边界限定于治理范围（estate）中各 agent 与 MCP 服务器的可靠性。本模块关注的是引擎。
它不是指标端点：运营时序数据存在于 /metrics；本模块提供的是结构化答案，而非时序。

复现读取模型的旅程

在一个全新的、可丢弃的 Enterprise SQLite Compose 安装上，使用 Python 3.11 或更高版本运行 scripts/qualify-observability.py。提供已安装的二进制文件、HTTPS 地址、容器名称、完整的源提交和一个新的证据目录：

python3 scripts/qualify-observability.py /path/to/olivares \
  https://127.0.0.1:8443 olivares <source-sha> /path/to/new-evidence

该探针使用 Enterprise 组织管理为其隔离检查预配第二个租户。ingestion-health、追踪读取模型和证明（attestation）表面在 Community 中仍然可用。

探针通过 API 创建夹具账户和 agent，启用现有的可观测性和安全模块，并实际重启容器。它把所启动可执行文件的 SHA-256 与所提供的二进制文件比较，用一个第一方发现项验证摄取，检查租户拒绝，并检查账本追踪详情/导出的保留在重启以及模块关闭/开启之后依然成立。它还验证摄取计数器会重置，并且证明（attestation）把已度量的二进制身份与声明的流水线及未发布的发布状态区分开。CLI 检查使用 JSON 输出。凭据只留在内存或子进程环境中；保留的引擎日志会对安装令牌做脱敏。

按 README 中的安装步骤，并显式选择候选镜像。绝不要对现有安装运行该探针。Python 优化被拒绝，因为它会禁用断言。运行后请删除可丢弃的 Compose 栈及其卷。探针把该清理留给调用方，并把其结果和引擎日志写入证据目录。它不演练控制台操作、PostgreSQL、供应商收集器或发布签名验证。