dodjdnh opened a new pull request, #1158:
URL: https://github.com/apache/dubbo-go-samples/pull/1158

   ### Problem
   
   现有 `integration` 示例未开启 RPC 延迟 Histogram,Grafana 的 P95 
面板目前直接对各实例分位数求平均,无法反映聚合后的真实延迟分布。SDK 新增 Histogram 支持后,Samples 
需要补齐对应的可运行配置、查询语句及自动化验证。
   
   ### Changes
   
   - **示例配置**:在 Consumer 和 Provider 端开启 Histogram,结合示例约 20ms 
的模拟耗时设置桶边界(观测值与桶边界单位均为秒)。
   - **看板查询**:将原平均 P95 查询改为基于桶聚合的 P95/P99,并新增 Consumer/Provider 双端的耗时热力图。
   - **采集与校验**:更新捕获脚本,在指标就绪后校验桶结构、累计计数、总和及标签一致性(确认业务失败的调用同样计入),同时保留对旧快照的兼容校验。
   - **文档补充**:完善中英文 README,并在记录 SDK 来源时明确区分版本依赖与本地 replace,避免误将 Go module cache 
当成 Git 工作区。
   
   ### Review Focus
   
   - **单位与命名**:Histogram 实际按**秒**记录与展示,但指标名沿用了与 Java 端对齐的 `...milliseconds...` 
格式(面板已按秒配置)。
   - **分位数聚合与空窗期**:查询逻辑严格先聚合桶再算分位数;当流量停止或缺少 Histogram 指标时,保留原始状态(无新观测时窗口内可能出现 
`NaN`),不做补零处理。
   
   <details>
   <summary>SDK 依赖与 CI 限制</summary>
   
   本 PR 仅包含示例配置、Dashboard 和验证逻辑,不包含 SDK Collector 实现,强依赖 `apache/dubbo-go#3791` 
提供的 Histogram API。
   
   当前 `go.mod` 临时锁定到包含该特性的开发版本:
   
   ```go
   replace dubbo.apache.org/dubbo-go/v3 => github.com/dodjdnh/dubbo-go/v3 
v3.0.0-20261112014637-221c96e2271e
   ```
   
   - **CI 已知限制**:现有两个 CI workflow 会根据目标分支重写 SDK replacement(合入 `main` 时不会沿用此处的 
fork 版本)。本地已实测替换回上游 `main`(`6b04ac0`)会因缺少 `WithHistogramEnabled` 和 
`WithHistogramBuckets` 导致双端编译失败。
   
   - **后续动作**:待上游 SDK 合入目标分支后,需同步更新此处的依赖版本并重跑 CI(本 PR 不修改 workflow 文件绕过检查)。
   
   </details>
   
   <details>
   <summary>Verification &amp; Test Commands</summary>
   
   当前分支 HEAD 为 `479b993`(包含示例变更 `e5f0401` 与验证补充 `479b993`)。
   
   - **PASS**:HEAD 下的 17 个 Python 单元测试、相关 Go 包的定向测试及 `go vet`。
   
   - **PASS**:Linux/amd64 双端只读构建(`go build -mod=readonly`),已补齐 Linux 构建所需的 
`procfs` 校验值。
   
   - **PASS**:独立 K8s 环境下的端到端真实 RPC 到 Grafana 后端查询链路。
   
   - **NOT VERIFIED**:浏览器前端实际渲染效果、原版 Docker Compose 全流程,以及完整 GitHub 
Actions(受限于上述 SDK 依赖)。
   
   <details>
   <summary>测试命令与数据捕获方式</summary>
   
   #### 本地单测与构建命令
   
   ```bash
   # Python 验证逻辑测试(覆盖桶完整性、累计计数、+Inf=count、成功/失败计数、标签一致、非有限值/单位报错及 SDK 来源解析)
   # 注:旧快照不含 Histogram,仅用于原有指标的回归测试
   python3 -m unittest discover -s observability/integration -p 'test_*.py'
   
   # Go 定向测试与静态检查
   go test -mod=readonly -p 2 ./observability/integration/go-client/cmd 
./observability/integration/go-server/cmd 
./observability/integration/internal/verify
   go vet -mod=readonly -p 2 ./observability/integration/go-client/cmd 
./observability/integration/go-server/cmd 
./observability/integration/internal/verify
   
   # Linux/amd64 交叉编译验证
   GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -mod=readonly -p 2 -trimpath 
-o /tmp/histogram-server ./observability/integration/go-server/cmd
   GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -mod=readonly -p 2 -trimpath 
-o /tmp/histogram-client ./observability/integration/go-client/cmd
   ```
   
   #### 真实数据捕获与校验方式
   
   仓库提供的标准本地捕获命令如下:
   
   ```bash
   python3 observability/integration/capture.py /tmp/dubbo-histogram-capture
   python3 observability/integration/validate.py /tmp/dubbo-histogram-capture
   ```
   
   本轮未直接跑本地 Docker Compose,而是在独立 K8s 环境中拉起相同的示例程序,抓取原始指标文件后直接调用仓库的 `validate()` 
函数完成校验。
   
   </details>
   
   <details>
   <summary>K8s 端到端运行记录(2026-11-12)</summary>
   
   **环境版本与范围说明**:
   
   - **组件版本**:Nacos 2.5.2 / OpenTelemetry Collector 0.112.0 / Prometheus 3.5.0 
/ Grafana 12.1.0(不等同于原 Compose 锁定的版本组合)。
   
   - **部署拓扑**:Consumer 与 Provider 运行在同一 Pod 的不同容器中,通过 Nacos 服务发现发起真实 Triple 
RPC(未覆盖跨 Pod 网络及多副本聚合场景)。
   
   - **代码版本**:集群镜像基于整理前的 `cc7b924` 构建(当时临时补了一条 `procfs` 校验值,该记录现已正式合入 
`e5f0401`)。后续整理仅涉及提交历史,业务与测试代码无改动,当前 HEAD 已通过 Linux 只读构建与单测,未再重新部署集群。
   
   
   | **检查项** | **验证结果** |
   | --- | --- |
   | **有限调用样本** | 双端均记录 5 次请求(4 次成功、1 次业务失败) |
   | **Histogram 指标** | 双端 `count=5`(已计入失败调用);7 个有限桶与 `+Inf` 边界、标签及总和校验全部通过 |
   | **Trace 与日志关联** | 5 对 RPC Span 完整,父子关系与上下文日志关联正常,无字段不匹配 |
   | **Prometheus** | Consumer 与 Provider 两个抓取目标状态均为 `UP` |
   | **Grafana 配置** | 数据源健康检查 `OK`,运行中的 Dashboard 定义与本 PR 提交一致 |
   | **P95/P99 与热力图** | 4 条分位数查询与 2 张热力图均通过 Grafana 后端 API 正常返回带有效数值的数据帧 |
   | **停流与恢复测试** | 有限调用后停流 120s(查询窗口内无新样本,分位数按预期呈现 
`NaN`),随后开启持续调用,确认分位数查询恢复有效数值(未做浏览器视觉验收) |
   
   </details>
   
   </details>
   
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to