Skip to content

docs: 记录可观测性正式交付验收 #127

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
xiaoland merged 1 commit into from
Oct 3, 2026
Merged

docs: 记录可观测性正式交付验收 #127

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions tasks/observability-foundation/experiments/evidence/production-delivery.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
{
"release": "0.7.1",
"source": "4364be89e069311b37fb3e7703844501352715aa",
"workflow": "https://github.com/InKCre/core-py/actions/runs/37127883726",
"logging_backend": "postgresql",
"telemetry_enabled": "false",
"readiness_http_status": 200,
"handler_enabled_log_seen": true,
"checked_at_unix": 1791036192,
"pg_startup_query_count": 0,
"pg_startup_query_interpretation": "Startup logs do not enable the existing ENABLE_LOG_BACKEND context; zero rows is expected and is not a PostgreSQL writer test. Actual Job PostgreSQL writes were verified in isolated preview."
}
16 changes: 12 additions & 4 deletions tasks/observability-foundation/packet.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

## 当前交付

首批功能 #124 与 Core 0.7.0 Release #123 已合并，当前等待正式交付与客户端准入：Python 与 client-web 使用标准 OTel/OTLP，本地开关缺省关闭，PG writer 与 Job 查询保留。Hub #33 已合并；两 Spoke 各自独立更新共享引用至 `7916312`，#124/#125 已退出 draft。core 功能合并后先走既有 Release PR 和 stable 准入，再同步客户端类型与合并。
首批功能 #124 与 Core 0.7.0 Release #123 已合并并完成正式交付；客户端 #125 已合并且 Pages 生产交付成功：Python 与 client-web 使用标准 OTel/OTLP，本地开关缺省关闭，PG writer 与 Job 查询保留。Hub #33 已合并；两 Spoke 各自独立更新共享引用至 `7916312`，#124/#125 已退出 draft。客户端已按正式 stable 准入重新生成类型，结果无差异，完整 CI 重跑通过后合并。PG 交付覆盖修复 #125 与 Core 0.7.1 Release #126 已合并，补丁生产交付及 stable 晋升已成功。

| 对象 | 当前状态 |
| --- | --- |
Expand All @@ -27,20 +27,28 @@

## 剩余交付门禁

本批实现交付不等于完整 G2/G3 或持续生产遥测启用准入。正式客户端类型需在 core release artifact 准入后，使用既有 sync 流程重新生成并比较；不修改准入规则来容纳候选数据库。Hub 合并后两个 Spoke 的共享 SHA 已独立更新。
本批实现交付不等于完整 G2/G3 或持续生产遥测启用准入。正式客户端类型已在 Core 0.7.0 release artifact 准入后，通过既有 sync 流程重新生成并比较，结果无差异；完整 CI 重新选取正式 stable 后通过，没有放宽准入规则。Hub 合并后两个 Spoke 的共享 SHA 已独立更新。

云端合成数据读回及 API 样本导出已通过，免费额度、保留边界与长期历史导出仍待验证；真实平台终止宽限与请求后冻结、真实模型 provider、活跃部署覆盖及 webext 独立生命周期仍是部署或后续覆盖门禁。AI 原文/长期快照没有被基础 tracing 自动授权。正常 SDK shutdown 的等待窗口不是端到端硬时限或零丢失承诺。

## 资源与权限

本轮 task-owned `inkcre-o11y-db-g1-b0a97f7c` 的两个容器和隧道已停止；`o11y_impl`、`o11y_migration_roundtrip`、历史 `o11y_lab` 与其余实验卷保留。其它三历史实验项目也保持停止。未操作 SVC 开发数据库；未升级套餐。Hub 已合并，应用交付推进中。真实凭据仅留本地忽略配置，不进入任务证据、提交或浏览器。父任务保持活跃。
本轮 task-owned `inkcre-o11y-db-g1-b0a97f7c` 的两个容器和隧道已停止；`o11y_impl`、`o11y_migration_roundtrip`、历史 `o11y_lab` 与其余实验卷保留。其它三历史实验项目也保持停止。未操作 SVC 开发数据库；未升级套餐。Hub 与两应用的本批交付已完成，生产 PG 覆盖修复已发布。真实凭据仅留本地忽略配置，不进入任务证据、提交或浏览器。父任务保持活跃。

## 当前预览验收

PR #124 独立 Heroku/Neon 预览曾临时开启 PG 日志与 OTLP，私密值仅通过 Heroku API 写入服务端，原配置保存于忽略的恢复文件。真实 Chromium 初次读取共享配置被 1.5 秒上限取消，业务 Job 与 PG 错误日志正常；独立 HTTP 读同一合法配置耗时 2.376 秒。客户端 `b64e5eb` 将配置读取上限设为 10 秒，直发/relay exporter 分别为 10/35 秒，处理器多留 5 秒；调用方 flush/shutdown 等待仍 1.5 秒。修复后真实 Job 三信号/Link 经 Cloud 独立读回通过，Pages 预览显示业务终态与 PG 日志。配置 10 秒超时、上游拒连、再次关闭后的业务/PG 保留已验；`6026b2d` 对齐指标标签及秒分桶，Cloud 严格读回通过。真实付费模型未调用。

预览运行配置与共享配置已恢复，新增私密出口变量已移除，见 `experiments/evidence/preview-restored.json`。预览原有显式 logging backend 为 none；临时 PG 日志只用于本次开关/故障验证，不修改生产配置。
预览运行配置与共享配置已恢复，新增私密出口变量已移除，见 `experiments/evidence/preview-restored.json`。预览原有显式 logging backend 为 none；临时 PG 日志只用于本次开关/故障验证，该历史验收没有修改生产配置；之后独立交付修复见下一节。

## 交付配置修复

核对既有生产脚本和 Heroku API，正式部署显式 `OBSRV__LOGGING_BACKEND=none`，因此没有安装应用内部 PG handler。Sir 指出原要求是保留应用自身写库，并非接入 Heroku console 上传。为满足已授权的默认 PG 行为，独立分支 `codex/observability-pg-delivery` 将生产/预览交付覆盖改为 `postgresql`，console 与 OTLP 独立开关不变；复用 production delivery 的自托管部署同样采用该值。通过独立 PR 和正常 Release 发布，不直接改生产配置绕过源仓。

## 正式交付证据

客户端 #125 以 rebase 合并至 `5bc6b05`，保留共享引用与源码提交边界。[Pages 生产交付](https://github.com/InKCre/client-web/actions/runs/37127428361) 的构建、部署及线上烟雾检查通过。正式类型生成使用 Core 0.7.0 stable `sha256:c26e74dd6925e643e39490db739018e86897f4a07bd17da7dc3f8cffb67dce25`，生成文件无差异；[重新运行的完整 CI](https://github.com/InKCre/client-web/actions/runs/37125628198) 通过。

PG 修复 #125 合并为 `c09e0c0`；0.7.1 Release #126 合并为 `4364be8`，发布 PR 只包含版本号、变更记录和片段消费。预览采用 main 上的可信交付脚本，因此修复 PR 本身的预览仍使用旧配置，不能作为新脚本已生效的证据；最终生效情况以生产 API 与数据库只读核验为准。

[0.7.1 生产交付与 stable 晋升](https://github.com/InKCre/core-py/actions/runs/37127883726) 成功。独立 Heroku API 确认 `logging_backend=postgresql`、`telemetry_enabled=false`，readiness 返回 200；见 `experiments/evidence/production-delivery.json`。现有 `ENABLE_LOG_BACKEND` 仍只在业务上下文开启，启动日志不会因此自动写库，所以启动日志查询零行不能作为 writer 故障证据，也不充当写入验收。真实 Job PG 写入依据此前隔离预览验收；本次没有向生产提交失败 Job。
Loading