輕量級的分布式日志追蹤利器，十分鐘即可接入，從此日志追蹤無難事

前言

隨著微服務盛行，很多公司都把系統按照業務邊界拆成了很多微服務，在排錯查日志的時候，因為業務鏈路貫穿著很多微服務節點，導致定位某個請求的日志以及上下游業務的日志會變得有些困難，

這時候很多童鞋會開始考慮上SkyWalking，Pinpoint等分布式追蹤系統來解決，基于OpenTracing規范，而且通常都是無侵入性的，并且有相對友好的管理界面來進行鏈路Span的查詢，

但是搭建分布式追蹤系統，熟悉以及推廣到全公司的系統需要一定的時間周期，而且當中涉及到鏈路span節點的存盤成本問題，全量采集還是部分采集？如果全量采集，就以SkyWalking的存盤來舉例，ES集群搭建至少需要5個節點，這就需要增加服務器成本，況且如果微服務節點多的話，一天下來產生幾十G上百G的資料其實非常正常，如果想保存時間長點的話，也需要增加服務器磁盤的成本，

所以這次介紹的開源專案是TLog，它的產生背景源于想做一個輕量級的日志追蹤解決方案，覆寫目前流行的日志框架和RPC框架，讓用戶以最少的成本來接入以解決微服務體系中日志跟蹤的痛點，

當然分布式追蹤系統是一個最終的解決方案，如果您的公司已經上了分布式追蹤系統，那TLog并不適用，

TLog提供了一種最簡單的方式來解決日志追蹤問題，它不收集日志，也不需要另外的存盤空間，它只是自動的對你的業務日志進行打標簽，自動生成TraceId貫穿你微服務的一整條鏈路，并且提供上下游節點資訊，適合中小型企業以及想快速解決日志追蹤問題的公司專案使用，

為此我為了TLog適配了三大日志框架，支持自動檢測適配，支持dubbo，dubbox，spring cloud三大RPC框架，更重要的是，你的專案接入TLog，可能連十分鐘就不需要 ：）

TLog專案以及特性

專案地址：https://gitee.com/bryan31/TLog

TLog具有以下特性：

• 通過對日志打標簽完成輕量級微服務日志追蹤
• 對業務代碼無侵入式設計，使用簡單，10分鐘即可接入
• 支持常見的log4j，log4j2，logback三大日志框架，并提供自動檢測，完成適配
• 支持dubbo，dubbox，springcloud三大RPC框架
• 支持日志標簽的自定義模板的配置
• 幾乎無性能損耗

如何快速接入

TLog支持了springboot的自動裝配，在springboot環境下，只需要以下兩步就可以接入！

依賴

<dependency>
  <groupId>com.yomahub</groupId>
  <artifactId>tlog-all-spring-boot-starter</artifactId>
  <version>1.0.0</version>
</dependency>

目前jar包已上傳中央倉庫，可以直接依賴到

日志框架適配

只需要在你的啟動類中加入一行代碼，即可以自動進行探測你專案所使用的Log框架，并進行增強，目前支持log4j，log4j2，logback三大日志框架，

@SpringBootApplication
public class Runner {

    static {AspectLogEnhance.enhance();}//進行日志增強，自動判斷日志框架

    public static void main(String[] args) {
        SpringApplication.run(Runner.class, args);
    }
}

需要注意的是，因為這里是用javassit實作，需要在jvm加載對應日志框架的類之前，進行位元組碼增強，所以這里用static塊，但是在以下2種情況下這種一行自動適配的可能不會生效：

1.Springboot/Spring的啟動類加入log定義，這種情況不會生效，因為classload在加載static塊之前已經把log日志框架加載了，

2.你是用tomcat/jboss/jetty等外置容器啟動的（對于springboot內置容器無影響）

對于這2種情況，TLog也提供了3大日志框架的單獨適配，只要替換日志組態檔中的相應layout類就可以了，下文也會介紹到

RPC框架的適配

在Springboot環境下，TLog會自動探測你用的RPC框架，自動進行適配，

做完以上2步，就ok了，最終效果如下（這里以dubbo+log4j為例）：

Consumer端代碼：

日志列印：

2020-09-16 18:12:56,748 [WARN] [TLOG]重新生成traceId[7161457983341056]  >> com.yomahub.tlog.web.TLogWebInterceptor:39
2020-09-16 18:12:56,763 [INFO] <7161457983341056> logback-dubbox-consumer:invoke method sayHello,name=jack  >> com.yomahub.tlog.example.dubbox.controller.DemoController:22
2020-09-16 18:12:56,763 [INFO] <7161457983341056> 測驗日志aaaa  >> com.yomahub.tlog.example.dubbox.controller.DemoController:23
2020-09-16 18:12:56,763 [INFO] <7161457983341056> 測驗日志bbbb  >> com.yomahub.tlog.example.dubbox.controller.DemoController:24

Provider代碼：

日志列印：

2020-09-16 18:12:56,854 [INFO] <7161457983341056> logback-dubbox-provider:invoke method sayHello,name=jack  >> com.yomahub.tlog.example.dubbo.service.impl.DemoServiceImpl:15
2020-09-16 18:12:56,854 [INFO] <7161457983341056> 測驗日志cccc  >> com.yomahub.tlog.example.dubbo.service.impl.DemoServiceImpl:16
2020-09-16 18:12:56,854 [INFO] <7161457983341056> 測驗日志dddd  >> com.yomahub.tlog.example.dubbo.service.impl.DemoServiceImpl:17

可以看到，經過簡單接入后，各個微服務之間每個請求有一個全域唯一的traceId貫穿其中，對所有的日志輸出都能生效，這下定位某個請求的日志鏈就變得輕松了，

改變日志標簽的格式

TLog允許用戶自定義日志標簽的格式，TLog默認只打出traceId，以<$traceId>這種模板打出，當然你能自定義其模板，還能加入其它的標簽頭

你只需要在springboot的application.properties里如下定義，改變標簽的格式，就能按照你定義模板進行列印

tlog.pattern=[$preApp][$preIp][$traceId]

$preApp ：上游微服務節點名稱

$preIp：上游微服務的IP地址

$traceId：全域唯一跟蹤ID

Log框架的單獨適配

如果你的自動化日志探測失效或者你用的是外置容器，你需要針對你專案中的日志框架配置進行修改，修改方法也很簡單，

Log4j組態檔增強

只需要把layout的實作類換掉就可以了

每個公司的Log4J的模板大同小異，這里只給出xml的例子

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration>
    <appender name="stdout" class="org.apache.log4j.ConsoleAppender">
        <!--替換成AspectLog4jPatternLayout-->
        <layout class="com.yomahub.tlog.core.enhance.log4j.AspectLog4jPatternLayout">
            <param name="ConversionPattern" value=https://www.cnblogs.com/bryan31/p/"%d{yyyy-MM-dd HH:mm:ss,SSS} [%p] %m  >> %c:%L%n"/>
        
    
    
        
        
        
            
        
    
    
        
        
        
    

Logback的組態檔增強

換掉encoder的實作類或者換掉layout的實作類就可以了

以下給出xml示例：

<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false">
    <property name="APP_NAME" value=https://www.cnblogs.com/bryan31/p/"logtest"/>
    
    
        
		
			  %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n
		
    
    
        ${LOG_HOME}/${APP_NAME}.log
        
            ${LOG_HOME}/${APP_NAME}.log.%d{yyyy-MM-dd}.%i.log
            30
            1000MB
        
        
        
            %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n
        
    

    
    
        
        
    

Log4j2的組態檔增強

log4J2由于是通過插件形式實作的，log4J2有自動掃描插件的功能，所以無需對組態檔做任何更改就能生效，

后語

TLog本質上是一個日志框架，只不過具有了支持RPC框架的日志追蹤功能，寫框架大概肝了我一周的時間，力求做到一個最輕量級的日志追蹤解決方案，讓使用者能以最少的成本接入，TLog不光支持springboot，對非springboot專案也進行了支持，具體配置方法請到專案主頁查看檔案，

我還為TLog寫了詳細的示例專案，涵蓋了所涉及幾乎所有場景，具體示例專案地址也在專案主頁，

如果你在專案中也碰到日志追蹤困難的場景，不妨來試試TLog吧，希望這款開源框架能幫助到你，開源不易，如你喜歡，請幫忙star，你的支持是我前進的最大動力，如你碰到任何疑問，也歡迎聯系我，

關注作者

「元人部落」是一個堅持做原創的技術科技分享號，希望你能關注我，我每周會出一篇實用的原創技術文章，陪著你一起走，陪你一起成長，關注公眾號回復tlog能加入群聊，我會耐心回答你的每一個使用中的問題，也會長期對這個專案進行長期維護和迭代，

標籤：Java

上一篇：準備基本情報技術者試驗的童鞋有嗎？

下一篇：架構設計 | 分布式體系下，服務分層監控策略