Spring Cloud 使用 Zipkin 进行分布式链路追踪,主要是通过 Spring Cloud Sleuth 提供的自动集成来实现。下面详细介绍如何在 Spring Cloud 应用中使用 Zipkin 实现链路追踪:
1. 引入依赖
首先,在 Spring Boot 项目的 pom.xml
或者 build.gradle
文件中引入 Sleuth 和 Zipkin 相关的起步依赖。
Maven:
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-sleuth</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-zipkin</artifactId>
</dependency>
Gradle:
implementation 'org.springframework.cloud:spring-cloud-starter-sleuth'
implementation 'org.springframework.cloud:spring-cloud-starter-zipkin'
2. 配置 Zipkin Server 地址
在应用配置文件(如 application.properties
或 application.yml
)中指定 Zipkin Server 的地址:
spring.zipkin.baseUrl=http://your-zipkin-server-host:9411/
3. 配置采样率(可选)
Sleuth 会根据设置的采样率决定是否记录某个请求的追踪信息。可以通过以下方式配置采样率:
# 设置采样率为50%,即一半的请求会被追踪
spring.sleuth.sampler.probability=0.5
4. 工作原理
-
Sleuth:负责生成和传播 Trace 和 Span。每个服务调用都会创建一个 Trace,并且这个 Trace 中包含多个 Span,代表了服务调用过程中的各个阶段。Trace ID 是全局唯一标识整个调用链路的ID,Span ID 则用于标识调用链路中的具体操作步骤。
-
Zipkin:接收、存储并展示 Sleuth 产生的跟踪数据。当微服务间发生 HTTP 调用时,Sleuth 自动将 Trace 和 Span 数据添加到 HTTP 请求头中,从而实现了跨服务的追踪信息传递。
-
Reporter:Sleuth 内部集成了 Zipkin Reporter,用于定时或按需将收集到的 Span 数据发送给 Zipkin Server。
5. 查看链路追踪结果
启动应用后,当服务之间有调用时,Sleuth 将跟踪这些调用并将跟踪信息上报给 Zipkin Server。访问 Zipkin Server 的 UI(默认端口为 9411),可以在其中查看完整的调用链路图,包括每个服务节点的响应时间、处理耗时等详细信息。
6. (进阶)自定义扩展
如果需要更高级的定制化功能,例如调整数据上报的方式或格式,可以考虑自定义 Sleuth 的 Reporter 或者 Brave 的 Tracer 实现。此外,也可以针对 Zipkin 的传输层进行定制,比如选择 Kafka、RabbitMQ 等其他消息队列作为数据传输媒介,而非默认的 HTTP 协议。
总结起来,Spring Cloud Sleuth 结合 Zipkin 提供了一套便捷的解决方案,帮助开发者在分布式系统中快速实施链路追踪,便于分析系统的性能瓶颈和服务间的调用关系。