全部产品
云市场

上传数据到 Zipkin

更新时间:2020-02-18 09:27:22

本文将演示如何使用 SOFATracer 集成 Zipkin 进行数据上报展示。假设您已经基于 SOFABoot 构建了一个简单的 Spring Web 工程,那么可以通过如下步骤进行操作:

  1. 引入依赖
  2. 配置文件
  3. 启动 Zipkin 服务端
  4. 启动应用
  5. 查看 Zipkin 服务端展示

引入依赖

添加 SOFATracer 依赖

工程中添加 SOFATracer 依赖:

  1. <dependency>
  2. <groupId>com.alipay.sofa</groupId>
  3. <artifactId>tracer-sofa-boot-starter</artifactId>
  4. </dependency>

配置 Zipkin 依赖

考虑到 Zipkin 的数据上报能力不是 SOFATracer 默认开启的能力,所以期望使用 SOFATracer 做数据上报时,需要添加如下的 Zipkin 数据汇报的依赖:

  1. <dependency>
  2. <groupId>io.zipkin.zipkin2</groupId>
  3. <artifactId>zipkin</artifactId>
  4. <version>2.11.12</version>
  5. </dependency>
  6. <dependency>
  7. <groupId>io.zipkin.reporter2</groupId>
  8. <artifactId>zipkin-reporter</artifactId>
  9. <version>2.7.13</version>
  10. </dependency>

配置文件

在工程的 application.properties 文件下添加一个 SOFATracer 要使用的参数,包括spring.application.name 用于标示当前应用的名称;logging.path 用于指定日志的输出目录。

  1. # Application Name
  2. spring.application.name=SOFATracerReportZipkin
  3. # logging path
  4. logging.path=./logs
  5. com.alipay.sofa.tracer.zipkin.enabled=true
  6. com.alipay.sofa.tracer.zipkin.baseUrl=http://localhost:9411

启动 Zipkin 服务端

启动 Zipkin 服务端用于接收 SOFATracer 汇报的链路数据,并做展示。Zipkin Server 的搭建可以参考此文档进行配置和服务端的搭建。

启动应用

可以将工程导入到 IDE 中运行生成的工程里面中的 main 方法启动应用,也可以直接在该工程的根目录下运行 mvn spring-boot:run,将会在控制台中看到启动日志:

  1. 2018-05-12 13:12:05.868 INFO 76572 --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter: 'SpringMvcSofaTracerFilter' to urls: [/*]
  2. 2018-05-12 13:12:06.543 INFO 76572 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/helloZipkin]}" onto public java.util.Map<java.lang.String, java.lang.Object> com.alipay.sofa.tracer.examples.zipkin.controller.SampleRestController.helloZipkin(java.lang.String)
  3. 2018-05-12 13:12:07.164 INFO 76572 --- [ main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8080 (http)

可以通过在浏览器中输入 http://localhost:8080/helloZipkin 来访问 REST 服务,结果类似如下:

  1. {
  2. content: "Hello, SOFATracer Zipkin Remote Report!",
  3. id: 1,
  4. success: true
  5. }

查看 Zipkin 服务端展示

打开 Zipkin 服务端界面,假设部署的 Zipkin 服务端的地址是 http://localhost:9411 ,打开 URL 并搜索 helloZipkin(由于本地访问的地址是 localhost:8080/helloZipkin),可以看到展示的链路图。

Spring 工程运行

对于一般的 Spring 工程,通常使用 tomcat/jetty 作为 servlet 容器来启动应用。具体工程,可参考 在 Spring 工程中使用 SOFATracer