dodjdnh opened a new issue, #3841:
URL: https://github.com/apache/dubbo-go/issues/3841
## Problem
目前 `dubbo-go` 的 Metrics、Trace 与 AccessLog 仍存在两处关键关联断点,影响从聚合监控到单次请求排障的定位效率:
1. **RPC 延迟直方图无法下钻到单次 Trace**:`#3791` 已合入可选 RPC 延迟直方图,但当前仅调用普通 `Observe`,且
`/metrics` HTTP Exporter 未开启 OpenMetrics 导出;同时默认 Filter 链中 `metrics` 位于
`otelServerTrace` / `otelClientTrace` 之前,无法从 `ctx` 获取有效 `SpanContext`,导致 P99
延迟毛刺无法通过 Exemplar 关联到具体请求的 Trace。
2. **AccessLog 缺少 Trace、耗时、结果与脱敏**:`filter/accesslog` 当前在 `invoker.Invoke`
之前写入异步队列,且 `otelServerTrace` 位于其后、未向构建逻辑传入 `ctx`,导致日志中既没有 `trace_id` /
`span_id`,也无法记录真实耗时与调用结果;同时请求参数直接通过反射字符串输出,存在敏感信息泄露风险。
## Expected Behavior
拆分为两个独立演进切片交付,默认保持向后兼容与 Opt-in 可选:
- **Filter 链顺序对齐**:调整默认装配顺序,使 `otelServerTrace` / `otelClientTrace` 位于
`metrics` 与 `accesslog` 之前,确保下游可观测 Filter 能获取完整 `SpanContext`(保留用户显式自定义顺序优先)。
- **可选 Histogram Exemplar(PR 1)**:
- 在 `metrics` 抽象层扩展可选 Exemplar 能力,兼容既有自定义 Registry;
- 仅在开启 Exemplar 开关且请求 `SpanContext` 有效并已采样(`IsSampled()`)时,在
`BeforeInvoke` 轻量快照 `trace_id` / `span_id` 并于 `AfterInvoke` 调用
`ObserveWithExemplar`(适配 `#3805` 异步回调,过期观测 `ObservationExpired` 不写入,严格校验
OpenMetrics 128 runes 标签长度上限);
- 为 Prometheus HTTP Exporter 提供 `EnableOpenMetrics: true`
支持,未开启时保持原有输出与零额外开销。
- **后置 AccessLog 关联与脱敏(PR 2)**:
- 将 `filter/accesslog` 从 `Invoke` 前置改为后置同步采集,保留 `#3801` 安全关闭与 `drain` 机制;
- 补齐 `trace_id` / `span_id`(有有效 Span 时写入,无 Trace
时正常记录)、调用耗时与基础成功/失败状态,并提供可配置的参数脱敏/长度截断选项。
- **范围边界**:本 Issue 仅打通指标 Exemplar 下钻与 AccessLog
基础关联字段;跨信号统一错误分类枚举(`error_type`)由 `#3835`(复用 `#3837` `rpcerror.Kind`)后续直接接入后置位置。
## Acceptance Criteria
- [ ] 默认启用 Tracing 时,`metrics` 与 `accesslog` Filter 均可稳定读取当前请求的
`SpanContext`,且不破坏自定义 Filter 顺序配置。
- [ ] 开启 Exemplar 后,已采样 RPC 在 `/metrics`(携带 `Accept:
application/openmetrics-text`)可正确输出 `#
{trace_id="...",span_id="..."}`;未采样请求与过期观测不产生无效 Exemplar,无长度越界 panic。
- [ ] AccessLog 在 `Invoke` 完成后记录真实耗时与成功/失败状态,覆盖有 Trace、无 Trace
与错误调用场景,支持参数脱敏开关并通过 `-race` 停机排空测试。
- [ ] 未开启新开关时,原有指标名称/标签、AccessLog 默认行为与基准性能不受影响。
## Related Issues / PRs
- Related to #3562(可观测性 EPIC 主线)
- Related to #3791, #3805, #3801(已合入的 Histogram SDK、同步指标观测与 AccessLog 停机修复)
- Related to #3835, #3837(跨信号统一错误归因契约后续直接复用本 Issue 改造后的 AccessLog 后置位置)
--
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]