Spring cloud系列十四分布式链路监控Spring Cloud Sleuth

1. 概述

Spring Cloud Sleuth实现对Spring cloud 分布式链路监控
本文介绍了和Sleuth相关的内容，主要内容如下：

Spring Cloud Sleuth中的重要术语和意义：Span、Trance、Annotation
Zipkin中图形化展示分布式链接监控数据并说明字段意义
Spring Cloud集成Sleuth + Zipkin 的代码demo: Sleuth集成Zipkin, Zipkin数据持久化等

2. 术语

Span
Span是基本的工作单元。Span包括一个64位的唯一ID，一个64位trace码，描述信息，时间戳事件，key-value 注解(tags)，span处理者的ID（通常为IP）。
最开始的初始Span称为根span，此span中span id和 trace id值相同。

Trance
包含一系列的span，它们组成了一个树型结构

Annotation
用于及时记录存在的事件。常用的Annotation如下

cs - Client Sent：客户端发送一个请求，表示span的开始
sr - Server Received：服务端接收请求并开始处理它。(sr-cs)等于网络的延迟
ss - Server Sent：服务端处理请求完成，开始返回结束给服务端。(ss-sr)表示服务端处理请求的时间
cr - Client Received：客户端完成接受返回结果，此时span结束。(cr-sr)表示客户端接收服务端数据的时间

如果一个服务的调用关系如下：

那么此时将Span和Trace在一个系统中使用Zipkin注解的过程图形化：

每个颜色的表明一个span(总计7个spans，从A到G)，每个span有类似的信息

Trace Id = X

Span Id = D

Client Sent

此span表示span的Trance Id是X，Span Id是D，同时它发送一个Client Sent事件

spans 的parent/child关系图形化如下：

3. 在Zipkin中图形化展示分布式链接监控数据

3.1 spans在zipkin界面的信息解读

在Zipkin中展示了上图的跟踪信息，红框里是对上图调用span的跟踪

但是你点击这个trace时，我们只看到4个span

为什么两个界面显示的span数量不同，一个是7，一个4.

1 个 spans：来自servier1的接口http:/start 被调用，分别是Server Received (SR) 和 Server Sent (SS) annotations.
2 个 spans：来自 service1 调用service2 的 http:/foo 接口。service1
端有两个span，分别为 Client Sent (CS) 和 Client Received (CR)
annotations。service2 端也有两个span，分别为Server Received (SR) 和Server Sent (SS)
。物理上他有2个span，但是从逻辑上说这个他们组成一个RPC调用的span。
2个span：来自 service2 调用 service3 的 http:/bar 接口，service2
端有两个span，分别为Client Sent (CS) 和 Client Received (CR) annotations。service3
端也有两个span，分别为Server Received (SR) 和Server Sent (SS)
。物理上他有2个span，但是从逻辑上说它们都是同一个RPC调用的span。
2个span：来自 service2 调用 service4 的 http:/bar 接口，service2
端有两个span，分别为Client Sent (CS) 和 Client Received (CR) annotations。service4
端也有两个span，分别为Server Received (SR) and Server Sent (SS)
。物理上他有2个span，但是从逻辑上说这个它们都是同一个RPC调用的span。

所以我们计算物理spans有7个：

1个来自 http:/start 被请求
2个来自 service1调用service2
2个来自 service2调用service3
2个来自 service2调用service4.

从逻辑上说，我们只看到4个span:

1个来自 service1 的接口http:/start 被请求
3个来自服务之前的RCP接口调用

3.2. Zipkin可视化错误

如果调用链路中发生接口调用失败，zipkin会默认使用红色展示信息，如下图：

点击红色的span，可以看到详细的失败信息：

4. Spring Cloud集成Sleuth + Zipkin

本节演示在Spring Cloud中集成Sleuth并将链路监控数据传送到Zipkin，使用Zipkin展示数据，并配置mysql进行数据持久化

4.1. 相关工程

cloud-registration-center
注册中心

cloud-service-zipkin
提供测试服务接口，对外提供有两个接口：
- 调用成功后，马上返回一个结果： http://127.0.0.1:17602//zipkin/simple
- 调用成功后，服务sleep 5s后再返回： http://127.0.0.1:17602//zipkin/sleep

cloud-consumer-zipkin
消费服务
此服务会通过Feign调用cloud-service-zipkin里提供的两个接口(/zipkin/sleep和/zipkin/simple)，我们访问如下URL会调用的对应的接口：
http://127.0.0.1:17603//zipkin/simple
http://127.0.0.1:17603//zipkin/sleep

以上3个服务的代码比较简单，这里代码略，可以自己看github里的代码。下文中只列出和Sleuth和Zipkin相关的配置。

cloud-dashboard-zipkin
配置Zipkin服务，提供可视化链路监控
Zipkin首页：http://127.0.0.1:17601/zipkin/

4.2. 在工程中使用sleuth+zipkin+http配置

在cloud-service-zipkin和cloud-consumer-zipkin中启动sleuth，sleuth会收集spans信息，并使用http异步地将spans 信息发送到Zipkin，然后Zipkin展示信息

cloud-service-zipkin和cloud-consumer-zipkin配置Sleuth+Zipkin
2个工程中为了集成Sleuth和Zipkin，需要在普通工程基础上增加如下配置：

pom.xml增加sleuth和zipkin相关的jar

<!-- sleuth配置 -->

<dependency>

    <groupId>org.springframework.cloud</groupId>

    <artifactId>spring-cloud-starter-sleuth</artifactId>

</dependency>

<!-- 引入zipkin  -->

<dependency>

    <groupId>org.springframework.cloud</groupId>

    <artifactId>spring-cloud-starter-zipkin</artifactId>

</dependency>

application-zipkin.yml
Zipkin+Sleuth配置参数：
- spring.zipkin.baseUrl：指定cloud-dashboard-zipkin的服务地址，本例子中使用真实的IP。在新的版本spring-cloud-sleuth-core-1.3.0.RELEASE中，可以实现通过服务名称进行访问
- spring.sleuth.sampler.percentage：设置采样率，为了测试设置100%采集

spring:

   zipkin:

     enabled: true

     # zipkkin dashboard的地址：通过真实IP地址访问

     baseUrl: http://localhost:17601/

     # 通过cloud-dashboard-zipkin注册到注册中心的服务名称访问，本版本(spring-cloud-sleuth-core-1.2.5.RELEASE)不支持，需要从spring-cloud-sleuth-core-1.3.0.RELEASE开始支持这个功能

     # 配置如下：

     # baseUrl: http://cloud-dashboard-zipkin/

   sleuth:

     sampler:

       #  默认值为0.1f，现在为了测试设置100%采集

       percentage: 1

cloud-dashboard-zipkin
配置zipkin服务

pom.xml

<!-- spring-cloud-starter-zipkin -->

<dependency>

    <groupId>org.springframework.cloud</groupId>

    <artifactId>spring-cloud-starter-zipkin</artifactId>

</dependency>

<!-- zipkin 界面-->

<dependency>

    <groupId>io.zipkin.java</groupId>

    <artifactId>zipkin-autoconfigure-ui</artifactId>

</dependency>

<!-- zipkin 服务类-->

<dependency>

    <groupId>io.zipkin.java</groupId>

    <artifactId>zipkin-server</artifactId>

</dependency>

配置参数
bootstrap-zipkin-http.yml

# port

server:

  port: 17601

spring:

  application:

    # 本服务注册到注册到服务器的名称, 这个名称就是后面调用服务时的服务标识符

    name: cloud-dashboard-zipkin

eureka:

  client:

    serviceUrl:

      # 服务器注册/获取服务器的zone

      defaultZone: http://127.0.0.1:10761/eureka/

      # defaultZone: http://192.168.21.3:10761/eureka/,http://192.168.21.4:10761/eureka/

  instance:

    prefer-ip-address: true

application-zipkin-http.yml
关闭本工程的推送到zipkin服务的功能

spring:

  zipkin:

    enabled: false

启动类：
@EnableZipkinServer：注解此类为Zipkin服务

@EnableEurekaClient // 配置本应用将使用服务注册和服务发现

@SpringBootApplication

@EnableZipkinServer // 启动Zipkin服务

public class ZipkinDashboardCloudApplication {

    public static void main(String[] args) {

        args = new String[1];

        args[0] = "--spring.profiles.active=zipkin-http";

        SpringApplication.run(ZipkinDashboardCloudApplication.class, args);

    }

4.3. 测试

启动zipkin服务，提供可视化链路监控
Zipkin访问地址： http://127.0.0.1:17601/zipkin/

我们演示链路跟踪，访问以下两个请求：
http://127.0.0.1:17603/zipkin/simple ：正常方法
http://127.0.0.1:17603/zipkin/sleep ：访问超时

进入zipkin，访问成功为蓝色，失败为红部。同时显示各个服务花费的时间

点击蓝色记录，进入详细界面
可知整个接口花费约19ms，cloud-zipkin-service的业务执行15ms，cloud-zipkin-consumer访问cloud-zipkin-service的
网络延迟为2ms，返回结果给cloud-zipkin-service的网络延迟是4s

点击cloud-zipkin-service得到更精确的数据

4.4. Zipkin数据持久化

默认情况，zipkin存储记录到内存，如果服务重启，则所有记录丢失。为了保证持久性，zipkin支持Mysql、Elasticsearch、Cassandra存储。我们演示为zipkin配置MYSQL数据库，其它两种配置类似，本文略
pom.xml为cloud-dashboard-zipkin引入新jar

 <!-- zipkin 存储到数据库需要引入此类 -->

<dependency>

    <groupId>io.zipkin.java</groupId>

    <artifactId>zipkin-autoconfigure-storage-mysql</artifactId>

</dependency>

<!--保存到数据库需要如下依赖-->

<dependency>

    <groupId>org.springframework.boot</groupId>

    <artifactId>spring-boot-starter-jdbc</artifactId>

</dependency>

<dependency>

    <groupId>mysql</groupId>

    <artifactId>mysql-connector-java</artifactId>

    <version>6.0.6</version>

</dependency>

配置参数：
application-zipkin-http.yml：
配置启动时会根据classpath:/mysql.sql初始化数据库

spring:

  zipkin:

    enabled: false

  # 配置mysql

  datasource:

    schema: classpath:/mysql.sql

    # url: jdbc:mysql://127.0.0.1/test

    url: jdbc:mysql://127.0.0.1:3306/test?zeroDateTimeBehavior=convertToNull&serverTimezone=GMT%2b8

    username: root

    password: root

# Switch this on to create the schema on startup:

    initialize: true

    continueOnError: true

  sleuth:

    enabled: false

zipkin:

  storage:

    type: mysql

重启服务，服务成功后，查看数据库，自动生成数据库

如此数据库配置完毕，所有的spans信息存储到数据库中，重启服务，也不会丢失记录

4.5 在工程中使用sleuth+zipkin+ Spring Cloud Stream配置

本版本(spring-cloud-sleuth-core-1.2.5.RELEASE)支持集成spring-cloud-sleuth-stream，但是在新版本从spring-cloud-sleuth-core-1.3.0.RELEASE开始不支持spring-cloud-sleuth-stream。推荐直接使用通过集成RabbitMQ
或 Kafka。关于集成RabbitMQ 或 Kafka，关键是引入spring-rabbit 或
spring-kafka依赖包。默认的目的名称为zipkin.
对于这个的使用demo。这里暂时略

5. 代码

以上的详细的代码见下面
github代码，请尽量使用tag v0.11，不要使用master，因为我不能保证master代码一直不变