1 引入 log4j2

首先打开 pom.xml ，然后排除掉 Spring Boot 2 所默认使用的日志组件 log-back，接着引入 log4j2：

<!--log4j2-->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>

2 配置 log4j2

在工程目录的 resources/ 下，新建 log4j2.xml（如果取名为 log4j2-spring.xml，单元测试时会找不到 log4j2 配置）：

log4j2 的日志级别以及优先级排序为： OFF > FATAL > ERROR > WARN > INFO > DEBUG > TRACE > ALL。

2.1 配置 Configuration

配置时会首先使用 Configuration 标签，它有以下这些常用属性：

2.2 Properties

然后使用 Properties 标签，定义好常量。形如：

<Property name="LOG_PATH">xxx</Property>

定义好后，就可以在后续的 pattern 中这样引用 ${LOG_PATH}。

3 pattern 说明

pattern 用于定义输出日志的格式。

3.1 时间格式

时间的一般格式为 d{pattern}，d 是英文单词 date 的缩写，具体说明如下。

3.2 日志等级格式

日志等级格式为 %p{level=label, level=label, ...}。
如果直接 %p，则会输出等级默认文本，形如：WARN、DEBUG、ERROR、TRACE 或 INFO。

我们可以对这些等级重命名：

%p{WARN=Warning, DEBUG=Debug, ERROR=Error, TRACE=Trace, INFO=Info}

也可以将原本输出文本的默认大写形式转化为小写：

%level{lowerCase=true}

3.3 彩色日志

彩色日志格式定义语法为 %clr{}[颜色]。比如：

%clr{[%15.15t]}{yellow}

image.png

3.4 日志名输出格式

3.5 对齐格式

常用模式总结如下：

更多详情可以参考 http://logging.apache.org/log4j/2.x/manual/layouts.html

4 appenders

appenders 负责把日志输出到相应的目的地。

4.1 控制台

设置日志输出到控制台的格式：

        <Console name="Console">
            <PatternLayout pattern="${CONSOLE_LOG_PATTERN}"/>
        </Console>

4.2 日志文件

设置日志输出到文件的文件名、格式、输出等级、日志大小等信息：

<RollingFile name="RollingFileInfo" fileName="${LOG_PATH}/info.log"
                     filePattern="${LOG_PATH}/$${date:yyyy-MM}/info-%d{yyyy-MM-dd-HH}-%i.log.gz">
            <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="${FILE_LOG_PATTERN}"/>
            <Policies>
                <TimeBasedTriggeringPolicy/>
                <SizeBasedTriggeringPolicy size="100 MB"/>
            </Policies>
        </RollingFile>

5 配置实例

以下是 log4j2 配置实例，以供参考：

<?xml version="1.0" encoding="UTF-8"?>
<!--
配置日志组件
@author Deniro Lee
-->
<Configuration name="xxx_log_config" status="WARN" monitorInterval="60">

    <Properties>
        <!--日志根目录路径-->
        <Property name="LOG_PATH">./../xxxWorkflowLogs</Property>
        <!--日志等级格式-->
        <Property name="LOG_LEVEL_PATTERN">%7p{WARN=Warning, DEBUG=Debug, ERROR=Error, TRACE=Trace, INFO=Info} ->>>
        </Property>
        <!--控制台输出格式-->
        <Property name="CONSOLE_LOG_PATTERN">%clr{%d{ABSOLUTE}} %clr{${LOG_LEVEL_PATTERN}}
            %clr{${sys:PID}}{magenta} %clr{---} %clr{[%-15.15t]}{yellow} %clr{%-40.40c}{blue} %clr{:}{blue}
            %m%n
        </Property>
        <!--日志文件输出格式-->
        <Property name="FILE_LOG_PATTERN">[%d{yyyy-MM-dd HH:mm:ss:SSS}] [%p] - %l -> %m%n</Property>
    </Properties>

    <appenders>
        <!--控制台-->
        <Console name="Console">
            <PatternLayout pattern="${CONSOLE_LOG_PATTERN}"/>
        </Console>

        <!--INFO 级别及以上日志-->
        <RollingFile name="RollingFileInfo" fileName="${LOG_PATH}/info.log"
                     filePattern="${LOG_PATH}/$${date:yyyy-MM}/info-%d{yyyy-MM-dd-HH}-%i.log.gz">
            <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="${FILE_LOG_PATTERN}"/>
            <Policies>
                <TimeBasedTriggeringPolicy/>
                <SizeBasedTriggeringPolicy size="100 MB"/>
            </Policies>
            <DefaultRolloverStrategy max="100"/>
        </RollingFile>

        <!--WARN 级别及以上日志-->
        <RollingFile name="RollingFileWarn" fileName="${LOG_PATH}/warn.log"
                     filePattern="${LOG_PATH}/$${date:yyyy-MM}/warn-%d{yyyy-MM-dd-HH}-%i.log.gz">
            <ThresholdFilter level="warn" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="${FILE_LOG_PATTERN}"/>
            <Policies>
                <TimeBasedTriggeringPolicy/>
                <SizeBasedTriggeringPolicy size="100 MB"/>
            </Policies>
            <DefaultRolloverStrategy max="100"/>
        </RollingFile>
        <!--ERROR 级别及以上日志-->
        <RollingFile name="RollingFileError" fileName="${LOG_PATH}/error.log"
                     filePattern="${LOG_PATH}/$${date:yyyy-MM}/error-%d{yyyy-MM-dd-HH}-%i.log.gz">
            <ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="${FILE_LOG_PATTERN}"/>
            <Policies>
                <TimeBasedTriggeringPolicy/>
                <SizeBasedTriggeringPolicy size="100 MB"/>
            </Policies>
            <DefaultRolloverStrategy max="100"/>
        </RollingFile>
    </appenders>

    <loggers>
        <root level="info">
            <appender-ref ref="Console"/>
            <appender-ref ref="RollingFileInfo"/>
            <appender-ref ref="RollingFileWarn"/>
            <appender-ref ref="RollingFileError"/>
        </root>
    </loggers>

</Configuration>

工程日志放置在 tomcat 根目录下的名为 xxxLogs 文件夹中。

日志级别以及优先级排序为：FATAL > ERROR > WARN > INFO > DEBUG > TRACE。日志文件分为 info.log、warn.log以及 error.log，三种类型。每种日志文件，会记录相应等级及以上的日志内容。比如 error.log 会记录 ERROR 与 FATAL 类型的数据。

当日志文件大于 100M 时，会自动归档。

归档格式为：/$${date:yyyy-MM}/[日志等级]-%d{yyyy-MM-dd-HH}-%i.log.gz，表示放入归档时的年月文件夹，然后把日志压缩后放入带年月日小时与序号的 gz 包中。