dodjdnh opened a new issue, #3788: URL: https://github.com/apache/dubbo-go/issues/3788
## Problem dubbo-go 已有 RPC 耗时和实例本地分位数,但 RPC collector 尚未导出延迟 Histogram。 现有数据不能用于查询可跨实例聚合的延迟分布;平均各实例的 P99,也不等于应用整体 P99。 需要由 SDK 提供延迟桶数据,供 Prometheus、Grafana 和 Dubbo Admin 查询。 [可视化:体系结构与时序流程的现状/预期对照](https://dodjdnh.github.io/genai-docs/docs/dubbo-go-rpc-histogram/) ## Expected Behavior - 支持显式启用 Provider / Consumer RPC 延迟 Histogram,默认关闭,不改变现有指标。 - 成功和失败的完成调用均记录耗时,沿用现有 RT 标签;使用秒并保留亚毫秒精度。 - 支持自定义桶;未配置时使用默认桶,非法边界警告并整组回退。 - 导出累计 `_bucket`、`_sum`、`_count`;抓取和停流不清零。 - 尽量对齐 Java 已有导出契约,供桶边界、单位和统计口径兼容的实例聚合查询。 ## Scope - 包含 SDK 配置、RPC 耗时采集、Prometheus 导出、回归测试和使用说明。 - 保留已有 RT / QPS / 本地分位数的语义与 Registry 兼容性。 - Grafana / Dubbo Admin 面板及部署抓取配置另行处理。 <details> <summary>Details & References:指标契约、验收标准与背景</summary> ### 当前实现 Provider / Consumer 已有请求数、成功失败、处理中请求和耗时指标。 通用指标抽象及 Prometheus 实现已有 Histogram 原语,但 RPC 耗时尚未接入。 代码已声明 `histogram.enabled` 常量,尚未形成 RPC Histogram 的完整配置链路。 仅修改 Dashboard 无法补出 SDK 未提供的延迟桶数据。 ### 指标契约 | 角色 | 指标族名称 | 单位 | | --- | --- | --- | | Provider | `dubbo_provider_rt_milliseconds_histogram_seconds` | 秒 | | Consumer | `dubbo_consumer_rt_milliseconds_histogram_seconds` | 秒 | 名称中的 `milliseconds` 沿用 Java 历史命名;观测值、桶边界和 `_sum` 均为秒。 应直接使用原始调用耗时的秒值,不将已截断的整数毫秒再转换为秒;旧 RT 记录方式不变。 每个指标族导出 `_bucket`、`_sum`、`_count`,包含 `+Inf` 桶。 标签与计时边界沿用现有 RPC RT,不新增角色或请求级标签。 默认有限桶为 `[0.1, 0.3, 0.5, 1, 3, 5, 10]` 秒,对应 Java 默认的 `[100, 300, 500, 1000, 3000, 5000, 10000]` 毫秒边界。 自定义边界须为正数、有限值且严格递增;非法边界警告并整组回退,不保留部分合法桶。 Histogram 独立于滑动窗口聚合开关,关闭时不新增相应序列。 保持既有 Registry 实现兼容;不支持新增能力时警告并仅停用新 Histogram,已有指标继续工作。 内部配置传递和接口方案留给实现阶段确定。 ### 验收标准 - 默认关闭时不导出新增序列,已有指标保持原有行为。 - 通过真实 RPC 验证两侧成功与失败调用均增加对应 `_count`;受控且无事件丢弃时,每次完成调用记录一次。 - 名称、标签和秒单位符合契约,亚毫秒耗时不因整数毫秒截断而归零。 - 桶计数累计,`+Inf` 与 `_count` 一致;`_sum` 与受控耗时之和一致,允许合理浮点误差。 - 默认桶、合法自定义桶、非正数、非有限数、重复和乱序边界均有测试覆盖。 - Histogram 开关不改变既有 RT;滑动窗口聚合关闭时,仍可单独启用 Histogram。 - 停流后累计值不增长、不清零;进程重启后的重置可由标准 `rate()` 查询处理。 - 相同桶边界的多实例可先聚合桶速率,再用 `histogram_quantile()` 查询 P95 / P99。 - 提供可重复的配置、数值、导出契约和兼容性测试,以及启用方式和查询示例。 ### 聚合条件与边界 跨实例或跨语言聚合要求桶边界、单位和调用计时语义兼容;Java 自定义桶可能与默认配置不同。 Provider 与 Consumer 分开查询,不将两端观测合为同一分布;Histogram 分位数仍是基于桶的估算。 事件总线队列满时可能丢事件,本需求不保证过载下的事件完整性;精确计数验收采用无丢弃的受控条件。 RPC 错误细分类、事件总线可靠性改造、Native Histogram 和逐条流式消息延迟统计不在本次范围内。 ### 相关背景 - [#3765:停流后窗口指标刷新](https://github.com/apache/dubbo-go/pull/3765)修复已有窗口指标;本需求新增累计延迟分布,目的不同,不要求依赖该 PR。 - [#1556:历史可观测性讨论](https://github.com/apache/dubbo-go/issues/1556)及[#1557:已关闭且未合并的提案](https://github.com/apache/dubbo-go/pull/1557)不能作为当前 RPC Histogram 已实现的证明。 </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]
