首先我们需要在跟踪的服务中集成 Sleuth,所有需要跟踪的服务都加上依赖。

    Sleuth Maven 配置代码如下所示。

    1. <dependency>
    2. <groupId>org.springframework.cloud</groupId>
    3. <artifactId>spring-cloud-starter-sleuth</artifactId>
    4. </dependency>

    集成完成之后,我们就可以看效果了,前提是需要有两个以上的服务,比如 A 服务、B 服务,然后 A 服务中调用 B 服务提供的接口,分别在 A 和 B 服务的接口中输出日志。

    首先建两个简单的服务,分别为 sleuth-article-service 和 sleuth-user-service。

    sleuth-article-service 中的 ArticleController 调用 sleuth-user-service 提供的接口,具体代码如下。

    1. @RestController
    2. public class ArticleController {
    3. private Logger logger = LoggerFactory.getLogger(ArticleController.class);
    4. @Autowired
    5. private RestTemplate restTemplate;
    6. @Autowired
    7. private ArticleService articleService;
    8. @Autowired
    9. Tracer tracer;
    10. @GetMapping("/article/callHello")
    11. public String callHello() {
    12. logger.info("我是/article/callHello");
    13. tracer.currentSpan().tag("用户", "zhangsan");
    14. return restTemplate.getForObject("http://sleuth-user-service/user/hello", String.class);
    15. }
    16. }

    sleuth-user-service 中的 UserController 调用 sleuth-article-service 提供的接口,具体代码如下所示。

    1. @RestController
    2. public class UserController {
    3. private Logger logger = LoggerFactory.getLogger(UserController.class);
    4. @GetMapping("/user/hello")
    5. public String hello() {
    6. logger.info("我是/user/hello");
    7. try {
    8. Thread.sleep(4000);
    9. } catch (InterruptedException e) {
    10. // TODO Auto-generated catch block
    11. e.printStackTrace();
    12. }
    13. return "hello";
    14. }
    15. }

    然后我们访问 sleuth-article-service 服务的接口,查看输出的日志信息,具体如下:

    1. 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 输出的日志信息,具体如下:

    1. 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 中。