logback.xml配置文件详解

原文链接：https://www.longkui.site/program/java/logback-xml/5385/

上一篇文章介绍了spring boot配置自定义日志文件logback.xml

今天这篇文章简单介绍一下logback.xml配置文件的一些含义。

1.基本结构
logback的基本结构如下图：

configuration 表示配置的根节点
appender 用来格式化日志输出
logger 用来设置一个包或者类的日志打印级别
contextName 设置上下文名称，一般不使用
property 用于定义变量
2.configuration
configuration有三个属性

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

示例：

　　 　 3.appender 这个节点负责写日志，有两个必填属性，name和class。name是当前输出器的名字，class是appender的全限定名。

class有下面几类：

ch.qos.logback.core.ConsoleAppender
ch.qos.logback.core.FileAppender
ch.qos.logback.core.rolling.RollingFileAppender
3.1 ConsoleAppender

将日志输出到控制台，有以下子节点

：对日志进行格式化。
：字符串System.out(默认)或者System.err

示例：把>=DEBUG级别的日志都输出到控制台

　　　 　　　　　 　　　　　　　　　%-4relative [%thread] %-5level %logger{35} - %msg %n 　　　　　 　　　

　　　　　　
　　　

也可以加入拦截器，比如下面这样

　　　 ERROR 　　　　　 　　　　　　　　　%-4relative [%thread] %-5level %logger{35} - %msg %n 　　　　　 　　　

　　　　　　
　　　

3.2 FileAppender

：被写入的文件名，可以是相对目录，也可以是绝对目录，如果上级目录不存在会自动创建，没有默认值。
：如果是 true，日志被追加到文件结尾，如果是 false，清空现存文件，默认是true。
：对记录事件进行格式化。
：如果是 true，日志会被安全的写入文件，即使其他的FileAppender也在向此文件做写入操作，效率低，默认是 false。
示例：把>=DEBUG级别的日志都输出到testFile.log

　　　　　　 　　　　　　　　testFile.log 　　　　　　　　true 　　　　　　　　 　　　　　　　　　　%-4relative [%thread] %-5level %logger{35} - %msg%n 　　　　　　　　 　　　　　　

　　　　　　
　　　　　　
　　　　
3.3 RollingFileAppender

滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件。有以下子节点：

：被写入的文件名，可以是相对目录，也可以是绝对目录，如果上级目录不存在会自动创建，没有默认值。
：如果是 true，日志被追加到文件结尾，如果是 false，清空现存文件，默认是true。
:当发生滚动时，决定RollingFileAppender的行为，涉及文件移动和重命名。属性class定义具体的滚动策略类
<1> class=”ch.qos.logback.core.rolling.TimeBasedRollingPolicy”： 最常用的滚动策略，它根据时间来制定滚动策略，既负责滚动也负责出发滚动。有以下子节点：
　　　　 ：必要节点，包含文件名及“%d”转换符，“%d”可以包含一个java.text.SimpleDateFormat指定的时间格式，如：%d{yyyy-MM}。
如果直接使用 %d，默认格式是 yyyy-MM-dd。RollingFileAppender的file字节点可有可无，通过设置file，可以为活动文件和归档文件指定不同位置，当前日志总是记录到file指定的文件（活动文件），活动文件的名字不会改变；
如果没设置file，活动文件的名字会根据fileNamePattern 的值，每隔一段时间改变一次。“/”或者“\”会被当做目录分隔符。
:可选节点，控制保留的归档文件的最大数量，超出数量就删除旧文件。假设设置每个月滚动，且是6，则只保存最近6个月的文件，删除之前的旧文件。注意，删除旧文件是，那些为了归档而创建的目录也会被删除。

<2> class=”ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy”： 查看当前活动文件的大小，如果超过指定大小会告知RollingFileAppender 触发当前活动文件滚动。只有一个节点:
:这是活动文件的大小，默认值是10MB。
：当为true时，不支持FixedWindowRollingPolicy。支持TimeBasedRollingPolicy，但是有两个限制，1不支持也不允许文件压缩，2不能设置file属性，必须留空。
: 告知 RollingFileAppender 合适激活滚动。

<3> class=”ch.qos.logback.core.rolling.FixedWindowRollingPolicy” 根据固定窗口算法重命名文件的滚动策略。有以下子节点：
:窗口索引最小值
:窗口索引最大值，当用户指定的窗口过大时，会自动将窗口设置为12。
:必须包含“%i”例如，假设最小值和最大值分别为1和2，命名模式为 mylog%i.log,会产生归档文件mylog1.log和mylog2.log。还可以指定文件压缩选项，例如，mylog%i.log.gz 或者 没有log%i.log.zip

比如下面这个例子：每天生成一个日志文件，保存30天的日志文件。

　　 　　　　 　　　　　　logFile.%d{yyyy-MM-dd}.log 　　　　　　30 　　　　 　　　　 　　　　　　%-4relative [%thread] %-5level %logger{35} - %msg%n 　　　　 　　

　　　　
　　

4.logger
这个节点主要用来设置某个包或者某个类的日志打印级别，非必填节点，如果不需要可以不用写。一般的用途是打印sql操作。它有下面这些节点

name: 用来指定受此loger约束的某一个包或者具体的某一个类。
level: 用来设置打印级别，大小写无关：TRACE, DEBUG, INFO, WARN, ERROR, ALL和OFF，还有一个特殊值INHERITED或者同义词NULL，代表强制执行上级的级别。 如果未设置此属性，那么当前loger将会继承上级的级别。
addtivity: 是否向上级logger传递打印信息。默认是true。可以包含零个或多个元素，标识这个appender将会添加到这个logger。
比如下面这样：

这个就表示site.longkui.app.mapper这个具体的类下面要打印DEBUG层级的日志，不过经过实践，上面这段代码并不完全好用，配置成下面这样就OK了 5.root 必填，用来指定日志输出级别。下面可以包含多个appender-ref。比如下面这样：

<root level="DEBUG">
    <appender-ref ref="STDOUT" />
    <appender-ref ref="FILE"/>
</root>

表示输出的debug级别的日志，而且只包含 appender的名称是STDOUT和FILE的两个输出器。

6.contextName
非必填节点，主要用来设置上下文名称，用于区分不同应用程序的记录。

比如下面这：

myAppName 　　 7.property 主要用来定义变量的，它有两个属性name和value，通过定义的值会被插入到logger上下文中，可以使“${}”来使用变量。　

比如下面这样：

　　　 　　　${APP_Name}