首先我们需要在跟踪的服务中集成 Sleuth,所有需要跟踪的服务都加上依赖。
Sleuth Maven 配置代码如下所示。
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-sleuth</artifactId>
</dependency>
集成完成之后,我们就可以看效果了,前提是需要有两个以上的服务,比如 A 服务、B 服务,然后 A 服务中调用 B 服务提供的接口,分别在 A 和 B 服务的接口中输出日志。
首先建两个简单的服务,分别为 sleuth-article-service 和 sleuth-user-service。
sleuth-article-service 中的 ArticleController 调用 sleuth-user-service 提供的接口,具体代码如下。
@RestController
public class ArticleController {
private Logger logger = LoggerFactory.getLogger(ArticleController.class);
@Autowired
private RestTemplate restTemplate;
@Autowired
private ArticleService articleService;
@Autowired
Tracer tracer;
@GetMapping("/article/callHello")
public String callHello() {
logger.info("我是/article/callHello");
tracer.currentSpan().tag("用户", "zhangsan");
return restTemplate.getForObject("http://sleuth-user-service/user/hello", String.class);
}
}
sleuth-user-service 中的 UserController 调用 sleuth-article-service 提供的接口,具体代码如下所示。
@RestController
public class UserController {
private Logger logger = LoggerFactory.getLogger(UserController.class);
@GetMapping("/user/hello")
public String hello() {
logger.info("我是/user/hello");
try {
Thread.sleep(4000);
} catch (InterruptedException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return "hello";
}
}
然后我们访问 sleuth-article-service 服务的接口,查看输出的日志信息,具体如下:
2019-08-28 16:16:10.187 INFO [sleuth-article-service,81bc3db3c143f1fb,81bc3db3c143f1fb,false] 6355 --- [nio-8082-exec-1] c.c.e.controller.ArticleController: 我是/article/callHello
查看 sleuth-user-service 输出的日志信息,具体如下:
2019-08-28 16:16:10.570 INFO [sleuth-user-service,81bc3db3c143f1fb,c0cf0d53ce2a8047,false] 6356 --- [nio-8083-exec-1]c.c.e.controller.UserController: 我是/user/hello
在方法中记录日志,我们会发现在日志的最前面加了一部分内容,这部分内容就是 Sleuth 为服务直接提供的链路信息。
可以看到内容是由 [appname,traceId,spanId,exportable] 组成的,具体含义如下:
- appname:服务的名称,也就是 spring.application.name 的值。
- traceId:整个请求的唯一 ID,它标识整个请求的链路。
- spanId:基本的工作单元,发起一次远程调用就是一个 span。
- exportable:决定是否导入数据到 Zipkin 中。