Skip to content

feat: 建立默认关闭的分布式与 AI 可观测性基建 - #124

Merged
xiaoland merged 5 commits into
mainfrom
codex/observability-foundation
Oct 3, 2026
Merged

xiaoland merged 5 commits into
mainfrom
codex/observability-foundation

Conversation

@xiaoland

@xiaoland xiaoland commented Oct 3, 2026 •

Copy link
Copy Markdown
Member

新增遥测缺省关闭,保留既有 stdout/PostgreSQL 日志与 Job 查询。Peer 显式开启后,以标准 OTel/OTLP 导出 HTTP/Peer、Job/Cron、AI/Agent 和来源关联元数据;Job 同事务保存提交 carrier,执行建立独立 Trace+Span Link。未知 AI usage 不伪装成零,不上传 prompt、答案或任意异常原文。

范围包括三信号生命周期、有界 SDK 队列与原生丢弃观测、标准 timeout 配置、nullable carrier migration 3d9593b0c855、部署身份初始化、Peer JWT 保护的 protobuf relay,以及部署文档。私密 SaaS headers 仅留服务端。

验证:

  • pdm run check:14 passed、63 skipped、0 类型诊断;迁移完整性与 OpenAPI 通过。跳过项不算已验。
  • disposable PostgreSQL 与真实 SDK:Job 成功/失败/取消、PG 日志、mixed 开关、metrics-only、迁移往返与 512-byte 约束、慢接收/拒连/积压及故障注入。
  • 实际 OpenAI SDK+合成 provider:流式 usage 尾块、unknown/zero、缓存/推理、累计去重、并发工具与内容 canary;未调用付费模型。
  • 实际 Chromium 业务模块→隔离预览 PostgREST→Heroku Core 执行→Grafana 三信号,Viewer API 独立核对提交/执行 Trace 与精确 Link、三条 Job 事件及两端时延指标。Pages 预览独立显示成功状态和错误 Job 的 PG 日志;不冒充由 Pages UI 提交 Job。
  • 真实预览暴露并修复客户端配置读取预算及跨语言指标标签/秒分桶不一致。最终 Cloud 严格核对统一标签、全部 bucket、count/sum。
  • 配置 10 秒超时、OTLP 上游拒连、再次关闭:业务结果与 PG 日志保留。预览原配置和共享配置已恢复,私密出口变量移除。任务包保留失败与成功证据。

依赖:共享契约 InKCre/docs#33 已合并,两 Spoke 已独立同步 7916312。客户端 InKCre/client-web#125 必须在 Core 正常 Release PR 发布并通过 stable 准入后,从正式产物重新 sync 数据库类型再合并。

交付与回退:本功能 PR 合并只发布 candidate;版本 Release PR 才触发生产部署、迁移与 stable 晋升。默认不开启生产遥测。停止采集可关闭开关并重启,不删除 PG 日志或 carrier。exact-head 要求协调 schema/Peer 升级,不能把回退镜像视作数据库回退。SDK shutdown 和平台退出均不保证零丢失。

Grafana API 当前标记账号为 free-trial;稳定 Free 限额/保留、生产平台冻结与终止宽限、真实外部 provider、webext 独立生命周期及全活跃部署覆盖仍是明确残余,本批不代表完整 G3。未升级套餐。

@xiaoland
xiaoland marked this pull request as ready for review October 3, 2026 12:56
@xiaoland
xiaoland merged commit afd42fd into main Oct 3, 2026
6 of 7 checks passed

This branch was successfully deployed

1 active deployment
preview — 1a556d60 Deployed Oct 3, 2026 by xiaoland via Retire preview resources #365
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant