Micrometer Tracing #

一、Micrometer Tracing概述 #

1.1 什么是Micrometer Tracing #

Micrometer Tracing是Spring Boot 3.x推荐的链路追踪方案,替代了Spring Cloud Sleuth。

1.2 与Sleuth的区别 #

特性 Micrometer Tracing Sleuth
Spring Boot版本 3.x 2.x
API Observation API Brave API
维护状态 活跃 停止维护

二、基本使用 #

2.1 添加依赖 #

xml
<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-tracing-bridge-brave</artifactId>
</dependency>
<dependency>
    <groupId>io.zipkin.reporter2</groupId>
    <artifactId>zipkin-reporter-brave</artifactId>
</dependency>

2.2 配置文件 #

yaml
management:
  tracing:
    enabled: true
    sampling:
      probability: 1.0
  zipkin:
    tracing:
      endpoint: http://localhost:9411/api/v2/spans

2.3 日志配置 #

xml
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%X{traceId},%X{spanId}] [%thread] %-5level %logger{36} - %msg%n</pattern>

三、手动创建Span #

java
@Autowired
private Tracer tracer;

public void doSomething() {
    Span span = tracer.nextSpan().name("custom-span");
    try (Tracer.SpanInScope ws = tracer.withSpan(span.start())) {
        span.tag("key", "value");
    } finally {
        span.end();
    }
}

四、总结 #

要点 说明
Observation API 新的观测API
兼容性 支持多种追踪系统
Spring Boot 3.x 推荐使用

接下来让我们学习 分布式事务

最后更新:2026-03-28