如何使用@Slf4j和logback-spring.xml搭建日志框架

更新時(shí)間：2024年06月14日 08:43:01 作者：Cz范特西

這篇文章主要介紹了如何使用@Slf4j和logback-spring.xml搭建日志框架問題,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教

前言

對(duì)于一名Java后端開發(fā)工程師，查詢?nèi)罩臼墙?jīng)常做的事情。

因此，如果能構(gòu)建一個(gè)合適的日志框架，就能讓我們?cè)诓榭慈罩九挪殄e(cuò)誤的時(shí)候，能夠很快地找出問題所在。

配置logback.xml，可以讓idea的控制臺(tái)輸出我們想要的信息，比如時(shí)間、線程、端口、pid等等，還能配置不同信息不同顏色輸出在控制臺(tái)上，方便我們查看日志。

1、在yml配置文件中輸入文件輸出路徑

此配置是logback.xml讀取yml配置文件中的路徑，使得文件能夠輸出到我們想要的地方。

在配置文件中配置是因?yàn)槿绻闶褂肁pollo這種可以熱發(fā)布的配置中心，可以動(dòng)態(tài)修改。

如果你輸出的地址不變，可以直接寫在logback.xml中。

log:
  path: ./logs/test-module/test-module-${server.port}

./表示當(dāng)前模塊的路徑
${server.port}表示yml配置的模塊端口

2、引入依賴

我一般使用的是@SLf4j作為日志輸出。

使用logback.xml，需要引入下面兩個(gè)依賴。

如果你使用的是springboot，那么springboot的starter會(huì)自帶這兩個(gè)依賴，不用再重復(fù)導(dǎo)入。

<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.2.11</version>
    <scope>test</scope>
</dependency>

<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-core</artifactId>
    <version>1.2.11</version>
</dependency>

3、在模塊的resource目錄下創(chuàng)建logback.xml

此份logback.xml，配置了控制臺(tái)的輸出日志，寫入文件的日志以及寫入錯(cuò)誤日志的配置。

<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false">

    <!-- 彩色日志 -->
    <!-- 彩色日志依賴的渲染類 -->
    <conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter"/>
    <conversionRule conversionWord="wEx" converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter"/>
    <!-- 彩色日志格式 {blue}表示前面的輸出日志的顏色是藍(lán)色 -->
    <property name="CONSOLE_LOG_PATTERN"
              value=" ${CONSOLE_LOG_PATTERN:-%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){blue} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>

    <!-- 獲取yml中的log地址 -->
    <springProperty scope="context" name="logPath" source="log.path"/>

    <!-- 控制臺(tái)彩色日志輸出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>${CONSOLE_LOG_PATTERN}</pattern>
            <charset>utf8</charset>
        </encoder>
    </appender>

    <!--由文件大小與時(shí)間控制滾動(dòng)-->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <!--日志文件輸出的文件名-->
            <FileNamePattern>${logPath}/%d{yyyy-MM-dd}/logs-%d{yyyy-MM-dd}-%i.log</FileNamePattern>
            <!--活動(dòng)文件大小-->
            <maxFileSize>20MB</maxFileSize>
            <!--回滾的總文件大小 eg:totalSizeCap/MaxFileSize 即只保存2個(gè)文件-->
            <totalSizeCap>2GB</totalSizeCap>
            <cleanHistoryOnStart>true</cleanHistoryOnStart>
            <!--最大的日志保存數(shù)量-->
            <!--<param name="MaxBackupIndex" value="10"/>-->
            <!--日志文件保留天數(shù)-->
            <MaxHistory>30</MaxHistory>
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <!--格式化輸出：%d表示日期。%-5level：日志級(jí)別，從左顯示5個(gè)字符寬度。%thread表示線程名，%c:表示日志所在類。%L：表示日志所在行數(shù)。 %msg：日志消息，%n是換行符-->
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%level] [%thread] [%c] %L - %msg%n</pattern>
            <charset>utf8</charset>
        </encoder>
    </appender>

    <!--異常日志-->
    <appender name="ERROR" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>ERROR</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <!--由文件大小與時(shí)間控制滾動(dòng)-->
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <FileNamePattern>${logPath}/%d{yyyy-MM-dd}/errors-%d{yyyy-MM-dd}-%i.log</FileNamePattern>
            <maxFileSize>5MB</maxFileSize>
            <!--回滾的總文件大小 eg:totalSizeCap/MaxFileSize 即只保存2個(gè)文件-->
            <totalSizeCap>1GB</totalSizeCap>
            <cleanHistoryOnStart>true</cleanHistoryOnStart>
            <!--最大的日志保存數(shù)量-->
            <!--<param name="MaxBackupIndex" value="10"/>-->
            <!--日志文件保留天數(shù)-->
            <MaxHistory>30</MaxHistory>
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%level] [%thread] [%c] %L - %msg%n</pattern>
            <charset>utf8</charset>
        </encoder>
    </appender>

        <!--
		logger 有兩種級(jí)別，一種是 root，一種是普通的 logger，logger 是用來設(shè)置某一個(gè)包或者具體的某一個(gè)類的日志打印機(jī)級(jí)別，以及制定的 appender。 
		logger 有三個(gè)屬性
		- name：用來指定此 logger 約束的某一個(gè)包或者具體的某一個(gè)類
		- level：用來設(shè)置打印機(jī)別，
		- addtivity：是否向上級(jí) logger 傳遞打印信息。默認(rèn)是 true
		每個(gè) logger 都有對(duì)應(yīng)的父級(jí)關(guān)系，它通過包名來決定父級(jí)關(guān)系，root 是最高級(jí)的父元素。
        -->
    <logger name="com.czf" level="INFO"/>
    <!-- 日志輸出級(jí)別 -->
    <root level="INFO">
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="FILE"/>
        <appender-ref ref="ERROR"/>
    </root>
</configuration>

注意

1、文件名需要為logback-spring.xml，如果是logback.xml的話，springboot會(huì)因?yàn)樽R(shí)別問題，會(huì)自動(dòng)創(chuàng)建一個(gè)logPath_IS_UNDEFINED的文件夾。

2、如果想在啟動(dòng)類中加上日志，注意需要加在run方法的后面，否則雖然會(huì)在控制臺(tái)輸出，但不會(huì)寫入到日志文件中。

public class PersonalCreditApplication {
    public static void main(String[] args) {
        SpringApplication.run(PersonalCreditApplication.class, args);
        log.info("項(xiàng)目啟動(dòng)");
    }

至此，一個(gè)項(xiàng)目或模塊的日志框架就搭建成功。

建議：多在代碼中寫日志，方便排查和后期維護(hù)。