SpringCloud Alibaba 核心组件解析:服务链路追踪

技术栈:Spring Boot 3.2.0 + Spring Cloud Alibaba 2023.0.0.0-RC1 + Micrometer Tracing + Zipkin


5.1 是什么 — Alibaba 侧的链路追踪

Spring Cloud Alibaba 没有自己独立的链路追踪组件,而是直接复用 Spring Cloud 官方的 Micrometer Tracing + Zipkin 方案。

Sentinel 的 Dashboard 提供流量监控,但不提供链路追踪(看不到 TraceId 维度的跨服务调用链)。


5.2 为什么 — 与官方方案的关系

Spring Cloud 官方Spring Cloud Alibaba
追踪框架Micrometer TracingMicrometer Tracing(相同)
传输协议Zipkin BraveZipkin Brave(相同)
注册中心ConsulNacos
流量控制Resilience4JSentinel

📌 链路追踪是注册中心无关的:无论 Nacos 还是 Consul,TraceId 都通过 HTTP Header 传播,互不影响。


5.3 怎么做 — 快速配置

5.3.1 依赖(6 个,由父 POM 统一管理)

<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-tracing</artifactId>
</dependency>
<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-tracing-bridge-brave</artifactId>
</dependency>
<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-observation</artifactId>
</dependency>
<dependency>
    <groupId>io.github.openfeign</groupId>
    <artifactId>feign-micrometer</artifactId>
</dependency>
<dependency>
    <groupId>io.zipkin.reporter2</groupId>
    <artifactId>zipkin-reporter-brave</artifactId>
</dependency>

5.3.2 配置

management:
  zipkin:
    tracing:
      endpoint: http://localhost:9411/api/v2/spans  # Zipkin Server
  tracing:
    sampling:
      probability: 1.0   # 开发=1.0,生产=0.1

5.3.3 启动 Zipkin

docker run -d -p 9411:9411 openzipkin/zipkin
# 访问 http://localhost:9411

5.4 Nacos + Sentinel + Micrometer 三角关系

Nacos(注册发现)
  ├→ 服务启动时注册 IP:Port
  └→ Consumer 通过服务名发现 Provider 地址

Sentinel(流量控制)
  ├→ 根据 QPS/异常 限流和熔断
  └→ 不关心 TraceId,只管流量

Micrometer(链路追踪)
  ├→ 每次请求生成 TraceId → Span
  ├→ 通过 HTTP Header(traceparent)传播
  └→ 异步上报到 Zipkin Server

三者各司其职,互不干扰。Feign 调用时:从 Nacos 获取地址 → Sentinel 判断是否限流 → Micrometer 记录 Span → 发送 HTTP 请求。


5.5 Sleuth → Micrometer 迁移要点

Old (Sleuth)New (Micrometer)
Spring Boot 版本2.x3.x
配置前缀spring.sleuth.*management.tracing.*
日志 MDC自动注入需手动配置
Feign 集成spring-cloud-sleuthfeign-micrometer

5.6 面试题

Q:Sleuth 和 Micrometer Tracing 的核心区别?

答:Sleuth 用于 Spring Boot 2.x,已停止维护;Micrometer Tracing 是官方继任者,基于 Observation API 统一了 metrics/tracing/logging 三方面。配置前缀从 spring.sleuth.* 变为 management.tracing.*。


5.7 踩坑指南

坑说明
🔴 生产全量采样probability: 1.0 会产生海量 Span 数据,Zipkin 内存爆炸
🔴 Feign 不传播 TraceId缺少 feign-micrometer 依赖
🔴 找不到 Zipkin Server确认 Docker 容器运行中,9411 端口未被占用

5.8 章节总结

  • Alibaba 体系无独立链路追踪组件,直接使用 Micrometer Tracing + Zipkin
  • 完整依赖列表和配置见 Spring Cloud 官方第 5 章
  • Sentinel Dashboard 是流量监控,不是链路追踪,两者互补
Logo

北京人形旗下天工造物具身智能开源社区,聚焦具身天工与慧思开物两大平台

更多推荐