Springboot-MDC+logback实现日志追踪

一、MDC介绍

        MDC（Mapped Diagnostic Contexts）映射诊断上下文，该特征是logback提供的一种方便在多线程条件下的记录日志的功能。
        某些应用程序采用多线程的方式来处理多个用户的请求。在一个用户的使用过程中，可能有多个不同的线程来进行处理。典型的例子是 Web 应用服务器。当用户访问某个页面时，应用服务器可能会创建一个新的线程来处理该请求，也可能从线程池中复用已有的线程。在一个用户的会话存续期间，可能有多个线程处理过该用户的请求。这使得比较难以区分不同用户所对应的日志。当需要追踪某个用户在系统中的相关日志记录时，就会变得很麻烦。
        MDC正是用于解决上述问题的，MDC 可以看成是一个与当前线程绑定的哈希表，可以往其中添加键值对。MDC 中包含的内容可以被同一线程中执行的代码所访问。当前线程的子线程会继承其父线程中的 MDC 的内容。当需要记录日志时，只需要从 MDC 中获取所需的信息即可。MDC 的内容则由程序在适当的时候保存进去。对于一个 Web 应用来说，通常是在请求被处理的最开始保存这些数据。

二、MDC实现日志跟踪

        一个系统提供服务，提供给其他系统来调用，当其他系统调用的时候，请求头带上唯一的请求标识(requestId)，把这个requestId输出到日志中，这样两个系统直接就会形成一个执行链，用requestId串联起来，当出现错误时，可以在调用方查询对应的请求日志，也可以在服务方查询请求日志，定位问题很方便，输出日志的地方很多。可以使用MDC配合logback中的pattern。

三、HandlerInterceptor拦截器

相关介绍：

SpringBoot使用过滤器、拦截器、切面(AOP)，及其之间的区别和执行顺序 - 劈天造陆 - 博客园
HandlerInterceptor_dekulugu的博客-CSDN博客_handlerinterceptor

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.slf4j.MDC;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@Component
public class TokenInterceptor implements HandlerInterceptor {
    private static final Logger logger = LoggerFactory.getLogger(TokenInterceptor.class);

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        //添加MDC日志
        String appkey = request.getHeader("appkey");
        MDC.put("logTrackId", appkey);
        return true;
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        //移除MDC日志
        MDC.remove("logTrackId");
    }

}

四、logback文件

    
    
    
    
    

    
        
            %d{yyyy-MM-dd HH:mm:ss} %-4relative [%thread] [%X{logTrackId}] %-5level %logger{35} - %msg %n
        
    

    
        
        
            logTrackId
            default
        
        
            
            
                
                true
                
                    %d{yyyy-MM-dd HH:mm:ss} %-4relative [%thread] [%X{logTrackId}] %-5level %logger{35} - %msg%n
                
                
                    
                    ${logPath}/%d{yyyy-MM-dd}/${logTrackId}-%i.log
                    ${maxHistory}
                    ${maxFileSize}
                    ${totalSizeCap}
                
                
                    INFO
                
            
        
    

    
    
        
        0
        
        512
        
        
    

    
        
        
    

相关学习链接：

logback新认识(二)：logback之MDC日志跟踪、日志自定义效果_IT-CRUD-CSDN博客

【日志追踪】（微服务应用和单体应用）-logback中的MDC机制 - 听风是雨 - 博客园