com.purgeteam:log-trace-zuul-demo

log-trace-spring-boot

License	The Apache License, Version 2.0
Categories	Zuul Application Layer Libs Distributed Applications
GroupId	com.purgeteam
ArtifactId	log-trace-zuul-demo
Last Version	0.1.0.RELEASE
Release Date	Nov 20, 2019
Type	jar
Description	log-trace-spring-boot

Download log-trace-zuul-demo

Filename	Size
log-trace-zuul-demo-0.1.0.RELEASE.pom
log-trace-zuul-demo-0.1.0.RELEASE.jar	3 KB
log-trace-zuul-demo-0.1.0.RELEASE-sources.jar	3 KB
log-trace-zuul-demo-0.1.0.RELEASE-javadoc.jar	25 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.purgeteam/log-trace-zuul-demo/ -->
<dependency>
    <groupId>com.purgeteam</groupId>
    <artifactId>log-trace-zuul-demo</artifactId>
    <version>0.1.0.RELEASE</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.purgeteam/log-trace-zuul-demo/
implementation 'com.purgeteam:log-trace-zuul-demo:0.1.0.RELEASE'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.purgeteam/log-trace-zuul-demo/
implementation ("com.purgeteam:log-trace-zuul-demo:0.1.0.RELEASE")

Apache Buildr

'com.purgeteam:log-trace-zuul-demo:jar:0.1.0.RELEASE'

Apache Ivy

<dependency org="com.purgeteam" name="log-trace-zuul-demo" rev="0.1.0.RELEASE">
  <artifact name="log-trace-zuul-demo" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.purgeteam', module='log-trace-zuul-demo', version='0.1.0.RELEASE')
)

Scala SBT

libraryDependencies += "com.purgeteam" % "log-trace-zuul-demo" % "0.1.0.RELEASE"

Leiningen

[com.purgeteam/log-trace-zuul-demo "0.1.0.RELEASE"]

Dependencies

compile (4)

Group / Artifact	Type	Version
com.purgeteam : log-trace-spring-boot-starter	jar	0.1.0.RELEASE
org.springframework.boot : spring-boot-starter-web	jar
org.springframework.cloud : spring-cloud-starter-netflix-zuul	jar
org.projectlombok : lombok	jar

provided (1)

Group / Artifact	Type	Version
org.springframework.boot : spring-boot-configuration-processor Optional	jar

Project Modules

There are no modules declared in this project.

SpringBoot之微服务日志链路追踪

🔥 🔥 🔥 相关文档请访问 PurgeTeam docs 🔥 🔥 🔥

简介

在微服务里，业务出现问题或者程序出的任何问题，都少不了查看日志，一般我们使用 ELK 相关的日志收集工具，服务多的情况下，业务问题也是有些难以排查，只能确定大致时间定位相关日志。log-trace-spring-boot-starter 解决多个服务调用日志的问题，它可以将一个完整的调用链给整合为一个完整有序的日志。

支持组件：

• zuul 调用
• feign 调用
• restTemplate 调用
• dobbo 调用

日志输出格式：

2019-11-14 14:22:07.796  INFO [log-trace-service-a-demo,ac8ffaaed5f343da,log-trace-zuul-demo,,] 88948 --- [nio-8081-exec-7] c.p.l.t.service.a.demo.TestController    : controller test2 执行 ac8ffaaed5f343da
2019-11-14 14:23:15.569  INFO [log-trace-service-a-demo,04cf5392dc5c4881,log-trace-zuul-demo,,] 88948 --- [nio-8081-exec-9] c.p.l.t.service.a.demo.TestController    : controller test2 执行 04cf5392dc5c4881
2019-11-14 14:24:44.183  INFO [log-trace-service-a-demo,86b5c555ce4f4451,log-trace-zuul-demo,,] 88948 --- [nio-8081-exec-1] c.p.l.t.service.a.demo.TestController    : controller test2 执行 86b5c555ce4f4451

我们可以通过 86b5c555ce4f4451 id 进行查询链路上的所有日志信息。

log-trace-service-a-demo 为当前应用。 log-trace-zuul-demo 为上游应用。

当然这些参数可以基于业务定制的。

功能使用

添加依赖

ps: 实际version版本请使用最新版 最新版本:

点击查看最新新版本

<dependency>
  <groupId>com.purgeteam</groupId>
  <artifactId>log-trace-spring-boot-starter</artifactId>
  <version>0.1.2.RELEASE</version>
</dependency>

ps: 请基于 SpirngBoot2.1.x 版本使用

配置应用

这里以3个微服务来举例子。

1. log-trace-zuul-demo 充当网关功能
2. log-trace-service-a-demo 充当服务A
3. log-trace-service-b-demo 充当服务B

调用链路为:

log-trace-zuul-demo -> log-trace-service-a-demo TestController#test -> log-trace-service-b-demo TestController#test

访问网关地址: http://127.0.0.1:8000/a/test

网关日志如下:

2019-11-14 14:27:37.434 DEBUG [33b07a9c5f324375,this] 89996 --- [nio-8000-exec-1] c.p.l.t.s.i.zuul.TracePreZuulFilter      : zuul traceid 33b07a9c5f324375

网关转发至服务A

服务A 日志如下:

2019-11-14 14:27:37.476  INFO [log-trace-service-a-demo,33b07a9c5f324375,log-trace-zuul-demo,,] 88948 --- [nio-8081-exec-5] c.p.l.t.service.a.demo.TestController    : controller test2 执行 33b07a9c5f324375

服务A 调用 服务B

服务B 日志如下:

2019-11-14 14:27:37.478  INFO [log-trace-service-b-demo,33b07a9c5f324375,log-trace-service-a-demo,,] 88952 --- [nio-8082-exec-3] c.p.l.t.servcie.b.demo.TestController    : header traceId 33b07a9c5f324375
2019-11-14 14:27:37.478  INFO [log-trace-service-b-demo,33b07a9c5f324375,log-trace-service-a-demo,,] 88952 --- [nio-8082-exec-3] c.p.l.t.servcie.b.demo.TestController    : controller test 执行 33b07a9c5f324375
2019-11-14 14:27:37.478  INFO [log-trace-service-b-demo,33b07a9c5f324375,log-trace-service-a-demo,,] 88952 --- [nio-8082-exec-3] c.p.l.trace.servcie.b.demo.TestService   : test 方法执行 33b07a9c5f324375
2019-11-14 14:27:37.478  INFO [log-trace-service-b-demo,33b07a9c5f324375,log-trace-service-a-demo,,] 88952 --- [nio-8082-exec-3] c.p.l.trace.servcie.b.demo.TestService   : test1 方法执行 33b07a9c5f324375

这样可以在第三方日志平台按照一个id进行查询了。

如 ELK 通过 33b07a9c5f324375 id 查询出相关的所有链路调用。

配置输出格式

目前支持以上参数:

X-B3-ParentName 上游服务名称
X-B3-TraceId 为一个请求分配的ID号，用来标识一条请求链路。

通过 application.properties 进行配置。

spring.trace.log.format=X-B3-TraceId,X-B3-ParentName


`spring.trace.log.format` 配置参数顺序将影响日志输出格式。

不配置将按照默认格式输出。

日志输出如下:

2019-11-14 14:27:37.434 DEBUG [33b07a9c5f324375,this] 89996 --- [nio-8000-exec-1] c.p.l.t.s.i.zuul.TracePreZuulFilter      : zuul traceid 33b07a9c5f324375

总结

目前实现了日志连贯的功能，后续将支持定制输出 比如按照登陆人员id进行输出，方便追踪用户行为。 框架方便后续支持 Dubbo 等。

示例代码地址:log-trace-spring-boot

作者GitHub: Purgeyao 欢迎关注

qq交流群: 812321371 微信交流群: MercyYao

微信公众号:

purgeteam

Springboot相关组件简化开发，微信交流群:MercyYao QQ交流群:812321371。Springboot peripherals to simplify development. WeChat ac group:MercyYao QQ ac group:812321371

Versions

Version
0.1.0.RELEASE Nov 20, 2019