Log4j2日志配置

一、Log4j2 Maven配置

Log4j2的性能高於log4j與logback，在項目中建議使用Log4j2，其依賴如下(目前最新版本為2.6.2)：

 <dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-api</artifactId>
    <version>2.6.2</version>
</dependency>
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>2.6.2</version>
</dependency>

 

二、log4j2.xml文件配置

log4j2.xml的配置文件放在classpath下就會被自動加載，其配置如下：

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

<!--
    status : 這個用於設置log4j2自身內部的信息輸出,可以不設置,當設置成trace時,會看到log4j2內部各種詳細輸出
    monitorInterval : Log4j能夠自動檢測修改配置文件和重新配置本身, 設置間隔秒數。
-->
<Configuration status="WARN" monitorInterval="600">

    <Properties>
        <!-- 配置日志文件輸出目錄 -->
        <Property name="LOG_HOME">/Users/hanhan.zhang/logs</Property>
    </Properties>

    <Appenders>

        <!--這個輸出控制台的配置-->
        <Console name="Console" target="SYSTEM_OUT">
            <!-- 控制台只輸出level及以上級別的信息(onMatch),其他的直接拒絕(onMismatch) -->
            <ThresholdFilter level="trace" onMatch="ACCEPT" onMismatch="DENY"/>
            <!-- 輸出日志的格式 -->
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/>
        </Console>

        <!-- 設置日志格式並配置日志壓縮格式(service.log.年份.gz) -->
        <RollingRandomAccessFile name="service_appender"
                                 immediateFlush="false" fileName="${LOG_HOME}/service.log"
                                 filePattern="${LOG_HOME}/service.log.%d{yyyy-MM-dd}.log.gz">
            <!--
                %d{yyyy-MM-dd HH:mm:ss, SSS} : 日志生產時間
                %p : 日志輸出格式
                %c : logger的名稱
                %m : 日志內容，即 logger.info("message")
                %n : 換行符
                %C : Java類名
                %L : 日志輸出所在行數
                %M : 日志輸出所在方法名
                hostName : 本地機器名
                hostAddress : 本地ip地址
             -->
            <PatternLayout>
                <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level %class{36} %L %M -- %msg%xEx%n</pattern>
            </PatternLayout>
            <Policies>
                <TimeBasedTriggeringPolicy interval="1" modulate="true" />
            </Policies>
        </RollingRandomAccessFile>


        <!-- DEBUG日志格式 -->
        <RollingRandomAccessFile name="service_debug_appender"
                                 immediateFlush="false" fileName="${LOG_HOME}/service.log"
                                 filePattern="${LOG_HOME}/service.log.%d{yyyy-MM-dd}.debug.gz">
            <PatternLayout>
                <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level %class{36} %L %M -- %msg%xEx%n</pattern>
            </PatternLayout>
            <Policies>
                <TimeBasedTriggeringPolicy interval="1" modulate="true" />
            </Policies>
        </RollingRandomAccessFile>
    </Appenders>

    <Loggers>
        <!-- 配置日志的根節點 -->
        <root level="debug">
            <appender-ref ref="Console"/>
        </root>

        <!-- 第三方日志系統 -->
        <logger name="org.springframework.core" level="info"/>
        <logger name="org.springframework.beans" level="info"/>
        <logger name="org.springframework.context" level="info"/>
        <logger name="org.springframework.web" level="info"/>
        <logger name="org.jboss.netty" level="warn"/>
        <logger name="org.apache.http" level="warn"/>

        <!-- 日志實例(info),其中'service-log'繼承root,但是root將日志輸出控制台,而'service-log'將日志輸出到文件,通過屬性'additivity="false"'將'service-log'的
             的日志不再輸出到控制台 -->
        <logger name="service_log" level="info" includeLocation="true" additivity="true">
            <appender-ref ref="service_appender"/>
        </logger>

        <!-- 日志實例(debug) -->
        <logger name="service_log" level="debug" includeLocation="true" additivity="false">
            <appender-ref ref="service_debug_appender"/>
        </logger>

    </Loggers>

</Configuration>

在配置文件中：

1、根節點configuration下有兩個子節點：appenders和loggers(可定義多個appender和logger了)

2、appenders：定義輸出，如定義的Console，是將日志輸出到控制台，並對輸出設置屬性(通過PatternLayout設置輸出格式)

3、loggers：定義多個logger，且logger通過name進行區分，對不同的logger配置不同的輸出可appender-ref引用配置的appender的name

4、logger name機制

logger name類似於java package一樣，比如有個包：cn.lsw.base.log4j2，而且生成Logger對象的時候通常通過Hello.class.getName()匹配定義的logger name，這是因為Logger也有繼承關系。比如給cn.lsw.base定義了一個logger，那么它也適用於cn.lsw.base.lgo4j2這個logger。名稱的繼承是通過點“.”分隔的。此外，在上面的loggers配置中有子節點不是logger而是root，而且這個root沒有name屬性。這個root相當於根節點，所有的logger都適用與這個logger，所以即使在很多類里面通過類名.class.getName()得到很多的logger，而且沒有在配置文件的loggers下面做配置也都能夠輸出，因為都繼承了root的配置

三、log4j2與slf4j集成

log4j與slf4j集成還需添加另外的兩個Maven Jar包依賴，配置如下：

 

<dependency>
                <groupId>org.slf4j</groupId>
                <artifactId>slf4j-api</artifactId>
                <version>1.7.21</version>
            </dependency>
            <dependency>
                <groupId>org.apache.logging.log4j</groupId>
                <artifactId>log4j-api</artifactId>
                <version>2.6.2</version>
            </dependency>
            <dependency>
                <groupId>org.apache.logging.log4j</groupId>
                <artifactId>log4j-core</artifactId>
                <version>2.6.2</version>
            </dependency>
            <!-- log4j-slf4j-impl(用於log4j2與slf4j集成) -->
            <dependency>
                <groupId>org.apache.logging.log4j</groupId>
                <artifactId>log4j-slf4j-impl</artifactId>
                <version>2.6.2</version>
            </dependency>

 

獲取Logger對象方式：

// log4j2方式
private static final org.apache.logging.log4j.Logger LOG = org.apache.logging.log4j.LogManager.getLogger(Logstrap.class);

// slf4j方式
private static final org.slf4j.Logger LOG = org.slf4j.LoggerFactory.getLogger(LoggerFactory.class);