当前位置：首页 > news >正文

Spring Cloud 服务追踪实战：使用 Zipkin 构建分布式链路追踪

news 来源：原创 2025/6/30 6:32:48

Spring Cloud 服务追踪实战：使用 Zipkin 构建分布式链路追踪

在分布式微服务架构中，一个用户请求往往需要经过多个服务协作完成，如果出现性能瓶颈或异常，排查会非常困难。此时，分布式链路追踪（Distributed Tracing）技术就显得尤为重要。本文将带你一步步搭建基于 Zipkin 的服务追踪系统，帮助你更好地监控和分析微服务调用链路。

什么是 Zipkin

Zipkin 是一款开源的分布式追踪系统，最初由 Twitter 开发，用于收集各个服务之间请求的时序数据，分析请求的延迟、瓶颈和错误。

通过 Zipkin，我们可以直观地看到请求如何在微服务之间传播，帮助开发者快速定位性能瓶颈，优化系统架构。

下载并启动 Zipkin

首先，需要下载并启动 Zipkin Server。可以直接通过以下链接下载可执行 jar 包：

https://search.maven.org/remote_content?g=io.zipkin.java&a=zipkin-server&v=LATEST&c=exec

下载完成后，使用命令行（CMD）执行以下命令启动 Zipkin：

java -jar zipkin-server-<version>-exec.jar

其中，<version> 替换为实际下载的版本号。

默认情况下，Zipkin 会启动在 http://localhost:9411/。启动成功后，你可以在浏览器中访问该地址查看 Zipkin 的可视化界面。

集成 Zipkin 到 Spring Boot 微服务

添加依赖

在你的微服务项目 pom.xml 中添加以下依赖：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-zipkin</artifactId>
</dependency>

如果你使用的是 Spring Cloud Alibaba，还需添加对应的版本管理依赖（spring-cloud-dependencies）。

配置 application.yml

在 src/main/resources/application.yml 中配置 Zipkin：

server:port: 8181
spring:zipkin:base-url: http://localhost:9411sleuth:sampler:# 设置采样率，默认 0.1（10%），这里配置为 1.0 表示 100% 请求都会被追踪probability: 1.0application:name: zipkin

sleuth.sampler.probability 表示请求采样率。如果只想采集部分请求，可以将其设置为 0.1 或其他小于 1 的值。

编写示例接口

例如，在 Controller 中新增一个接口，方便测试链路追踪：

@RestController
@RequestMapping("/trace")
public class TraceController {@GetMapping("/test")public String testTrace() {return "Hello Zipkin!";}
}

启动服务

启动应用后，访问地址：http://localhost:8181/trace/test

然后进入 Zipkin 控制台：http://localhost:9411/ ，点击 Find Traces，即可看到刚刚访问的请求链路信息，点击可以查看详细的调用过程、耗时等信息。

链路追踪界面解读

进入 Zipkin Web UI 后，可以看到以下核心功能：

Service：显示所有注册过的服务
Dependencies：展示服务之间的调用依赖关系
Trace details：展示具体请求的时间线（调用树状结构），包含每个服务的耗时

通过这些信息，可以清晰了解每个请求的流转路径，定位哪个服务处理最慢，或者哪些调用链存在异常。

总结

使用 Zipkin 结合 Spring Cloud Sleuth，可以轻松实现微服务的全链路追踪，极大提升系统可观测性和问题排查效率。特别是在微服务体系下，当面对复杂调用链和高并发请求时，这种能力显得尤为重要。

Spring Cloud 服务追踪实战：使用 Zipkin 构建分布式链路追踪