Skip to content

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

Merged
xiaoland merged 1 commit into
mainfrom
feat/observability-unification
Nov 5, 2026
Merged

xiaoland merged 1 commit into
mainfrom
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和指定Dogfood回执拥有,真实PG/Loki与跨Peer验收已完成,见#52。

风险与回滚

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

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

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

后续 App / Peer 命名迁移

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

2026-11-05 合并交付已完成。Hub 四层按 #51 → #53 → #56 → #57 合入 main,最终 17fc19e 与已通过 Dogfood 的 5c5c254 整树一致,最终文档站正式发布成功。对应运行 42005096027。

@xiaoland
xiaoland force-pushed the feat/observability-unification branch from 33f5a13 to 74cc59e Compare November 5, 2026 09:41
@xiaoland
xiaoland marked this pull request as ready for review November 5, 2026 09:41
@xiaoland
xiaoland merged commit 30ff408 into main Nov 5, 2026
1 of 3 checks passed
@github-project-automation github-project-automation Bot moved this from Review / acceptance to Done in InKCre Current Work Nov 5, 2026

This branch was successfully deployed

1 active deployment
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant