Skip to content

docs(design): 架构图按三层重排;§5 工作量抽出为独立进度追踪文档 - #8

Merged
TangJia025 merged 2 commits into
mainfrom
docs/2061-diagram-layers
Sep 16, 2026
Merged

TangJia025 merged 2 commits into
mainfrom
docs/2061-diagram-layers

Conversation

@TangJia025

@TangJia025 TangJia025 commented Sep 15, 2026

Copy link
Copy Markdown
Contributor

承接 #7(已合并)的后续改动。本 PR 含两处文档结构改动,都在 docs/,不动任何代码或契约。

改动 1 · §3.1.1 架构图按三层重排

§3.1.1「形态先例:昇腾 CI 资源块现有架构」的图重排为严格三层,自上而下:

内容
上层 · 范围 + 采集 业务集群 ×12 / 4 Region 里的两类采集者:Prometheus Agent(拉)、拨测 CronJob(推)
中层 · 存储 中心集群的 Pushgateway + Prometheus
下层 · 视图 / 告警 左:视图(Grafana);右:告警(Alertmanager → 邮件)——两者并列、同为 Prometheus 下游、互不依赖
  • Alertmanager 从「中心集群」分组中移出,与邮件节点合并进独立的【告警】分组;
  • 图后新增一张「三层读法」说明表;
  • 清掉两处标签行尾残留的空 <br/>(删减标签文字后遗留)。

改动 2 · §5 工作量预估抽出为独立文档

原 §5 四张表(A / B / C + 汇总)抽出为 docs/进度追踪.md,作为后续进度追踪的唯一入口;设计文档 §5 改题「工作量与进度」,正文只留指向新文档的链接,避免同一份数据两处漂移

抽出时一并做的整理:

  • 状态图例(✅ 已完成 | 🔄 进行中 | 📋 待办)与人天口径说明——A 列为剩余预估(已完成项记 0),B / C 尚未启动,所列即全量预估;
  • 每一行都补齐 状态 + 预估人天两列,B / C 两表原来只有人天列;
  • 试点项状态按实际更新(日志试点已开 robot-universal-review#90 并在 preview 验证契约;OBS_* 注入已提 helm-chart-value#1428);
  • 新文档标注 ⚠️ 「17 集群」口径待重算:以 opensourceways/infrastructureservice.yaml 独立重算 25 个接入仓的 prod 集群并集得 20 个,与设计文档的 17 存在差异。重算前,Agent 铺开 / LTS 日志组 / 日志告警三条链路里的 17 均按偏低估看待。

本次不动设计文档正文里的 17 这个数,等口径对齐后一次性改,避免同一数字在多处各改一半。

验证

纯文档改动,无代码、无契约、无 CI 影响。

🤖 Generated with Claude Code

AI 使用声明

当前 PR 是否有 AI 参与:

    1. AI Agent 平台:Claude Code
    2. AI 模型:deepseek-v4-flash
    3. Prompt 上下文:用户在审阅上一版(docs(design): 微服务可观测性建设技术设计(#1938 / 子任务 #2061) #7)后指出架构图未分层,要求按「范围+采集 / 中心存储 / 视图与告警平齐」三层重排;随后要求把 §5 工作量预估整章抽出为独立的进度追踪文档,并把「17 集群」口径按 infrastructure/service.yaml 重算核对

- 上层【范围 + 采集】业务集群(Agent + 拨测 CronJob),原样保留;
- 中层【存储】中心集群(Pushgateway + Prometheus),Alertmanager 移出;
- 下层【视图】与【告警】并列平齐——二者同为 Prometheus 的下游,互不依赖;
  邮件节点一并移入告警分组。
- 图后补一张「三层读法」说明表。

注:同时清掉作者删减标签文字后残留的两处行尾空 <br/>,未改动任何正文。

Co-Authored-By: Claude Code <noreply@anthropic.com>
@opensourceways-bot

Copy link
Copy Markdown

Welcome To opensourceways Community

Hey @TangJia025 , thanks for your contribution to the community.

Bot Usage Manual

I'm the Bot here serving you. You can find the instructions on how to interact with me at Here . That means you can comment below every pull request or issue to trigger Bot Commands.

Contact Guide

If you have any questions, please contact the SIG: infratructure ,
and any of the maintainers: @GeorgeCao-hw, @TangJia025, @pkking, @zhongjun2 ,
and any of the committers: @GeorgeCao-hw, @TangJia025, @pkking, @zkhzkhz .

@opensourceways-bot

Copy link
Copy Markdown

CLA Signature Pass

TangJia025, thanks for your pull request. All authors of the commits have signed the CLA. 👍

@opensourceways-bot

Copy link
Copy Markdown

Linking Issue Notice

@TangJia025 , the pull request must be linked to at least one issue.
If an issue has already been linked, but the needs-issue label remains, you can remove the label by commenting /check-issue .

- 新增 docs/进度追踪.md:承接原 §5 的 A/B/C 四张表,补齐状态图例
  与人天口径(A 列为剩余预估,B/C 为全量预估),每行都带 状态 + 预估人天;
- 设计文档 §5 改题「工作量与进度」,正文替换为指向新文档的链接,
  避免同一份数据两处漂移;
- 新文档标注「17 集群」口径待重算:以 infrastructure/service.yaml 独立
  重算 25 个接入仓的 prod 集群并集得 20 个,与设计文档的 17 存在差异。

Co-Authored-By: Claude Code <noreply@anthropic.com>
@TangJia025 TangJia025 changed the title docs(design): §3.1.1 架构图按三层重排 docs(design): 架构图按三层重排;§5 工作量抽出为独立进度追踪文档 Sep 16, 2026
@opensourceways-bot

Copy link
Copy Markdown

CLA Signature Pass

TangJia025, thanks for your pull request. All authors of the commits have signed the CLA. 👍

@TangJia025
TangJia025 merged commit 8c90ee5 into main Sep 16, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants