Skip to content

docs(observability): 统一采集查询与 Web 观测体验契约 - #53

Draft
xiaoland wants to merge 1 commit into
feat/core-app-separationfrom
feat/observability-unification
Draft

xiaoland wants to merge 1 commit into
feat/core-app-separationfrom
feat/observability-unification

Conversation

@xiaoland

@xiaoland xiaoland commented Nov 4, 2026 •

Copy link
Copy Markdown
Member

过去的可观测性合同把外部后端限定为额外OTLP出口,并要求PG writer与查询始终保留,不能满足“选择外部后,从外部统一采集和读取”的产品目标。本PR明确两个共同演进的工作域:可观测性基建,以及Web观测视图套件。

变化

  • 默认内置数据库;选择外部后读写同源,失败不静默回退、不搬迁历史、不补造旧Job记录。
  • Core拥有统一记录/查询和标准遥测机制,App装配凭据与生命周期,Web不包含供应商分支。OTLP经过Core导出,是协议出口而非独立查询存储。
  • 独立非秘密后端selector兼容旧OTLP配置;规范结构化事件、操作摘要、时间/严重度筛选、有界窗口、状态与历史语义,保留标准Trace/指标的可选出口。
  • 公共Peer能力校验expected_backend,防止新配置请求被未重启Peer写错存储。首个双向外部实现为Loki。
  • Web全局工作区与Job详情复用查询;空、错误、截断、旧历史与缺失用量明确区分。

发布项目:无软件包版本。跨仓跟踪:#52,Python/TS实现由跟踪项关联。下一响应方:维护者;请审阅语义、资源/内容边界、兼容与首批能力范围。

验证和限制

6份文档、13个本地链接、代码围栏和git diff --check通过。可视化说明在本地同步。具体运行证据由实现PR拥有,本文不声称真实外部后端持久化或端到端验收已通过。

风险与回滚

改变的是旧“PG独立writer持续保留”保证,部署启用新selector需先升级参与的采集/查询消费者,并配置能执行外部能力的Peer。后端切换不迁移历史;误配置必须可见。回滚需与实现协调恢复旧后端策略,保留数据,不只撤掉文档。

本PR不迁移数据库、不发布包、不部署生产或变更凭据。父PR先合并,再重排本PR到main;共享源先推送后,消费者以独立提交引用。

直接父PR:#51(Core/App边界)。已知同仓子PR:无。

后续 App / Peer 命名迁移

直接子 PR:https://github.com/InKCre/docs/pull/56(draft)。先交付本 PR,再重排命名迁移;跨仓跟踪 #55。

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Review / acceptance

Development

Successfully merging this pull request may close these issues.

1 participant