SpringBoot2.0 基础案例(02)：配置Log4j2，实现不同环境日志打印

一、log4j2日志简介

日志打印是了解web项目运行的最直接方式，所以在项目开发中是需要首先搭建好的环境。

1、log4j2特点

1）核心特点
相比与其他的日志系统，log4j2丢数据这种情况少；disruptor技术，在多线程环境下，性能高；并发的特性，减少了死锁的发生。

2）性能测试

2、日志打印之外观模式

每一种日志框架都有自己单独的api，要使用对应的框架就要使用其对应的api，增加应用程序代码和日志框架的耦合性。
《阿里巴巴java开发手册》，其中有一条规范做了『强制』要求：

slf4j
java简易日志门面（simple logging facade for java，缩写slf4j），是一套包装logging 框架的界面程式，以外观模式实现。

二、配置日志打印

1、项目结构

2、不同环境的日志配置

使用最直接的方式，不同环境加载不同的日志配置。
1)开发环境配置

logging:
  config: classpath:log4j2-boot-dev.xml

2)生产环境配置

logging:
  config: classpath:log4j2-boot-pro.xml

3、log4j2的配置文件

<?xml version="1.0" encoding="utf-8"?>
<!--monitorinterval：log4j2 自动检测修改配置文件和重新配置本身，设置间隔秒数-->
<configuration monitorinterval="5">
    <!--日志级别以及优先级排序: off > fatal > error > warn > info > debug > trace > all -->
    <!--变量配置-->
    <properties>
        <!-- 格式化输出：
            %date表示日期，%thread表示线程名，
            %-5level：级别从左显示5个字符宽度
            %msg：日志消息，%n是换行符-->
        <!-- %logger{36} 表示 logger 名字最长36个字符 -->
        <property name="log_pattern" value="%date{hh:mm:ss.sss} [%thread] %-5level %logger{36} - %msg%n" />
        <!-- 定义日志存储的路径，不要配置相对路径 -->
        <property name="file_path" value="e:/logs/dev" />
        <property name="file_name" value="boot-log4j2" />
    </properties>

    <appenders>
        <console name="console" target="system_out">
            <!--输出日志的格式-->
            <patternlayout pattern="${log_pattern}"/>
            <!--控制台只输出level及其以上级别的信息（onmatch），其他的直接拒绝（onmismatch）-->
            <thresholdfilter level="info" onmatch="accept" onmismatch="deny"/>
        </console>

        <!--文件会打印出所有信息-->
        <file name="filelog" filename="${file_path}/log4j2.log" append="true">
            <patternlayout pattern="${log_pattern}"/>
        </file>

        <!-- 这个会打印出所有的info及以下级别的信息，每次大小超过size，则这size大小的日志会自动存入按年份-月份建立的文件夹下面并进行压缩，作为存档-->
        <rollingfile name="rollingfileinfo" filename="${file_path}/info.log" filepattern="${file_path}/${file_name}-info-%d{yyyy-mm-dd}_%i.log.gz">
            <!--控制台只输出level及以上级别的信息（onmatch），其他的直接拒绝（onmismatch）-->
            <thresholdfilter level="info" onmatch="accept" onmismatch="deny"/>
            <patternlayout pattern="${log_pattern}"/>
            <policies>
                <!--interval属性用来指定多久滚动一次，默认是1 hour-->
                <timebasedtriggeringpolicy interval="1"/>
                <sizebasedtriggeringpolicy size="10mb"/>
            </policies>
            <!-- defaultrolloverstrategy同一文件夹下15个文件开始覆盖-->
            <defaultrolloverstrategy max="15"/>
        </rollingfile>

        <!-- 这个会打印出所有的warn及以下级别的信息，每次大小超过size，则这size大小的日志会自动存入按年份-月份建立的文件夹下面并进行压缩，作为存档-->
        <rollingfile name="rollingfilewarn" filename="${file_path}/warn.log" filepattern="${file_path}/${file_name}-warn-%d{yyyy-mm-dd}_%i.log.gz">
            <!--控制台只输出level及以上级别的信息（onmatch），其他的直接拒绝（onmismatch）-->
            <thresholdfilter level="warn" onmatch="accept" onmismatch="deny"/>
            <patternlayout pattern="${log_pattern}"/>
            <policies>
                <!--interval属性用来指定多久滚动一次，默认是1 hour-->
                <timebasedtriggeringpolicy interval="1"/>
                <sizebasedtriggeringpolicy size="10mb"/>
            </policies>
            <!-- defaultrolloverstrategy同一文件夹下15个文件开始覆盖-->
            <defaultrolloverstrategy max="15"/>
        </rollingfile>

        <!-- 这个会打印出所有的error及以下级别的信息，每次大小超过size，则这size大小的日志会自动存入按年份-月份建立的文件夹下面并进行压缩，作为存档-->
        <rollingfile name="rollingfileerror" filename="${file_path}/error.log" filepattern="${file_path}/${file_name}-error-%d{yyyy-mm-dd}_%i.log.gz">
            <!--控制台只输出level及以上级别的信息（onmatch），其他的直接拒绝（onmismatch）-->
            <thresholdfilter level="error" onmatch="accept" onmismatch="deny"/>
            <patternlayout pattern="${log_pattern}"/>
            <policies>
                <!--interval属性用来指定多久滚动一次，默认是1 hour-->
                <timebasedtriggeringpolicy interval="1"/>
                <sizebasedtriggeringpolicy size="10mb"/>
            </policies>
            <!-- defaultrolloverstrategy同一文件夹下15个文件开始覆盖-->
            <defaultrolloverstrategy max="15"/>
        </rollingfile>
    </appenders>

    <!--logger节点用来单独指定日志的形式，比如要为指定包下的class指定不同的日志级别等。-->
    <!--然后定义loggers，只有定义了logger并引入的appender，appender才会生效-->
    <loggers>
        <!--过滤掉spring和mybatis的一些无用的debug信息-->
        <logger name="org.mybatis" level="info" additivity="false">
            <appenderref ref="console"/>
        </logger>
        <!--监控系统信息-->
        <!--若是additivity设为false，则 子logger 只会在自己的appender里输出，而不会在 父logger 的appender里输出。-->
        <logger name="org.springframework" level="info" additivity="false">
            <appenderref ref="console"/>
        </logger>
        <root level="info">
            <appender-ref ref="console"/>
            <appender-ref ref="filelog"/>
            <appender-ref ref="rollingfileinfo"/>
            <appender-ref ref="rollingfilewarn"/>
            <appender-ref ref="rollingfileerror"/>
        </root>
    </loggers>

</configuration>

三、测试日志打印

1、简单的测试程序

import org.slf4j.logger;
import org.slf4j.loggerfactory;
import org.springframework.web.bind.annotation.requestmapping;
import org.springframework.web.bind.annotation.restcontroller;
@restcontroller
public class log4j2controller {
    private static final logger logger = loggerfactory.getlogger(log4j2controller.class);
    /**
     * 日志级别
     * off > fatal > error > warn > info > debug > trace > all
     */
    @requestmapping("/printlog")
    public string printlog (){
        logger.error("error 级别日志");
        logger.warn("warn 级别日志");
        logger.info("info 级别日志");
        logger.debug("debug 级别日志");
        logger.trace("trace 级别日志");
        return "success" ;
    }
}

2、测试效果图

源代码地址

github:知了一笑
https://github.com/cicadasmile/spring-boot-base