springboot log4j2 配置介绍

配置文件节点介绍

根节点Configuration

属性

status: 用来指定log4j本身的打印日志级别; monitorinterval: 用来指定log4j自动重新配置的检测间隔时间,单位: s, 最小5s;

子节点

Appenders Loggers

Appenders节点

Configuration根节点的子节点。

子节点

Console: 用来定义输出到控制台的Appender; RollingFile: 用来定义超过指定大小自动删除旧的创建新的的Appender; File: 用来定义输出到指定位置的文件的Appender;

Console节点

用来定义输出到控制台的Appender。

属性

name: 用来指定Appender的名称; target: 可选值 SYSTEM_OUT 或 SYSTEM_ERR。一般只设置默认:SYSTEM_OUT;

子节点

PatternLayout: 输出格式,默认值:%m%n;

File节点

用来定义输出到指定位置的文件的Appender。

属性

name: 用来指定Appender的名称; fileName: 指定输出日志的目的文件带全路径的文件名;

子节点

PatternLayout: 输出格式,默认值:%m%n; ThresholdFilter: 指定输出级别;

RollingFile节点

用来定义超过指定大小自动删除旧的创建新的的Appender。

属性

name: 用来指定Appender的名称; fileName: 指定输出日志的目的文件带全路径的文件名; filePattern: 指定新建日志文件的名称格式;

子节点

PatternLayout: 输出格式,默认值:%m%n; DefaultRolloverStrategy: 用来指定同一个文件夹下最多有几个日志文件时开始删除最旧的,创建新的(通过max属性); Policies: 指定滚动日志的策略,就是什么时候进行新建日志文件输出日志; Filters: 决定日志事件能否被输出。过滤条件有三个值:ACCEPT(接受), DENY(拒绝) or NEUTRAL(中立);

Policies节点

RollingFile节点的子节点,指定滚动日志的策略。

子节点

TimeBasedTriggeringPolicy: 基于时间的滚动策略,interval属性用来指定多久滚动一次,默认是1hour。modulate=true用来调整时间:比如现在是早上3am,interval是4,那么第一次滚动是在4am,接着是8am,12am...而不是7am; SizeBasedTriggeringPolicy: 基于指定文件大小的滚动策略,size属性用来定义每个日志文件的大小;

PatternLayout节点

Console节点、File节点、RollingFile节点的子节点,指定输出格式,不设置默认为:%m%n。

属性

pattern: 指定日志格式;

日期格式:

%d{yyyy-MM-dd HH:mm:ss, SSS} : 日志生产时间
%p : 日志输出格式
%c : logger的名称
%m : 日志内容, 即 logger.info("message")
%n : 换行符
%C : Java类名
%L : 日志输出所在行数
%M : 日志输出所在方法名
hostName : 本地机器名
hostAddress : 本地ip地址

ThresholdFilter节点

Filter节点的子节点,决定日志事件能否被输出。过滤条件有三个值:ACCEPT(接受), DENY(拒绝) or NEUTRAL(中立)。

ACCEP和DENY比较好理解就是接受和拒绝的意思,在使用单个过滤器的时候,一般就是使用这两个值。但是在组合过滤器中,如果用接受ACCEPT的话,日志信息就会直接写入日志文件,后续的过滤器不再进行过滤。所以,在组合过滤器中,接受使用NEUTRAL(中立),被第一个过滤器接受的日志信息,会继续用后面的过滤器进行过滤,只有符合所有过滤器条件的日志信息,才会被最终写入日志文件。

属性

level: 指定过滤日志的级别; onMatch: 默认值是NEUTRAL; onMismatch: 默认是DENY

Loggers节点

子节点

Root: 用来指定项目的根日志,如果没有单独指定Logger,那么就会默认使用该Root日志输出; Logger: 用来单独指定日志的形式,比如要为指定包下的class指定不同的日志级别等;

Root节点

Loggers节点的子节点。

属性

level: 指定日志输出级别;

子节点

appender-ref: 用来指定该日志输出到哪个Appender,通过ref指定;

Logger节点

Loggers节点的子节点。

属性

level: 指定日志输出级别; name: 用来指定该Logger所适用的类或者类所在的包全路径,继承自Root节点;

子节点

appender-ref: 用来指定该日志输出到哪个Appender,通过ref指定;

日志级别

共有8个级别,按照从低到高为: All < Trace < Debug < Info < Warn < Error < Fatal < OFF。

All: 最低等级的,用于打开所有日志记录; Trace: 是追踪,就是程序推进以下,你就可以写个trace输出,所以trace应该会特别多,不过没关系,我们可以设置最低日志级别不让他输出; Debug: 指出细粒度信息事件对调试应用程序是非常有帮助的; Info: 消息在粗粒度级别上突出强调应用程序的运行过程; Warn: 输出警告及warn以下级别的日志; Error: 输出错误信息日志; Fatal: 输出每个严重的错误事件将会导致应用程序的退出的日志; OFF: 最高等级的,用于关闭所有日志记录;

示例

application.properties配置

loggging.config=classpath/log4j2.xml

pom.xml添加依赖

<!-- springboot核心包 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
    <!-- 去掉springboot默认log配置 -->
    <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>
    <version>2.4.0</version>
</dependency>

配置log4j2.xml

resources下新建log4j2.xml文件并写入一下内容: