基于Slf4j的MDC實現(xiàn)日志鏈路串聯(lián)

一、問題背景

為了方便運維日常定位排查問題時，使用traceId查詢日志時可以完整的查看當前業(yè)務請求的完整日志鏈路
，需使用traceId（日志跟蹤號）將日志串聯(lián)起來。

系統(tǒng)采用LogBack日志組件 ，在輸出日志時輸出_traceId日志跟蹤號，logback.xml配置如下：

../log/${ ServerName}/${ AppName}.log../log/${ ServerName}/${ AppName}.log.%d{ yyyy-MM-dd}        7%d{ HH:mm:ss.SSS} %-5level [%.15thread][%X{ _traceId}] %logger{ 36} - %.-4096msg%n

公司系統(tǒng)采用分布式架構，從接收到請求到業(yè)務處理完成并返回，涉及SpringMVC入口 、服務間dubbo調用
、基于RocketMQ實現(xiàn)的業(yè)務解耦 、以及來自第三方渠道的http通知回調。

現(xiàn)在的問題是從業(yè)務請求入口到返回業(yè)務響應，如何使用同一traceId將日志做串聯(lián) ？

Slf4j的MDC機制提供了上述問題的解決方案 。

二 、解決方案

在介紹具體解決方案之前，首先介紹下Slf4j日志框架的MDC機制。映射診斷上下文（Mapped Diagnostic Context，簡稱MDC）可以簡單理解為當前日志線程的上下文，也是一個k-v格式的map結構。

當服務器幾乎同時處理多個請求時，日志輸出通常是交錯的，而MDC是基于每個線程進行管理的，子線程自動繼承其父線程的MDC的副本?？梢酝ㄟ^往MDC里塞入traceId，達到串聯(lián)日志的目的。

以下為MDC填充獲取traceId方法：

public final static String TRACE_ID = "_traceId";static private String generateTraceId() {     return UUID.randomUUID().toString().replaceAll("-", "");}public static String getTraceId() {     return MDC.get(TRACE_ID);}public static void setTraceId(String traceId) {     MDC.put(TRACE_ID, traceId);}public static void clearTrace() {     MDC.remove(TRACE_ID);}public static void initTrace() {     String traceId = generateTraceId();    setTraceId(traceId);}

2.1、接收http請求時的日志鏈路串聯(lián)

解決思路：可以從HttpServletRequest獲取traceId并塞到MDC中 。

具體如下 ：

public static void initTraceFromRequest(HttpServletRequest request) {     String traceId;    // 從前端表單提交里獲取traceId    traceId = request.getParameter(TRACE_ID);    if (StringUtils.isNotBlank(traceId)) {         setTraceId(traceId, request);        return;    }    // 從forward后端轉發(fā)請求里獲取traceId    traceId = (String) request.getAttribute(TRACE_ID);    if (StringUtils.isNotBlank(traceId)) {         setTraceId(traceId, request);        return;    }    // 從請求url路徑中里獲取traceId    Map pathVariables = (Map) request.getAttribute(HandlerMapping.URI_TEMPLATE_VARIABLES_ATTRIBUTE);    if (pathVariables != null) {         traceId = (String) pathVariables.get(TRACE_ID);    }    if (StringUtils.isNotBlank(traceId)) {         setTraceId(traceId, request);        return;    }    // 以上都獲取不到的話，就生成一個traceId并填充到MDC以及Session中    traceId = generateTraceId();    setTraceId(traceId, request);}

具體解決方案：使用SpringMVC攔截器機制攔截所有web請求 ，獲取并串聯(lián)traceId 。

public class LogTraceInterceptor extends HandlerInterceptorAdapter {     @Autowired    private ConfigBean configBean;    @Override    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {         if(handler instanceof HandlerMethod) {             TraceUtil.initTraceFrom(request);        }        return true;    }    @Override    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {     }}

實際測試時發(fā)現(xiàn)如下問題：

后臺controller間有redirect重定向或forward轉發(fā)跳轉時 ，跳轉前后的日志traceId沒有串聯(lián)上。

分析如下：

• 1、redirect重定向前后是兩個不同的request