zipkin的数据存储可以存在4个地方:
- 内存(仅用于测试,数据不会持久化,zipkin-server关掉,数据就没有了)
- 这也是之前使用的
- mysql
- 可能是最熟悉的方式
- es
- Cassandra
一、代码(基于 第二十八章 springboot + zipkin(brave定制-AsyncHttpClient))
1、pom.xml
1 <dependency> 2 <groupId>io.zipkin.bravegroupId> 3 <artifactId>brave-mysqlartifactId> 4 <version>3.9.0version> 5 dependency>
2、ZipkinConfig添加如下
1 @Bean 2 public MySQLStatementInterceptorManagementBean mySQLStatementInterceptorManagementBean(Brave brave) { 3 return new MySQLStatementInterceptorManagementBean(brave.clientTracer()); 4 }
二、数据库
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内容如下:
1 CREATE TABLE IF NOT EXISTS zipkin_spans ( 2 `trace_id` BIGINT NOT NULL, 3 `id` BIGINT NOT NULL, 4 `name` VARCHAR(255) NOT NULL, 5 `parent_id` BIGINT, 6 `debug` BIT(1), 7 `start_ts` BIGINT COMMENT 'Span.timestamp(): epoch micros used for endTs query and to implement TTL', 8 `duration` BIGINT COMMENT 'Span.duration(): micros used for minDuration and maxDuration query' 9 ) ENGINE=InnoDB ROW_FORMAT=COMPRESSED; 10 11 ALTER TABLE zipkin_spans ADD UNIQUE KEY(`trace_id`, `id`) COMMENT 'ignore insert on duplicate'; 12 ALTER TABLE zipkin_spans ADD INDEX(`trace_id`, `id`) COMMENT 'for joining with zipkin_annotations'; 13 ALTER TABLE zipkin_spans ADD INDEX(`trace_id`) COMMENT 'for getTracesByIds'; 14 ALTER TABLE zipkin_spans ADD INDEX(`name`) COMMENT 'for getTraces and getSpanNames'; 15 ALTER TABLE zipkin_spans ADD INDEX(`start_ts`) COMMENT 'for getTraces ordering and range'; 16 17 CREATE TABLE IF NOT EXISTS zipkin_annotations ( 18 `trace_id` BIGINT NOT NULL COMMENT 'coincides with zipkin_spans.trace_id', 19 `span_id` BIGINT NOT NULL COMMENT 'coincides with zipkin_spans.id', 20 `a_key` VARCHAR(255) NOT NULL COMMENT 'BinaryAnnotation.key or Annotation.value if type == -1', 21 `a_value` BLOB COMMENT 'BinaryAnnotation.value(), which must be smaller than 64KB', 22 `a_type` INT NOT NULL COMMENT 'BinaryAnnotation.type() or -1 if Annotation', 23 `a_timestamp` BIGINT COMMENT 'Used to implement TTL; Annotation.timestamp or zipkin_spans.timestamp', 24 `endpoint_ipv4` INT COMMENT 'Null when Binary/Annotation.endpoint is null', 25 `endpoint_ipv6` BINARY(16) COMMENT 'Null when Binary/Annotation.endpoint is null, or no IPv6 address', 26 `endpoint_port` SMALLINT COMMENT 'Null when Binary/Annotation.endpoint is null', 27 `endpoint_service_name` VARCHAR(255) COMMENT 'Null when Binary/Annotation.endpoint is null' 28 ) ENGINE=InnoDB ROW_FORMAT=COMPRESSED; 29 30 ALTER TABLE zipkin_annotations ADD UNIQUE KEY(`trace_id`, `span_id`, `a_key`, `a_timestamp`) COMMENT 'Ignore insert on duplicate'; 31 ALTER TABLE zipkin_annotations ADD INDEX(`trace_id`, `span_id`) COMMENT 'for joining with zipkin_spans'; 32 ALTER TABLE zipkin_annotations ADD INDEX(`trace_id`) COMMENT 'for getTraces/ByIds'; 33 ALTER TABLE zipkin_annotations ADD INDEX(`endpoint_service_name`) COMMENT 'for getTraces and getServiceNames'; 34 ALTER TABLE zipkin_annotations ADD INDEX(`a_type`) COMMENT 'for getTraces'; 35 ALTER TABLE zipkin_annotations ADD INDEX(`a_key`) COMMENT 'for getTraces'; 36 37 CREATE TABLE IF NOT EXISTS zipkin_dependencies ( 38 `day` DATE NOT NULL, 39 `parent` VARCHAR(255) NOT NULL, 40 `child` VARCHAR(255) NOT NULL, 41 `call_count` BIGINT 42 ) ENGINE=InnoDB ROW_FORMAT=COMPRESSED; 43 44 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源码。