（六）logback.xml 配置详解

原文链接：https://www.cnblogs.com/taiyonghai/p/9290641.html，https://blog.csdn.net/A615883576/article/details/81226255

配置查询1：

<?xml version="1.0" encoding="utf-8" ?>
<!-- 从高到地低 OFF 、 FATAL 、 ERROR 、 WARN 、 INFO 、 DEBUG 、 TRACE 、 ALL -->
<!-- 日志输出规则  根据当前ROOT 级别，日志输出时，级别高于root默认的级别时  会输出 -->
<!-- 以下  每个配置的 filter 是过滤掉输出文件里面，会出现高级别文件，依然出现低级别的日志信息，通过filter 过滤只记录本级别的日志-->

<!-- 属性描述 scan：性设置为true时，配置文件如果发生改变，将会被重新加载，默认值为true scanPeriod:设置监测配置文件是否有修改的时间间隔，如果没有给出时间单位，
默认单位是毫秒。当scan为true时，此属性生效。默认的时间间隔为1分钟。debug:当此属性设置为true时，将打印出logback内部日志信息，实时查看logback运行状态。默认值为false。 -->
<configuration scan="true" scanPeriod="60 seconds" debug="false">
    <!-- 定义日志文件 输入位置 -->
    <property name="logPath" value="d:/test_log" />
    <!-- 日志最大的历史 30天 -->
    <property name="maxHistory" value="30"/>

    <!-- 配置项， 通过此节点配置日志输出位置（控制台、文件、数据库）、输出格式等-->
    <!-- ConsoleAppender代表输出到控制台 -->
    <appender name="consoleLog" class="ch.qos.logback.core.ConsoleAppender">
        <!-- layout代表输出格式 -->
        <layout class="ch.qos.logback.classic.PatternLayout">
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger -%msg%n</pattern>
        </layout>
    </appender>
    <!-- 日志输出文件 -->
    <appender name="fileInfoLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger -%msg%n</pattern>
        </encoder>
        <!-- 滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件 RollingFileAppender-->
        <!-- 滚动策略，它根据时间来制定滚动策略.既负责滚动也负责触发滚动 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 输出路径 -->
            <fileNamePattern>${logPath}/info/%d.log</fileNamePattern>
            <!-- 可选节点，控制保留的归档文件的最大数量，超出数量就删除旧文件假设设置每个月滚动，且<maxHistory>是6，
            则只保存最近6个月的文件，删除之前的旧文件。注意，删除旧文件是，那些为了归档而创建的目录也会被删除-->
            <maxHistory>${maxHistory}</maxHistory>
        </rollingPolicy>
        <!-- 按照固定窗口模式生成日志文件，当文件大于20MB时，生成新的日志文件。窗口大小是1到3，当保存了3个归档文件后，将覆盖最早的日志。
        <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
          <fileNamePattern>${logPath}/%d{yyyy-MM-dd}/.log.zip</fileNamePattern>
          <minIndex>1</minIndex>
          <maxIndex>3</maxIndex>
        </rollingPolicy>   -->
        <!-- 查看当前活动文件的大小，如果超过指定大小会告知RollingFileAppender 触发当前活动文件滚动
        <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
            <maxFileSize>5MB</maxFileSize>
        </triggeringPolicy>   -->
    </appender>
    <!-- 特殊记录Error日志 -->
    <appender name="fileErrorLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 只记录ERROR级别日志，添加范围过滤，可以将该类型的日志特殊记录到某个位置 -->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>ERROR</level>
        </filter>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger -%msg%n</pattern>
        </encoder>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${logPath}/error/%d.log</fileNamePattern>
            <!-- 日志最大的历史 60天 -->
            <maxHistory>60</maxHistory>
        </rollingPolicy>
    </appender>

    <!-- 根节点，表名基本的日志级别，里面可以由多个appender规则 -->
    <!-- level="info"代表基础日志级别为info -->
    <root level="info">
        <!-- 引入控制台输出规则 -->
        <appender-ref ref="consoleLog" />
        <appender-ref ref="fileInfoLog" />
        <appender-ref ref="fileErrorLog" />
    </root>
</configuration>　

配置查询2：

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

<configuration>

    <!-- 设置控制台日志输出格式 -->
    <appender name="consoleLog" class="ch.qos.logback.core.ConsoleAppender">
        <layout class="ch.qos.logback.classic.PatternLayout">
            <pattern>
                %d - %msg%n
            </pattern>
        </layout>
    </appender>

    <!-- 设置记录除ERROR日志的文件 -->    
    <appender name="fileInfoLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 过滤方式：匹配过滤，对匹配到的日志执行匹配策略 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <!-- 匹配级别 -->
            <level>ERROR</level>
            <!-- 匹配到的执行策略 -->
            <onMatch>DENY</onMatch>
            <!-- 不匹配的执行策略 -->
            <onMismatch>ACCEPT</onMismatch>
        </filter>
        <encoder>
            <pattern>
                %msg%n
            </pattern>
        </encoder>
        <!-- 滚动策略 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 路径 -->
            <fileNamePattern>/var/log/tomcat/sell/info.%d.log</fileNamePattern>
        </rollingPolicy>
    </appender>

    <!-- 设置记录ERROR日志的文件 -->
    <appender name="fileErrorLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 过滤方式：门槛过滤，只记录ERROR级别以上的日志 -->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>ERROR</level>
        </filter>
        <encoder>
            <pattern>
                %msg%n
            </pattern>
        </encoder>
        <!-- 滚动策略 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 路径 -->
            <fileNamePattern>/var/log/tomcat/sell/error.%d.log</fileNamePattern>
        </rollingPolicy>
    </appender>

    <root>
        <appender-ref ref="consoleLog">
        <appender-ref ref="fileInfoLog">
        <appender-ref ref="fileErrorLog">
    </root>

</configuration>

根节点<configuration>
scan: 当此属性设置为true时，配置文件如果发生改变，将会被重新加载。默认值为true。
scanPeriod: 设置监测配置文件是否有修改的时间间隔，如果没有给出时间单位，默认单位是毫秒。当scan为true时，此属性生效。默认的时间间隔为1分钟。
debug: 当此属性设置为true时，将打印出logback内部日志信息，实时查看logback运行状态。默认值为false。

<contextName>: 每个logger都关联到logger上下文，默认上下文名称为“default”。但可以使用设置成其他名字，用于区分不同应用程序的记录。一旦设置，不能修改,可以通过%contextName来引用日志上下文名称
<property>: 用来定义变量值的标签,通过定义的值会被插入到logger上下文中。定义变量后，可以使 ${} 来使用变量。
<appender>: 用来格式化日志输出节点，

有两个属性 name 和 class，class 用来指定哪种输出策略，常用就是：
控制台输出策略(class = ch.qos.logback.core.ConsoleAppender)
<layout>
class = ch.qos.logback.classic.PatternLayout: 控制台日志输出模式
<pattern>: 设置日志记录行格式

文件输出策略(class = ch.qos.logback.core.rolling.RollingFileAppender)
常见的日志输出到文件，随着应用的运行时间越来越长，日志也会增长的越来越多，将他们输出到同一个文件并非一个好办法，ch.qos.logback.core.rolling.RollingFileAppender 用于切分文件日志
<filter>
class = ch.qos.logback.classic.filter.LevelFilter: 匹配过滤，对匹配到的日志执行匹配策略
<level>: 匹配级别
<onMatch>: 匹配到的执行策略
<onMisMatch>: 不匹配的执行策略
class = ch.qos.logback.classic.filter.ThresholdFilter: 门槛过滤，只记录级别以上的日志
<level>: 匹配级别

<encoder>
<pattern>: 设置日志记录行格式

<rollingPolicy>
class = ch.qos.logback.core.rolling.TimeBasedRollingPolicy: 根据时间来分割日志文件，每天生成一个，这样可能每天的日志文件的大小不固定
class = ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy: 根据文件大小来分割，每达到maxFileSize就分割出来一个文件
class = ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy: 同时按照每天和大小来分割日志文件, 这种方式pattern中必须包含 %d 和%i。
<fileNamePattern>: 定义分隔的日志文件的名称规则
<maxHistory>: 表示只保留最近N天的日志，以防止日志填满整个磁盘空间
<totalSizeCap>: 指定日志文件的上限大小，例如设置为1GB的话，那么到了这个值，就会删除旧的日志

<root>: 用来指定最基础的日志输出级别，可以包含零个或多个 <appender-ref>，标识这个appender将会添加到这个logger。
level: 用来设置打印级别，大小写无关：TRACE， DEBUG， INFO， WARN，ERROR， ALL 和 OFF
<appender-ref>
ref: 指向 <appender> 的 name 属性

<logger>: 用来设置某一个包或者具体的某一个类的日志打印级别，以及指定appender
name: 用来指定受此logger约束的某一个包或者具体的某一个类。
level: 用来设置打印级别，大小写无关：TRACE， DEBUG， INFO， WARN，ERROR， ALL 和 OFF，如果未设置此属性，那么当前logger将会继承上级的级别，所谓向上级传递就是是否使用root的配置
addtivity: 是否向上级logger传递打印信息。默认是true

<appender-ref>
ref: 指向 <appender> 的 name 属性