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 Sleuth 官方文檔：https://spring.io/projects/spring-cloud-sleuth
• Zipkin 官方文檔：https://zipkin.io/

如果這篇文章對你有幫助，歡迎收藏、點贊或關注，后續會持續分享更多 Spring Cloud 實踐與微服務架構相關內容。