当前位置:首页 > 文章列表 > 文章 > java教程 > SpringCloudSleuth追踪教程全解析

SpringCloudSleuth追踪教程全解析

2025-07-10 13:45:20 0浏览 收藏

一分耕耘,一分收获!既然都打开这篇《Spring Cloud Sleuth分布式追踪教程详解》,就坚持看下去,学下去吧!本文主要会给大家讲到等等知识点,如果大家对本文有好的建议或者看到有不足之处,非常欢迎大家积极提出!在后续文章我会继续更新文章相关的内容,希望对大家都有所帮助!

要实现Spring Cloud Sleuth的链路追踪,需按以下步骤操作:1. 引入依赖开启基础追踪能力;2. 查看日志中的traceId和spanId用于识别请求链路;3. 实现跨服务链路追踪确保上下文自动透传;4. 可选配合Zipkin进行可视化展示。通过这些步骤可提升微服务架构下的问题排查与性能优化能力。

Spring Cloud Sleuth实现分布式链路追踪详细教程

在微服务架构下,一个请求往往会经过多个服务的协作处理。要排查问题、优化性能,链路追踪就成了必不可少的能力。Spring Cloud Sleuth 是 Spring 提供的一套轻量级分布式链路追踪方案,它可以自动为每个请求生成唯一标识,并记录调用链中的各个阶段。下面我们就来看看如何一步步实现它。

Spring Cloud Sleuth实现分布式链路追踪详细教程

1. 引入依赖,开启基础追踪能力

要在项目中使用 Sleuth,首先得引入相关依赖。如果你使用的是 Spring Boot 2.6 或更高版本,可以直接添加如下依赖:

Spring Cloud Sleuth实现分布式链路追踪详细教程
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-sleuth</artifactId>
</dependency>

添加完成后,Sleuth 就会自动生效了。你不需要额外写任何代码,它会在日志中输出 traceIdspanId,帮助你识别每一次请求的完整链路。

注意:Sleuth 默认不会把数据上报到外部系统,只负责生成和传递链路信息。如果想做可视化展示,还需要配合 Zipkin 等工具。

Spring Cloud Sleuth实现分布式链路追踪详细教程

2. 查看日志中的 traceId 和 spanId

Sleuth 的核心功能之一就是在每次请求开始时生成一个唯一的 traceId,并在每个操作单元(比如一次 HTTP 请求或方法调用)中生成一个 spanId。这些信息会自动打印在你的日志里。

比如你在控制台看到这样的日志:

[order-service,8e95b7a4d0f5c3a0,8e95b7a4d0f5c3a0,true] ...

这里的字段含义分别是:

  • 应用名称(order-service)
  • traceId(8e95b7a...)
  • spanId(同样值,表示这是第一个 span)
  • 是否导出(true 表示该 trace 会被上报)

这样你就可以通过日志来追踪整个调用链了。如果你使用 ELK 或者类似的日志分析系统,可以基于 traceId 把所有相关日志聚合在一起。


3. 实现跨服务链路追踪

Sleuth 的一大优势是能自动将链路信息透传到下游服务。也就是说,当你从 A 服务调用 B 服务时,Sleuth 会自动把当前的 traceIdspanId 放到 HTTP 请求头中,B 服务接收到后就能继续沿用这条链路。

目前支持自动注入的场景包括:

  • 使用 RestTemplate 发起的请求
  • Feign 客户端调用
  • Spring WebFlux 的 WebClient
  • 消息中间件如 RabbitMQ、Kafka(需要配合 Sleuth Stream)

如果你自己封装了远程调用逻辑,就需要手动设置请求头,例如:

HttpHeaders headers = new HttpHeaders();
sleuthTracer.getCurrentSpan().context().forEach((key, value) -> headers.set(key, value));

这样才能保证链路不中断。


4. 配合 Zipkin 做可视化展示(可选)

虽然 Sleuth 能提供完整的链路数据,但直接看日志还是不够直观。你可以把它和 Zipkin 结合起来,实现图形化展示。

步骤大致如下:

  • 启动 Zipkin Server(可以用官方 Docker 镜像快速部署)
  • 添加 Zipkin 依赖:
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-sleuth-zipkin</artifactId>
</dependency>
  • 在配置文件中指定 Zipkin 地址:
spring:
  zipkin:
    base-url: http://localhost:9411

这样,Sleuth 会自动将 span 数据发送给 Zipkin,你就可以通过 Zipkin 的 Web 页面查看请求的完整调用路径、耗时分布等信息。


基本上就这些。Spring Cloud Sleuth 的使用并不复杂,但确实能大大提升微服务下的可观测性。只要注意日志收集方式和上下游服务之间的上下文传递,就能轻松实现全链路追踪。

终于介绍完啦!小伙伴们,这篇关于《SpringCloudSleuth追踪教程全解析》的介绍应该让你收获多多了吧!欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识,快来关注吧!

StabilityAI图像生成全攻略指南StabilityAI图像生成全攻略指南
上一篇
StabilityAI图像生成全攻略指南
DebianLAMP高可用搭建教程
下一篇
DebianLAMP高可用搭建教程
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    542次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    509次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    497次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    484次学习
查看更多
AI推荐
  • AI边界平台:智能对话、写作、画图,一站式解决方案
    边界AI平台
    探索AI边界平台,领先的智能AI对话、写作与画图生成工具。高效便捷,满足多样化需求。立即体验!
    386次使用
  • 讯飞AI大学堂免费AI认证证书:大模型工程师认证,提升您的职场竞争力
    免费AI认证证书
    科大讯飞AI大学堂推出免费大模型工程师认证,助力您掌握AI技能,提升职场竞争力。体系化学习,实战项目,权威认证,助您成为企业级大模型应用人才。
    398次使用
  • 茅茅虫AIGC检测:精准识别AI生成内容,保障学术诚信
    茅茅虫AIGC检测
    茅茅虫AIGC检测,湖南茅茅虫科技有限公司倾力打造,运用NLP技术精准识别AI生成文本,提供论文、专著等学术文本的AIGC检测服务。支持多种格式,生成可视化报告,保障您的学术诚信和内容质量。
    538次使用
  • 赛林匹克平台:科技赛事聚合,赋能AI、算力、量子计算创新
    赛林匹克平台(Challympics)
    探索赛林匹克平台Challympics,一个聚焦人工智能、算力算法、量子计算等前沿技术的赛事聚合平台。连接产学研用,助力科技创新与产业升级。
    634次使用
  • SEO  笔格AIPPT:AI智能PPT制作,免费生成,高效演示
    笔格AIPPT
    SEO 笔格AIPPT是135编辑器推出的AI智能PPT制作平台,依托DeepSeek大模型,实现智能大纲生成、一键PPT生成、AI文字优化、图像生成等功能。免费试用,提升PPT制作效率,适用于商务演示、教育培训等多种场景。
    544次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码