MDC(Mapped Diagnostic Context,映射调试上下文)是 log4j 、logback及log4j2 提供的一种方便在多线程条件下记录日志的功能。MDC 可以看成是一个与当前线程绑定的哈希表,可以往其中添加键值对。MDC 中包含的内容可以被同一线程中执行的代码所访问。当前线程的子线程会继承其父线程中的 MDC 的内容。当需要记录日志时,只需要从 MDC 中获取所需的信息即可。
API说明 clear() => 移除所有MDCget (String key) => 获取当前线程MDC中指定key的值getContext() => 获取当前线程MDC的MDCput(String key, Object o) => 往当前线程的MDC中存入指定的键值对remove(String key) => 删除当前线程MDC中指定的键值对 。 MDC使用 1.拦截器 2.工具类 日志文件配置重点是%X{requestId},requestId和MDC中的键名称保持一致。
MDC 存在的问题至此基本的功能已经实现,但是存在一下几个问题
多线程情况下,子线程中打印日志会丢失traceId.HTTP跨服务之间的调用丢失traceId. 子线程日志打印丢失traceId问题重现:
运行结果:
2022-03-13 12:45:44.156 [http-nio-8089-exec-1] INFO [ec05a600ed1a4556934a3afa4883766a] c.s.fw.controller.UserController - getUserByName paramter name:12022-03-13 12:45:44.173 [Pool-A1] INFO [] c.s.fw.controller.UserController - child thread:1
从运行的结果来看,子线程打印日志,日志中的traceId信息已经丢失。
解决方案:
子线程在打印日志的过程中traceId将丢失,解决方案为重写线程池(对于直接new Thread 创建线程的情况不考略),实际开发中也需要禁止这种情况。
因为Spring Boot ThreadPoolTaskExecutor 已经对ThreadPoolExecutor进行封装,只需要继承ThreadPoolTaskExecutor重写相关的执行方法即可。
代码说明:
判断当前线程对应MDC的Map是否存在,如果存在则设置设置MDC中的traceId值,不存在则新生成,如果是子线程,MDC中traceId不为null执行run方法线程池配置
重新运行结果发现子线程能够正常获取traceid信息进行跟踪。
2022-03-13 13:19:30.688 [Task-A1] INFO [482929425cbc4476a4e7168615af7890] c.s.fw.controller.UserController - child thread:12022-03-13 13:19:31.003 [Task-A1] INFO [482929425cbc4476a4e7168615af7890] c.s.fw.service.impl.UserServiceImpl - name:1
HTTP调用丢失traceIdHTTP调用第三方服务接口时traceId丢失,需要在发送请求时在Request Header中添加traceId,在被调用方添加拦截器获取header中的traceId添加到MDC中。
HTTP调用有多种方式,比较常见的有HttpClient、OKHttp、RestTemplate,以RestTemplate调用为例。
1.接口调用方RestTemplate添加拦截器即可。
2.第三方服务需要添加拦截器其他HttpClient、OKHttp的实现方式与RestTemplate基本相同,这里就不一一列举。 Spring boot +logback+MDC实现全链路跟踪内容已经讲完了
到此这篇关于利用Spring boot+LogBack+MDC实现链路追踪的文章就介绍到这了,更多相关Spring boot 链路追踪内容请搜索七叶笔记以前的文章或继续浏览下面的相关文章希望大家以后多多支持七叶笔记!