Springboot 集成log4j2配置

1. 引入log4j2依賴:

注意點:

(1). springboot默認是logback日志框架, 需要先排除spring-boot-starter-logging包, 否則會引起jar包沖突

(2). 如果要配置log4j2異步日志, 需要添加disruptor依賴

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <!--springboot默認是logback日志框架, 需先排除此依賴, 否則會和log4j2產生jar包沖突-->
            <!--但是這種排除方式不一定有效，因為可能別的依賴包里也集成了默認的日志，這樣的話項目啟動依舊會報沖突-->
            <!--<exclusions>
                <exclusion>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-starter-logging</artifactId>
                </exclusion>
            </exclusions>-->
        </dependency>

        <!-- 全局排除spring-boot-starter-logging相關所有依賴 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
            <exclusions>
                <exclusion>
                    <groupId>*</groupId>
                    <artifactId>*</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

        <!-- 引入log4j2依賴 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-log4j2</artifactId>
        </dependency>
        <!-- 使用log4j2的Async配置需要引入disruptor包 -->
        <dependency>
            <groupId>com.lmax</groupId>
            <artifactId>disruptor</artifactId>
        </dependency>

2. applicaton.yml配置:

指定log4j2.xml配置文件位置, 這里通過指定不同文件來區分不同的環境(開發,測試,生產)

logging:
  config: classpath:log4j2.xml

3. log4j2.xml詳細配置:

以下為同步日志配置:

<?xml version="1.0" encoding="UTF-8" ?>
<!--Configuration后面的status，這個用於設置log4j2自身內部的信息輸出，可以不設置，當設置成trace時，你會看到log4j2內部各種詳細輸出-->
<!--monitorInterval：Log4j能夠自動檢測修改配置文件和重新配置本身(無需重啟,熱更新)，設置間隔秒數-->
<Configuration status="WARN" monitorInterval="1800">
    <!--日志級別以及優先級排序: ALL < TRACE < DEBUG < INFO < WARN < ERROR < FATAL < OFF -->

    <!--變量配置-->
    <Properties>
        <!--應用名稱-->
        <property name="APP_NAME">sky-hello</property>
        <!--日志存放路徑-->
        <property name="LOG_PATH">./logs/${APP_NAME}</property>
        <!--日志備份路徑-->
        <property name="LOG_BACKUP_PATH">${LOG_PATH}/backup</property>
        <!--日志輸出格式-控制台-->
        <property name="PATTERN_CONSOLE">%d{yyyy-MM-dd HH:mm:ss.SSS} | %blue{%traceId} | %highlight{%-5p} | %magenta{${sys:PID}} | %yellow{%t} | %cyan{%l} : %msg%n</property>
        <!--日志輸出格式-文件-->
        <property name="PATTERN_FILE">%d{yyyy-MM-dd HH:mm:ss.SSS} | %traceId | %-5p | ${sys:PID} | %t | %l : %msg%n</property>
    </Properties>

    <!--定義日志輸出目的地，內容和格式等-->
    <Appenders>
        <!--控制台-->
        <Console name="Console" target="SYSTEM_OUT">
            <!--輸出日志的格式:
                1.不設置默認為: %m%n
                2.disableAnsi="false" noConsoleNoAnsi="false" 配置開啟支持%highlight彩色日志
            -->
            <PatternLayout pattern="${PATTERN_CONSOLE}" disableAnsi="false" noConsoleNoAnsi="false"/>
            <!--只輸出level及其以上級別的信息（onMatch），其他的直接拒絕（onMismatch）-->
            <ThresholdFilter level="DEBUG" onMatch="ACCEPT" onMismatch="DENY"/>
        </Console>

        <!--可歸檔文件
            1. fileName: 日志存儲路徑
            2. filePattern: 歷史日志封存路徑。其中%d{yyyy-MM-dd}表示了日志的時間單位是天,log4j2自動識別zip等后綴，表示歷史日志需要壓縮
        -->
        <RollingFile name="RollingFile" fileName="${LOG_PATH}/${APP_NAME}.log" filePattern="${LOG_BACKUP_PATH}/$${date:yyyy-MM}/${APP_NAME}-%d{yyyy-MM-dd}_%i.log.zip">
            <!--輸出日志的格式, 不設置默認為:%m%n-->
            <PatternLayout pattern="${PATTERN_FILE}"/>
            <!--只輸出level及以上級別的信息（onMatch），其他的直接拒絕（onMismatch）-->
            <ThresholdFilter level="DEBUG" onMatch="ACCEPT" onMismatch="DENY"/>
            <!--歸檔設置-->
            <Policies>
                <!--按時間間隔歸檔:
                    1. interval=時間間隔, 單位由filePattern的%d日期格式指定, 此處配置代表每一天歸檔一次
                    2. modulate="true" 是否對interval取模，決定了下一次觸發的時間點
                -->
                <TimeBasedTriggeringPolicy interval="1" modulate="true" />
                <!-- 按照日志文件的大小: size表示當前日志文件的最大size，支持單位：KB/MB/GB-->
                <SizeBasedTriggeringPolicy size="50MB"/>
            </Policies>
            <!-- 歷史日志配置: 該屬性如不設置，則默認為最多同一文件夾下7個文件開始覆蓋-->
            <DefaultRolloverStrategy max="30"/>
        </RollingFile>

        <!--錯誤信息單獨歸檔-->
        <RollingFile name="RollingFileError" fileName="${LOG_PATH}/${APP_NAME}-error.log" filePattern="${LOG_BACKUP_PATH}/$${date:yyyy-MM}/${APP_NAME}-error-%d{yyyy-MM-dd}_%i.log.zip">
            <PatternLayout pattern="${PATTERN_FILE}"/>
            <ThresholdFilter level="ERROR" onMatch="ACCEPT" onMismatch="DENY"/>
            <Policies>
                <TimeBasedTriggeringPolicy/>
                <SizeBasedTriggeringPolicy size="50MB"/>
            </Policies>
        </RollingFile>
    </Appenders>


    <!--Loggers配置-->
    <Loggers>

        <!--
        注意點:
        1. logger節點用來單獨指定日志的形式，比如要為指定包下的class指定不同的日志級別等:
           (1). name: 用來指定該logger所適用的類或者類所在的包全路徑,繼承自Root節點.
           (2). AppenderRef：關聯的Appender, 只有定義了logger並引入的appender，appender才會生效
           (3). additivity: logEvent的傳遞性。true LogEvent處理后傳遞給父Logger打印。false LogEvent處理后不再向上傳遞給父Logger(解決日志重復輸出問題)
           (4). logger配置的level必須高於或等於Appenders中ThresholdFilter配置的過濾level, 否則會造成信息丟失
        2. root配置日志的根節點
        -->

        <!-- 同步日志配置-->
        <logger name="com.sky.hello.mapper" level="debug" additivity="false">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="RollingFile"/>
            <AppenderRef ref="RollingFileError"/>
        </logger>

        <root level="info">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="RollingFile"/>
            <AppenderRef ref="RollingFileError"/>
        </root>

    </Loggers>

</Configuration>

4. log4j2異步配置

小伙伴看到這里可能要問: 作為log4j2最炸裂的賣點(號稱性能翻倍)的異步日志呢? 咋配置呢?

哈哈,不要急,這里樓主整理了2種配置方式:

(1).  全局配置異步

①. 修改參數:

JVM參數方式:

JVM啟動參數（boot.ini）加上“-DLog4jContextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector”

System參數方式

@SpringBootApplication
public class SkyHelloApplication {

    public static void main(String[] args) {
        /**
         *  log4j2異步日志全局配置，減小輸出日志對性能的影響
         */
        System.setProperty("Log4jContextSelector", "org.apache.logging.log4j.core.async.AsyncLoggerContextSelector");

        SpringApplication.run(SkyHelloApplication.class, args);
    }
}

上述兩種修改參數方式, 任選一種即可

②.  修改log4j2.xml配置中的Loggers節點如下:

增加 includeLocation="true" 屬性, 否則日志不會輸出%l相關詳細信息

    <Loggers>
        <logger name="com.sky.hello.mapper" level="debug" additivity="false" includeLocation="true">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="RollingFile"/>
            <AppenderRef ref="RollingFileError"/>
        </logger>

        <root level="info" includeLocation="true">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="RollingFile"/>
            <AppenderRef ref="RollingFileError"/>
        </root>
    </Loggers>

(2). 指定局部Logger節點配置異步

log4j2.xml配置文件中使用AsyncRoot/AsyncLogger替代Root/Logger

    <Loggers>
        <!-- 異步日志配置:
             includeLocation: true表示輸出logger相關行號信息
        -->
        <AsyncLogger name="com.sky.hello.mapper" level="debug" additivity="false" includeLocation="true">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="RollingFile"/>
            <AppenderRef ref="RollingFileError"/>
        </AsyncLogger>

        <AsyncRoot level="info" includeLocation="true">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="RollingFile" />
            <AppenderRef ref="RollingFileError"/>
        </AsyncRoot>
    </Loggers>

上述2種方式任選其一即可，不要同時采用

如果異步日志配置成功, 程序啟動后, 可在idea中查看到log4j2生成的異步日志輸出線程:

5. 代碼測試:

這里模擬一個啟動類做一些日志輸出

@Component
public class StartHandler implements ApplicationRunner {

    private static final Logger LOG = LoggerFactory.getLogger(StartHandler.class);

    @Resource
    private HelloMapper helloMapper;

    @Override
    public void run(ApplicationArguments args) throws Exception {
        helloMapper.selectList(null);
        LOG.debug("我是 debug...");
        LOG.info("我是 info...");
        LOG.warn("我是 warn...");
        LOG.error("我是 error...");
    }
}

控制台輸出: