Skip to content

v3.8.8

Choose a tag to compare

@Lincoln-cn Lincoln-cn released this 15 Nov 18:24
· 41 commits to master since this release

v3.8.8 — 请求追踪从「能看」到「能查」

这一版把链路追踪补成一条可用的排障链路。

新能力

  • 服务名与 span 类型分层(#1153):gateway / console / web 三个服务名 + spanKind(SERVER / INTERNAL / CLIENT),详情页直接给出「网关自身耗时」与「上游调用耗时」。
  • 控制台操作记录(#1154 / #1160):控制台写操作进追踪,操作名可读,并写入变更审计的 trace_id;「系统 → 操作记录」页回答「谁在什么时候改了什么」,可一键跳到链路。
  • 异常链路独立保留并归档(#1155):异常链路单独 1000 条保留区,4xx/5xx 异步归档到 trace_archive(默认 7 天),重启后仍可查。
  • 追踪指标(#1156):jairouter_trace_* 与 jairouter_web_* 六个指标;告警走 Prometheus + 外部 Alertmanager,产品不内置推送。
  • 异常分析聚合(#1167):仪表盘「错误分析」Tab 按 operation / 上游实例 / 客户端三个维度排行,外加错误时间线与筛选条。

修复

  • 调用历史不再丢记录(#1165):Mono.zip 空流不触发回调、trace_id 非空约束与兜底冲突、批量队列刷完不清空 —— 三个缺陷一并修掉;调用历史写入真实 traceId,慢请求可跳到对应链路。

升级提示

  • 新增迁移 V13__trace_archive.sql(异常链路归档表)与 V14__config_audit_trace_id.sql(审计表加 trace_id 列)。滚动升级时 Flyway 会在各副本启动时执行。
  • 追踪内存保留策略变化:异常链路不再被普通链路挤出,普通链路仍为 10000 条。
  • 静态资源请求不再逐条建链路,只有 4xx/5xx 才留链路(常规请求只累指标)。

完整逐条说明见 docs/zh/reference/changelog.md 与 docs/en/reference/changelog.md。