SpringCloud Sleuth 使用

时间:2023-03-08 15:36:50
SpringCloud Sleuth 使用

1. 介绍

  Spring-Cloud-Sleuth是Spring Cloud的组成部分之一,为SpringCloud应用实现了一种分布式追踪解决方案,其兼容了Zipkin, HTrace和log-based追踪
    相关说明: zipkin 
      位ID唯一标识,trace以另一个64位ID表示,span还有其他数据信息,比如摘要、时间戳事件、关键值注释(tags)、span的ID、以及进度ID(通常是IP地址)

span在不断的启动和停止,同时记录了时间信息,当你创建了一个span,你必须在未来的某个时刻停止它。

Trace:一系列spans组成的一个树状结构,例如,如果你正在跑一个分布式大数据工程,你可能需要创建一个trace。

Annotation:用来及时记录一个事件的存在,一些核心annotations用来定义一个请求的开始和结束

  • cs - Client Sent -客户端发起一个请求,这个annotion描述了这个span的开始
  • sr - Server Received -服务端获得请求并准备开始处理它,如果将其sr减去cs时间戳便可得到网络延迟
  • ss - Server Sent -注解表明请求处理的完成(当请求返回客户端),如果ss减去sr时间戳便可得到服务端需要的处理请求时间
  • cr - Client Received -表明span的结束,客户端成功接收到服务端的回复,如果cr减去cs时间戳便可得到客户端从服务端获取回复的所有所需时间

将Span和Trace在一个系统中使用Zipkin注解的过程图形化:

2. 使用
    使用http://start.spring.io/  生成项目
    pom.xml  文件如下:
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <projectxmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  4. <modelVersion>4.0.0</modelVersion>
  5. <groupId>com.example</groupId>
  6. <artifactId>zipkinclient</artifactId>
  7. <version>0.0.1-SNAPSHOT</version>
  8. <packaging>jar</packaging>
  9. <name>zipkinclient</name>
  10. <description>Demo project for Spring Boot</description>
  11. <parent>
  12. <groupId>org.springframework.boot</groupId>
  13. <artifactId>spring-boot-starter-parent</artifactId>
  14. <version>1.4.3.RELEASE</version>
  15. <relativePath/><!-- lookup parent from repository -->
  16. </parent>
  17. <properties>
  18. <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  19. <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
  20. <java.version>1.8</java.version>
  21. </properties>
  22. <dependencies>
  23. <dependency>
  24. <groupId>org.springframework.cloud</groupId>
  25. <artifactId>spring-cloud-starter-sleuth</artifactId>
  26. </dependency>
  27. <dependency>
  28. <groupId>org.springframework.cloud</groupId>
  29. <artifactId>spring-cloud-starter-zipkin</artifactId>
  30. </dependency>
  31. <dependency>
  32. <groupId>org.springframework.boot</groupId>
  33. <artifactId>spring-boot-starter-web</artifactId>
  34. </dependency>
  35. <dependency>
  36. <groupId>org.springframework.boot</groupId>
  37. <artifactId>spring-boot-starter-test</artifactId>
  38. <scope>test</scope>
  39. </dependency>
  40. </dependencies>
  41. <dependencyManagement>
  42. <dependencies>
  43. <dependency>
  44. <groupId>org.springframework.cloud</groupId>
  45. <artifactId>spring-cloud-dependencies</artifactId>
  46. <version>Camden.BUILD-SNAPSHOT</version>
  47. <type>pom</type>
  48. <scope>import</scope>
  49. </dependency>
  50. </dependencies>
  51. </dependencyManagement>
  52. <build>
  53. <plugins>
  54. <plugin>
  55. <groupId>org.springframework.boot</groupId>
  56. <artifactId>spring-boot-maven-plugin</artifactId>
  57. </plugin>
  58. </plugins>
  59. </build>
  60. <repositories>
  61. <repository>
  62. <id>spring-snapshots</id>
  63. <name>Spring Snapshots</name>
  64. <url>https://repo.spring.io/snapshot</url>
  65. <snapshots>
  66. <enabled>true</enabled>
  67. </snapshots>
  68. </repository>
  69. <repository>
  70. <id>spring-milestones</id>
  71. <name>Spring Milestones</name>
  72. <url>https://repo.spring.io/milestone</url>
  73. <snapshots>
  74. <enabled>false</enabled>
  75. </snapshots>
  76. </repository>
  77. </repositories>
  78. </project>
3. 编写调用service 
    都是spring rest  service   
  1. @RequestMapping("/demo")
  2. public String getinfo(){
  3. LOG.log(Level.INFO, "RestDemo demo backend is being called");
  4. return "dalongdemo";
  5. }
  6. @Bean // 此处可以使用配置说明
  7. public Sampler defaultSampler() {
  8. return new AlwaysSampler();
  9. }
  10. }
4. 调用方式:
  1. public class FirstController {
  2. @Autowired
  3. public RestTemplate restTemplate;
  4. @RequestMapping("/first")
  5. public String first(){
  6. String result=restTemplate.getForObject("http://localhost:8987/second", String.class);
  7. return "from [second]"+result;
  8. }
  9. @Bean
  10. public Sampler defaultSampler() {
  11. return new AlwaysSampler();
  12. }
  13. }
5. 配置zipkin 访问地址:
     application.properties
  1. server.port=8988
  2. spring.zipkin.base-url=http://XXXXXXX:9411
  3. spring.application.name=first
6. 启动服务
 mvn   spring-boot:run
7. 查看请求信息,以及服务依赖
  还是比较方便的,建议看看官方的例子以及说明文档:http://cloud.spring.io/spring-cloud-sleuth/1.0.x/
   SpringCloud Sleuth 使用
SpringCloud Sleuth 使用
 SpringCloud Sleuth 使用
 SpringCloud Sleuth 使用