首页 > 原创文章 > 软件开发 > 查看文章

关于使用Zipkin与RabbitMQ的追踪集成

所属分类:软件开发 来源: 丁老师原创 更新时间:2025-10-09 08:27 浏览: 2341 IP属地: 深圳

有同学提问,使用的Spring Boot框架,有两个微服务,为了实现追踪,使用了<artifactId>spring-cloud-sleuth-zipkin</artifactId>以及zipkin。A服务是生产者,通过RabbitMQ broker发送消息。B服务是消费者,使用了@RabbitListener。想实现将traceId(包含span详情)从A服务传递到B服务,但无法将zipkin与RabbitMQ集成并实现追踪传播。这个该怎么实现呢?

要实现Spring Boot微服务通过RabbitMQ传递Zipkin追踪信息(traceId、spanId等),需要正确配置Sleuth和Zipkin,并在消息中携带追踪上下文。

以下是详细步骤:

1. 添加依赖
在两个服务的pom.xml中添加以下依赖:

<!-- Spring Cloud Sleuth + Zipkin -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-sleuth</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-sleuth-zipkin</artifactId>
</dependency>

<!-- RabbitMQ -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-amqp</artifactId>
</dependency>

2. 配置文件
A服务(生产者)和B服务(消费者)的application.yml配置相同:

spring:
    application:
        name: 服务名# A服务填"service-a",B服务填"service-b"
    rabbitmq:
        host: localhost
        port: 5672
        username: guest
        password: guest
sleuth:
    sampler:
        probability: 1.0# 开发环境全量采样,生产环境可调整
    baggage:
        remote-fields: x-b3-traceid, x-b3-spanid, x-b3-parentspanid, x-b3-sampled# 传递的追踪字段
        correlation-fields: x-b3-traceid, x-b3-spanid
    zipkin:
        base-url: http://localhost:9411# Zipkin服务器地址

3. 生产者(A服务)代码:

import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ProducerController {

    @Autowired
    private RabbitTemplate rabbitTemplate;

    @GetMapping("/send")
    public String sendMessage() {
        String message = "Hello from Service A";
        //发送消息到RabbitMQ,Sleuth会自动在消息头中添加追踪信息
        rabbitTemplate.convertAndSend("test-exchange", "test.routing.key", message);
        return "Message sent: " + message;
    }
}

4. 消费者(服务 B)代码

import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;
import brave.Tracer;

@Component
public class Consumer {

    //注入Tracer可手动获取当前追踪信息
    private final Tracer tracer;

    public Consumer(Tracer tracer) {
        this.tracer = tracer;
    }

    @RabbitListener(queues = "test-queue")
    public void receiveMessage(String message) {
        //消费消息时,Sleuth会自动从消息头中提取追踪信息
        String traceId = tracer.currentSpan().context().traceIdString();
        String spanId = tracer.currentSpan().context().spanIdString();
        System.out.println("Received message: " + message);
        System.out.println("TraceId: " + traceId + ", SpanId: " + spanId);
    }
}

5. RabbitMQ配置(两个服务都需要)

import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.Queue;
import org.springframework.amqp.core.TopicExchange;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class RabbitConfig {

    @Bean
    public Queue queue() {
        return new Queue("test-queue", true);
    }

    @Bean
    public TopicExchange exchange() {
        return new TopicExchange("test-exchange");
    }

    @Bean
    public Binding binding(Queue queue, TopicExchange exchange) {
        return BindingBuilder.bind(queue).to(exchange).with("test.routing.key");
    }
}

6. 启动Zipkin服务器
使用 Docker 启动 Zipkin:

docker run -d -p 9411:9411 openzipkin/zipkin

7. 验证追踪
1.启动RabbitMQ、Zipkin、A服务和B服务。
2.访问A服务的接口:http://localhost:服务A端口/send。
3.查看B服务的控制台,会输出与A服务相同的traceId。
4.访问Zipkin控制台(http://localhost:9411),可看到完整的调用链路。

关键原理
1.Spring Cloud Sleuth会自动在RabbitMQ消息头中添加X-B3-TraceId、X-B3-SpanId等追踪字段。
2.消费者接收消息时,Sleuth会从消息头中提取这些字段,实现追踪上下文的传递。
3.无需手动处理追踪信息,Sleuth与 RabbitMQ的集成是自动完成的。

如果仍有问题,可检查:
1.依赖版本是否兼容(可改为使用Spring Cloud最新稳定版)。
2.RabbitMQ是否正常运行,消息能否正常发送/接收。
3.Zipkin服务器地址是否正确配置。



相关文章

hash_hmac(): Unknown h...

最近在使用Fastadmin时,突然遇到一个奇怪的问题,程序抛出“hash_hmac(): Unknown hashing algorithm”异常。之前都好好的,怎么突然就遇到这么个问题呢?查看了下Driver.php这个源码,发现在...

鸿蒙应用打包和发布的流程介绍

最近有个项目,是开发鸿蒙APP,涉及到鸿蒙应用的打包和发布的流程,特此开个文章做一下介绍。打包应用鸿蒙应用主要通过DevEco Studio进行打包,打包后生成的是HAP文件 (HarmonyOS Application Package...

Fastadmin的运行环境以及安装方法

Fastadmin是一款优秀的PHP快速开发框架,包括了现成的后台管理和前端模块,安装好后无需复杂的配置,直接就可以上手使用,后端部分支持CRUD一键生成,相当的方便。Fastadmin本质上是基于ThinkPHP开发封装的软件,专门用...

Fastadmin系统配置城市地区保存城市名...

在Fastadmin管理程序的系统配置中,可以添加城市地区的字段,用以三级省市区的选择,但是有的同学发现,在添加城市地区字段以后,保存的是城市名称的字符串,并不是城市ID,这样的话接下来业务涉及城市的扩展和匹配非常的不方便(用中文城市名...

推荐文章

Uniapp开发微信小程序怎么模拟位置?

废话不多说,直接上货。在微信开发者工具调试栏,找到Sensor(传感器)。Geolocation,勾选启用,下边输入经纬度即可!

微信小程序开发生成普通二维码打开小程序的方法

在开发微信小程序的过程中,生成的是带有logo的小程序二维码,并且这个二维码不是通用的二维码,而是只能用微信打开的专属二维码,如图:遇到这样一个需求,生成的二维码要方形的通用二维码,并且不能带有小程序的logo。这种该怎么实现呢?经过查询,...

VideoJs宽度高度自适应100%的方法

videojs是一款非常不错的html video播放器插件,很多同学经常在群里问我,说丁老师这个videojs怎么设置为宽度或者高度自适应呢,不想把video的width和height写死,有没有什么办法呢。丁老师经过研究发现啊,vide...

CI框架页面添加全局变量的方法

CI框架是一款很小却又非常强大的PHP程序框架,非常适合用来搭建中小型网站以及扩展程序。有同学问到,在使用CI框架时,比如要对全站的标题、公司信息、电话等设置一个全局变量,不用每个页面都写死,该怎么办呢?丁老师来教你:1.打开页面的控制器文...