快捷導(dǎo)航

SpringBoot+slf4j實現(xiàn)全鏈路調(diào)用日志跟蹤的方法(一)

更新時間：2021年05月13日 09:26:19 作者：kevin_ying

本文重點給大家介紹Tracer集成的slf4j MDC功能，方便用戶在只簡單修改日志配置文件的前提下輸出當前 Tracer 上下文 TraceId，文章通過代碼給大家講解了在springboot中使用的技巧，感興趣的朋友跟隨小編一起看看吧

SpringBoot中除了常見的分布式鏈路跟蹤系統(tǒng)zipkin、skywalking等，如果需要快速定位一次請求的所有日志，那么該如何實現(xiàn)？實際slf4j提供了MDC（Mapped Diagnostic Contexts）功能，支持用戶定義和修改日志的輸出格式以及內(nèi)容。本文將介紹 Tracer集成的slf4j MDC功能，方便用戶在只簡單修改日志配置文件的前提下輸出當前 Tracer 上下文 TraceId。

MDC介紹

MDC（Mapped Diagnostic Context，映射調(diào)試上下文）是 log4j 、logback及l(fā)og4j2 提供的一種方便在多線程條件下記錄日志的功能。MDC 可以看成是一個與當前線程綁定的哈希表，可以往其中添加鍵值對。MDC 中包含的內(nèi)容可以被同一線程中執(zhí)行的代碼所訪問。當前線程的子線程會繼承其父線程中的 MDC 的內(nèi)容。當需要記錄日志時，只需要從 MDC 中獲取所需的信息即可。MDC 的內(nèi)容則由程序在適當?shù)臅r候保存進去。對于一個 Web 應(yīng)用來說，通常是在請求被處理的最開始保存這些數(shù)據(jù)。

springboot中如何使用

添加攔截器

public class LogInterceptor implements HandlerInterceptor {

	@Override
	public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
			throws Exception {
		String tid = UUID.randomUUID().toString().replace("-", "");
		MDC.put(CloudConstant.MDC_TRACE, tid);
		return true;
	}

	@Override
	public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler,
			@Nullable Exception ex) throws Exception {
		MDC.remove(CloudConstant.MDC_TRACE);
	}

}

注冊攔截器

@Configuration
public class WebInterceptorAdapter implements WebMvcConfigurer {
	@Bean
	public LogInterceptor logInterceptor() {
		return new LogInterceptor();
	}

	@Override
	public void addInterceptors(InterceptorRegistry registry) {
		registry.addInterceptor(logInterceptor());
	}
}

修改日志輸出格式，添加%X{traceId}，traceId和MDC中的鍵名稱一致

<pattern>%date %-5level ${PID:- } [%thread] [%X{tid}] : /*[%logger{50}:%line] %msg*/%n</pattern>

添加一個controller調(diào)用測試

@RestController
@RequestMapping("trace")
@Slf4j
public class TestTraceController {

    @GetMapping("traceLog")
    public String traceLog() {
        log.info("---接口調(diào)用了---");
        traceService();
        return "success";
    }

    private void traceService(){
        log.error("## 執(zhí)行traceService方法");
    }
}

日志打印如下，我們可以通過traceId快速查找出同一個請求的所有日志

細心的同學(xué)就會發(fā)現(xiàn)，MDC還是存在一些問題

在子線程中打印日志丟失traceId
HTTP調(diào)用丟失traceId

在下一篇文章中小編繼續(xù)講解子線程中如何實現(xiàn)traceId的日志跟蹤

到此這篇關(guān)于SpringBoot+slf4j實現(xiàn)全鏈路調(diào)用日志跟蹤一的文章就介紹到這了,更多相關(guān)SpringBoot全鏈路調(diào)用日志跟蹤內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: