1.12.4

doc/docs/files/10010_快速体验.md

@@ -6,15 +6,15 @@
 - 执行Mysql脚本`sop.sql`
 - IDE安装lombok插件，然后打开项目(IDEA下可以打开根pom.xml，然后open as project)
 - 启动注册中心，sop-registry（运行SopRegistryApplication.java）
+- 启动网关：打开sop-gateway下的`application-dev.properties`，修改数据库`username/password`，指定zookeeper地址，运行`SopGatewayApplication.java`
 - 启动微服务：sop-story-web(运行SopStoryApplication.java)
-- 启动网关：打开sop-gateway下的`application-dev.yml`，修改数据库`username/password`，运行`SopGatewayApplication.java`
 - 找到sop-test，打开测试用例，进行接口调用测试，运行com.gitee.sop.AlipayClientPostTest.testPost()
 
 确保注册中心先启动
 
 ## 使用admin
 
-- 找到`sop-admin/sop-admin-server`工程，打开sop-admin-server下的`application-dev.yml`，修改数据库`username/password`
+- 找到`sop-admin/sop-admin-server`工程，打开sop-admin-server下的`application-dev.properties`，修改相关配置
 - 运行`com.gitee.sop.adminserver.SopAdminServerApplication.java`
 - 访问：`http://localhost:8082`
 

doc/docs/files/10109_配置Sleuth链路追踪.md

@@ -0,0 +1,104 @@
+# 配置Sleuth链路追踪
+
+配置了Sleuth可以很方便查看微服务的调用路线图，可快速定位问题。
+
+SOP基于SpringCloud，因此只要整合[Spring Cloud Sleuth](https://spring.io/projects/spring-cloud-sleuth)即可。
+除此之外，还需要支持dubbo的链路的跟踪，Sleuth在2.0已经对dubbo做了支持，详见：[brave-instrumentation-dubbo-rpc](https://github.com/openzipkin/brave/tree/master/instrumentation/dubbo-rpc)
+
+接入Spring Cloud Sleuth步骤如下：
+
+- 下载zipkin服务器
+
+以mac环境为例，执行下面命令，下载jar并启动zipkin服务
+
+```
+curl -sSL https://zipkin.io/quickstart.sh | bash -s
+java -jar zipkin.jar
+```
+
+默认端口是9411，更多安装方式详见：[quickstart](https://zipkin.io/pages/quickstart.html)
+
+- sop-gateway/pom.xml添加依赖
+
+```xml
+<!--开启zipkin服务链路跟踪-->
+<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-zipkin</artifactId>
+</dependency>
+```
+
+配置文件新增
+
+```properties
+# zipkin服务跟踪
+spring.zipkin.base-url=http://127.0.0.1:9411/
+# 设置sleuth收集信息的比率，默认0.1，最大是1，数字越大越耗性能
+spring.sleuth.sampler.probability=1
+```
+重启sop-gateway
+
+- 打开sop-story-web/pom.xml
+
+添加依赖：
+
+```xml
+<!--开启zipkin服务链路跟踪-->
+<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-zipkin</artifactId>
+</dependency>
+<!-- zipkin支持dubbo -->
+<dependency>
+    <groupId>io.zipkin.brave</groupId>
+    <artifactId>brave-instrumentation-dubbo-rpc</artifactId>
+    <version>5.6.6</version>
+</dependency>
+```
+
+配置文件新增：
+
+```properties
+# zipkin服务跟踪
+spring.zipkin.base-url=http://127.0.0.1:9411/
+# 设置sleuth收集信息的比率，默认0.1，最大是1，数字越大越耗性能
+spring.sleuth.sampler.probability=1
+# dubbo使用zipkin过滤器
+dubbo.provider.filter=tracing
+dubbo.consumer.filter=tracing
+```
+
+重启服务
+
+- 打开sop-book/sop-book-web/pom.xml
+
+步骤同上
+
+- 运行DubboDemoTest.java单元测试
+
+运行完毕看控制台，找到日志信息
+
+```text
+2019-07-18 16:22:04.438  INFO [story-service,59dae98250b276bd,60828035658f175f,true] 90553 --- [:12345-thread-2] c.g.s.s.service.DefaultDemoService       : dubbo provider, param: DemoParam(id=222)
+```
+
+日志内容多了`[story-service,59dae98250b276bd,60828035658f175f,true]`部分，这些是zipkin加进去的，说明如下：
+
+```text
+story-service：服务名称
+59dae98250b276bd：traceId
+60828035658f175f：spanId
+true：是否上传到zipkin服务器
+```
+
+查看各个服务的控制台，可以发现traceId是一致的。
+
+- 浏览器打开：http://127.0.0.1:9411/
+
+将traceId复制黏贴到右上角文本框进行查询，可看到服务调用链。
+
+
+![预览](images/10109_1.png "10109_1.png")
+
+
+