logback配置详解

## 简介

记录一下，万一以后用得着呢。

<!-- more -->

```xml
<configuration>
    <!--RollingFileAppender继承自FileAppender，具有轮转日志文件的功能,是我们最常使用的Appender-->
    <appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender">
    
    	<!-- 支持多个 JVM 同时写一个文件,也叫严格模式，该模式为开启时，滚动策略只能使用TimeBasedRollingPolicy及其子策略 -->
    	<!-- 同时，该模式开启时不支持设置file标签及文件压缩,所以这一点非常终要!!!!! -->
        <prudent>false</prudent>
        
    	<!--要写入文件的名称,该名称不会受滚动策略影响。如果文件不存在，则新建，该标签只含有滚动策略触发节点前的日志信息，经过某次轮转后，该文件被置为空，原内容被重命名或压缩-->
        <file>mylog.txt</file>
        
        <!-- SizeAndTimeBasedRollingPolicy是基于时间和大小的滚动策略，几乎可以涵盖所有日志滚动需求场景，也是使用最多的策略 -->
        <!-- 该策略适用于1.1.7版本及之后的版本，之前的版本继续采用TimeBasedRollingPolicy加SizeAndTimeBasedFNATP组件实现 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <!-- 基于时间和大小的轮转策略中fileNamePattern位置很重要，他决定了生成文件的名称及轮转时机,以及是否压缩 -->
            <!-- %d决定以什么时间维度轮转(但实际轮转时机取决于日志事件的到达时间)，比如%d{yyyy/MM}:每个月开始的时候轮转,%d默认为 yyyy-MM-dd：按天轮转 -->
            <!-- %i为文件按照maxFileSize大小规定轮转后的序号 -->
            <!-- 后缀以".zip"或".gz"结尾，则开启日志文件压缩 -->
            <fileNamePattern>mylog-%d{yyyy-MM-dd}.%i.txt</fileNamePattern>
            <!-- 单个日志文件最大大小，当文件达到该大小则触发截断（以及压缩）-->
            <maxFileSize>100MB</maxFileSize>
            <!-- 日志文件保留最大时间滚动周期，比如当filaNamePattern中%d以为dd结尾时，则保留60天-->
            <maxHistory>60</maxHistory>
            <!-- 日志文件保留的总的最大大小-->
            <totalSizeCap>20GB</totalSizeCap>
        </rollingPolicy>
        <!-- encoder标签规定日志文件内容输出格式，具体参数参照logback官方文档 -->
        <encoder>
            <pattern>%msg%n</pattern>
        </encoder>
    </appender>
	
    <root level="DEBUG">
        <appender-ref ref="ROLLING" />
    </root>
</configuration>
```

## 其他详解

```xml
<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 属性
```