第二十九章 springboot + zipkin + mysql

zipkin的数据存储可以存在4个地方：

• 内存（仅用于测试，数据不会持久化，zipkin-server关掉，数据就没有了）
  • 这也是之前使用的
• mysql
  • 可能是最熟悉的方式
• es
• Cassandra

一、代码（基于 第二十八章 springboot + zipkin（brave定制-AsyncHttpClient））

1、pom.xml

         <dependency>
             <groupId>io.zipkin.brave</groupId>
             <artifactId>brave-mysql</artifactId>
             <version>3.9.0</version>
         </dependency>

2、ZipkinConfig添加如下

     @Bean
     public MySQLStatementInterceptorManagementBean mySQLStatementInterceptorManagementBean(Brave brave) {
         return new MySQLStatementInterceptorManagementBean(brave.clientTracer());
     }

二、数据库

1、建库

• 自己创建库（eg.mytestdb）就好

2、建表

• 在mytestdb中执行zipkin准备好的脚本mysql.sql来创建三张表以及各个索引。

mysql.sql位置：https://github.com/openzipkin/zipkin/blob/master/zipkin-storage/mysql/src/main/resources/mysql.sql

或者直接将整个zipkin项目克隆下来，再进去看内容。

mysql.sql内容如下：

 CREATE TABLE IF NOT EXISTS zipkin_spans (
   `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;

 ALTER TABLE zipkin_spans ADD UNIQUE KEY(`trace_id`, `id`) COMMENT 'ignore insert on duplicate';
 ALTER TABLE zipkin_spans ADD INDEX(`trace_id`, `id`) COMMENT 'for joining with zipkin_annotations';
 ALTER TABLE zipkin_spans ADD INDEX(`trace_id`) COMMENT 'for getTracesByIds';
 ALTER TABLE zipkin_spans ADD INDEX(`name`) COMMENT 'for getTraces and getSpanNames';
 ALTER TABLE zipkin_spans ADD INDEX(`start_ts`) COMMENT 'for getTraces ordering and range';

 CREATE TABLE IF NOT EXISTS zipkin_annotations (
   `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;

 ALTER TABLE zipkin_annotations ADD UNIQUE KEY(`trace_id`, `span_id`, `a_key`, `a_timestamp`) COMMENT 'Ignore insert on duplicate';
 ALTER TABLE zipkin_annotations ADD INDEX(`trace_id`, `span_id`) COMMENT 'for joining with zipkin_spans';
 ALTER TABLE zipkin_annotations ADD INDEX(`trace_id`) COMMENT 'for getTraces/ByIds';
 ALTER TABLE zipkin_annotations ADD INDEX(`endpoint_service_name`) COMMENT 'for getTraces and getServiceNames';
 ALTER TABLE zipkin_annotations ADD INDEX(`a_type`) COMMENT 'for getTraces';
 ALTER TABLE zipkin_annotations ADD INDEX(`a_key`) COMMENT 'for getTraces';

 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;

 ALTER TABLE zipkin_dependencies ADD UNIQUE KEY(`day`, `parent`, `child`);

执行脚本之后，数据库出现三张表，如下：

三、启动命令

• STORAGE_TYPE=mysql MYSQL_HOST=192.192.192.192 MYSQL_TCP_PORT=3306 MYSQL_DB=mytestdb MYSQL_USER=root MYSQL_PASS=123456 nohup java -jar zipkin-server-1.5.1-exec.jar &
  • STORAGE_TYPE：存储类型，这里是mysql
  • MYSQL_HOST和MYSQL_TCP_PORT：创建connection
  • MYSQL_USER和MYSQL_PASS：用户名和密码

四、测试

启动4个service，然后swagger测试，最后查看zipkin和数据库表即可。

参考：

• https://github.com/openzipkin/zipkin/tree/master/zipkin-server：有存储到mysql、Cassandra、es的各个配置选项和相关的启动命令。
• https://github.com/openzipkin/zipkin/tree/master/zipkin-storage/mysql：有mysql存储的zipkin源码。