宣告：本文來源於MLDN培訓視訊的課堂筆記，寫在這裡只是為了方便查閱。

1、概念：SpringCloudSleuth

2、具體內容

Sleuth 是一種提供的跟蹤服務，也就是說利用 sleuth 技術可以實現完整的微服務的訪問路徑的跟蹤操作。

2.1、SpringCloudSleuth 簡介

微服務可以將整個的系統拆分為無數個子系統，於是這樣一來就有可能出現幾種可怕的場景：

· 程式碼的除錯：

      |- 你的系統有可能變慢了，於是這個時候就需要去追蹤每一個微服務的執行的速度；

      |- 如果現在你的微服務採用了串聯的方式進行了互相呼叫，那麼如何確認某一個微服務出現了問題呢？

· 微服務混合呼叫：

      |- 現在微服務變為了環形呼叫，那麼這些關係該如何描述出來？

 在建立微服務的時候一定要有一些合適的開發契約，所有的開發者以及服務的呼叫者要按照統一的方式進行程式的呼叫處理， 這樣才可以成為一個優秀的微服務設計。

 所以在 SpringCloud 之中提供的 Sleuth 技術就可以實現微服務的呼叫跟蹤，也就是說它可以自動的形成一個呼叫連線線，通過這個連線線使得開發者可以輕鬆的找到所有微服務間關係，同時也可以獲取微服務所耗費的時間， 這樣就可以進行微服務呼叫狀態的監控以及相應的資料分析。

Span 裡面包含有如下內容：

 · cs-Client Sent：客戶端發出一個請求，描述的是一個 Span 開始；

· sr-Server Received：服務端接收請求，利用 sr-cs 就屬於傳送的網路延遲；

· ss-Server Sent：服務端傳送請求（迴應處理），ss-sr 就屬於服務端的消耗時間；

· cr-Client Received：客戶端接收到服務端資料，cr-ss 就表示回覆所需要的時間。

 2.2、SpringCloudSleuth 基本配置

 SpringCloudSleuth 使用的核心元件在於 Twitter 推出的 zipkin 監控元件，所以本次的配置的模組一定要包含 zipkin 相關配置依賴，本次實現一個基礎的呼叫邏輯：consumer-zuul-dept。

 1、 【microcloud-sleuth-8601】通過“microcloud-provider-company-8101”專案複製得來；

 2、 【microcloud-sleuth-8601】修改 pom.xml 配置檔案：

 · 由於 sleuth 的應用比較複雜，而且也牽扯到埋點的資料分析，本次不使用安全處理模組：

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-sleuth</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-zipkin</artifactId>
        </dependency>
        <dependency>
            <groupId>io.zipkin.java</groupId>
            <artifactId>zipkin-server</artifactId>
        </dependency>
        <dependency>
            <groupId>io.zipkin.java</groupId>
            <artifactId>zipkin-autoconfigure-ui</artifactId>
        </dependency>

 3、 【microcloud-sleuth-8601】修改 application.yml 配置檔案：

server:
  port: 8601
spring: 
  application:
    name: microcloud-zipkin-server

 4、 【microcloud-sleuth-8601】修改程式啟動類：

package cn.study.microcloud;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.circuitbreaker.EnableCircuitBreaker;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

import zipkin.server.EnableZipkinServer;
@SpringBootApplication
@EnableCircuitBreaker
@EnableZipkinServer
public class Zipkin_8601_StartSpringCloudApplication {
    public static void main(String[] args) {
        SpringApplication.run(Zipkin_8601_StartSpringCloudApplication.class, args);
    }
}

 5、 修改 hosts 配置檔案，追加一個新的主機名稱對映：

 127.0.0.1 zipkin.com

 6、 【microcloud-consumer-feign、microcloud-zuul-gateway-9501、microcloud-provider-dept-8001】修改 pom.xml 配置檔案，追加 zipkin 相關依賴程式包：

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-zipkin</artifactId>
        </dependency>

 7、 【microcloud-consumer-feign、microcloud-zuul-gateway-9501、microcloud-provider-dept-8001】修改 application.yml 配置檔案：

spring:
  zipkin:
    base-url: http://zipkin.com:8601 # 所有的資料提交到此服務之中
  sleuth:
    sampler:
     percentage: 1.0 # 定義抽樣比率，預設為0.1  
  application:
    name: microcloud-consumer-feign 

 一定要有每一個微服務的名字，這樣會比較好觀察程式的執行軌跡。

 8、 依次啟動所有的服務：microcloud-sleuth-8601、microcloud-consumer-feign、microcloud-zuul-gateway-9501、microcloud-provider-dept-8001；

 輸入訪問地址：http://zipkin.com:8601；就可以看到各個微服務之間的呼叫關係了

 2.3、資料採集

 現在已經成功的實現了一個 SpringCloudSleuth 基礎操作，但是需要考慮一個實際的問題，現在所有的統計的彙總操作都是記錄在記憶體之中的，也就是說如果你現在已經關閉了 zipkin 服務端，那麼這些統計資訊就將消失，很明顯這樣的做法並不符合實際要求，資料應該被記錄下來，而且有可能你很多的微服務要傳送大量的資料資訊進入，為了解決這種高併發的問題，可以結合訊息元件（Stream）進行快取處理，而且本次為了方便可以將統計的結果儲存在資料庫之中（mysql）。

1、 需要建立資料庫指令碼，指令碼是從官網拷貝下來的直接複製使用即可：

DROP DATABASE IF EXISTS zipkin ;
CREATE DATABASE zipkin CHARACTER SET UTF8 ;
USE zipkin ;
CREATE TABLE IF NOT EXISTS zipkin_spans (
 `trace_id_high` BIGINT NOT NULL DEFAULT 0 COMMENT 'If non zero, this means the trace uses 128 bit traceIds
instead of 64 bit',
 `trace_id` BIGINT NOT NULL,
 `id` BIGINT NOT NULL,
 `name` VARCHAR(255) NOT NULL,
 `parent_id` BIGINT,
 `debug` BIT(1),
 `start_ts` BIGINT COMMENT 'Span.timestamp(): epoch micros used for endTs query and to implement TTL',
 `duration` BIGINT COMMENT 'Span.duration(): micros used for minDuration and maxDuration query'
) ENGINE=InnoDB ROW_FORMAT=COMPRESSED CHARACTER SET=utf8 COLLATE utf8_general_ci;
ALTER TABLE zipkin_spans ADD UNIQUE KEY(`trace_id_high`, `trace_id`, `id`);
ALTER TABLE zipkin_spans ADD INDEX(`trace_id_high`, `trace_id`, `id`);
ALTER TABLE zipkin_spans ADD INDEX(`trace_id_high`, `trace_id`);
ALTER TABLE zipkin_spans ADD INDEX(`name`);
ALTER TABLE zipkin_spans ADD INDEX(`start_ts`);
CREATE TABLE IF NOT EXISTS zipkin_annotations (
 `trace_id_high` BIGINT NOT NULL DEFAULT 0 COMMENT 'If non zero, this means the trace uses 128 bit traceIds
instead of 64 bit',
 `trace_id` BIGINT NOT NULL COMMENT 'coincides with zipkin_spans.trace_id',
 `span_id` BIGINT NOT NULL COMMENT 'coincides with zipkin_spans.id',
 `a_key` VARCHAR(255) NOT NULL COMMENT 'BinaryAnnotation.key or Annotation.value if type == -1',
 `a_value` BLOB COMMENT 'BinaryAnnotation.value(), which must be smaller than 64KB',
 `a_type` INT NOT NULL COMMENT 'BinaryAnnotation.type() or -1 if Annotation',
 `a_timestamp` BIGINT COMMENT 'Used to implement TTL; Annotation.timestamp or zipkin_spans.timestamp',
 `endpoint_ipv4` INT COMMENT 'Null when Binary/Annotation.endpoint is null',
 `endpoint_ipv6` BINARY(16) COMMENT 'Null when Binary/Annotation.endpoint is null, or no IPv6 address',
 `endpoint_port` SMALLINT COMMENT 'Null when Binary/Annotation.endpoint is null',
 `endpoint_service_name` VARCHAR(255) COMMENT 'Null when Binary/Annotation.endpoint is null'
) ENGINE=InnoDB ROW_FORMAT=COMPRESSED CHARACTER SET=utf8 COLLATE utf8_general_ci;
ALTER TABLE zipkin_annotations ADD UNIQUE KEY(`trace_id_high`, `trace_id`, `span_id`, `a_key`,
`a_timestamp`);
ALTER TABLE zipkin_annotations ADD INDEX(`trace_id_high`, `trace_id`, `span_id`) ;
ALTER TABLE zipkin_annotations ADD INDEX(`trace_id_high`, `trace_id`);
ALTER TABLE zipkin_annotations ADD INDEX(`endpoint_service_name`);
ALTER TABLE zipkin_annotations ADD INDEX(`a_type`);
ALTER TABLE zipkin_annotations ADD INDEX(`a_key`);
CREATE TABLE IF NOT EXISTS zipkin_dependencies (
 `day` DATE NOT NULL,
 `parent` VARCHAR(255) NOT NULL,
 `child` VARCHAR(255) NOT NULL,
 `call_count` BIGINT
) ENGINE=InnoDB ROW_FORMAT=COMPRESSED CHARACTER SET=utf8 COLLATE utf8_general_ci;
ALTER TABLE zipkin_dependencies ADD UNIQUE KEY(`day`, `parent`, `child`);

 2、 【microcloud-sleuth-8601】修改 pom.xml 配置檔案，追加相關的依賴程式包：

    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-sleuth-zipkin-stream</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-stream-rabbit</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jdbc</artifactId>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
    </dependency>
<!--         <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-sleuth</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-zipkin</artifactId>
        </dependency> -->

 3、 【microcloud-sleuth-8601】修改 application.yml 配置檔案：

server:
  port: 8601
spring: 
  rabbitmq:
   host: rabbitmq-server
   port: 5672
   username: studyjava
   password: hello
   virtual-host: /
  datasource:
    driver-class-name: org.gjt.mm.mysql.Driver      # 配置MySQL的驅動程式類
    url: jdbc:mysql://localhost:3306/zipkin           # 資料庫連線地址
    username: root                                  # 資料庫使用者名稱
    password: mysqladmin                          # 資料庫連線密碼
    initialize: true                          
  application:
    name: microcloud-zipkin-server
zipkin:
 storage: # 設定zipkin收集的資訊通過mysql進行儲存
   type: mysql
 

 4、 【microcloud-sleuth-8601】可以開啟安全配置項：

        <dependency>
            <groupId>cn.study</groupId>
            <artifactId>microcloud-security</artifactId>
        </dependency>

 5、 【microcloud-consumer-feign、microcloud-zuul-gateway-9501、microcloud-provider-dept-8001】修改 pom.xml 配置檔案：

    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-sleuth-zipkin-stream</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-stream-rabbit</artifactId>
    </dependency>
<!--         <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-zipkin</artifactId>
        </dependency> -->

 6、 【microcloud-consumer-feign、microcloud-zuul-gateway-9501、microcloud-provider-dept-8001】修改 application.yml 配置檔案：

spring: 
  rabbitmq:
   host: rabbitmq-server
   port: 5672
   username: studyjava
   password: hello
   virtual-host: /

 同時刪除掉已有的 zipkin.base-url 的配置項。

 7、 【microcloud-sleuth-8601】修改啟動程式類的使用註解：

package cn.study.microcloud;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.circuitbreaker.EnableCircuitBreaker;
import org.springframework.cloud.sleuth.zipkin.stream.EnableZipkinStreamServer;

import zipkin.server.EnableZipkinServer;
@SpringBootApplication
@EnableCircuitBreaker
@EnableZipkinStreamServer
public class Zipkin_8601_StartSpringCloudApplication {
    public static void main(String[] args) {
        SpringApplication.run(Zipkin_8601_StartSpringCloudApplication.class, args);
    }
}

 8、 此時依次啟動各個微服務之後所有的資訊都將被記錄到 MySQL 資料庫之中，這樣即使當前的 zipkin 服務關閉了，那麼也可以進行資訊的持久化儲存，下次啟動之後依然可以讀取到執行順序。