目录
（一）配置文件的加载
（二）使用介绍
1、configuration：配置文件的跟元素
2、contextName：设置日志上下文名称
3、contextListener：设置上下文监听事件
4、property/variable/substitutionProperty：设置变量
5、conversionRule：自定义关键字的转换规则
6、statusListener：配置日志的状态监听器
7、appender：日志事件的输出组件
8、logger：日志记录实例
9、include：内嵌配置文件
（一）配置文件的加载
（1）设置系统变量：logback.configurationFile指定配置文件路径
启动时加入启动参数-Dlogback.configurationFile=/path/log/logback.xml
（2）查找resource下的logback-test.xml（这个通常是单元测试时使用，配置在test/resources下）
（3）查找resource下的logback.xml
（二）使用介绍
先给出一份比较详细的配置文件（注意此配置文件并不一定合理，因为很多标签属性是为了展示其用法而加，实际的配置文件需要根据项目所需设置），然后再对其中标签元素一一介绍
<configuration scan="true" scanPeriod="1 minute" debug="true"><!--<turboFilter class=""/>--><!-- Appenders --><!--<contextName>mallLogSystem</contextName>--><!--<contextListener class=""/>--><property name="logPath" value="logs" scope="SYSTEM"/><property name="appName" value="mallSystem"/><!--<property resource="log.properties"/>--><appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender"><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender><appender name="ASYNC" class="ch.qos.logback.classic.AsyncAppender"><!-- 设置是否在启动时触发之前丢弃的事件 --><discardingThreshold>0</discardingThreshold><!-- 设置这个appender的neveQueueSize --><queueSize>512</queueSize><!-- 添加真实的appender --><appender-ref ref="ROLLING"/></appender><appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender"><file>${logPath}/${appName}.log</file><rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy"><fileNamePattern>${logPath}/${appName}.%d{yyyy-MM-dd}.%i.log</fileNamePattern><maxHistory>30</maxHistory> <!-- 保留最近30天的日志文件 --><MaxFileSize>10MB</MaxFileSize></rollingPolicy><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender><appender name="impossible" class="ch.qos.logback.core.rolling.RollingFileAppender"><file>${logPath}/${impossibleName}.log</file><rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy"><fileNamePattern>${logPath}/${impossibleName}.%i.log.zip</fileNamePattern><minIndex>1</minIndex><maxIndex>3</maxIndex></rollingPolicy><triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy"><maxFileSize>16kb</maxFileSize></triggeringPolicy><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{50} %msg%n</pattern></encoder><filter class="com.mall.common.log.LevelRangeFilter"><minLevel>WARN</minLevel><maxLevel>ERROR</maxLevel><onMatch>ACCEPT</onMatch><onMismatch>DENY</onMismatch></filter></appender><logger name="impossible" additivity="false"><appender-ref ref="impossible"/></logger><!-- Root Logger --><root level="Info"><appender-ref ref="CONSOLE"/><appender-ref ref="ASYNC"/></root>
</configuration>1、configuration：配置文件的跟元素
属性介绍
scan：true表示会添加一个定时任务检查配置文件是否改变，改变则重新加载，和scanPeriod配合使用。默认为false.
scanPeriod：扫描周期，支持Duration字符串转换，300 millisecond，1 minute，60 second, 1 hour，1 day。空格将数量和单位分割开。
debug：true，表示开启日志初始化时的内部日志打印，可以看到日志初始化的一些输出日志。默认是关闭的，日志初始化有问题可以将此项打开，方便看初始化过程。
packagingData： 如果设置为true，那么设置context中对应的属性为true。此属性控制有异常抛出时，异常堆栈是否包含jar包以及对应版本号，默认为false
2、contextName：设置日志上下文名称
3、contextListener：设置上下文监听事件
可以监听上下文生命周期的事件，属性class设置监听器的类。监听事件包含：onStart、onReset、onStop、onLevelChange
4、property/variable/substitutionProperty：设置变量
这3个标签是同一个（历史原因造成），可以定义key-value属性值
scope：作用域，有3种范围：LOCAL, CONTEXT, SYSTEM。变量的查找顺序是本地，然后是CONTEXT，然后才是SYSTEM。默认是LOCAL。注意SYSTEM实际会设置到系统变量中，所以需要谨慎。
name：key值
value：key对应的value。
file：支持批量配置文件导入，值为文件绝对路径
resource：配置的是资源文件，相对于resources路径，如：<property resource="log.properties"/>
name和value是成对出现的，并且和file、resource互斥，即一个property只配置3者其中之一即可
5、conversionRule：自定义关键字的转换规则
只需要配置class属性，对应的是转换器类。详情可参见《logback之自定义pattern使用的转换器》
6、statusListener：配置日志的状态监听器
也只需要配置监听器类，只需要实现addStatusEvent即可，然后结合StatusPrinter，可以打印状态事件，在排错方面很有用。
7、appender：日志事件的输出组件
name：定义一个名称
class：对应的appender类
通常有4种appender:ConsoleAppender，FileAppender，RollingFileAppender，AsyncAppender。除了AsyncAppender需要引用实际的appender以外，其余appender都需要定义encoder，以设置日志输出格式：
<encoder><pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder>pattern详细介绍，可参加《logback之pattern详解以及源码分析》同时还可以添加过滤器，如下：
<filter class="ch.qos.logback.classic.filter.LevelFilter"><Level>INFO</Level><onMatch>ACCEPT</onMatch><onMismatch>DENY</onMismatch></filter>过滤器可自定义，详情可参见另一篇《logback之自定义过滤器》
（1） ConsoleAppender：输出到控制台，示例如下：
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender"><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender>（2）FileAppender：输出到固定的日志文件
<appender name="fileAppender" class="ch.qos.logback.core.FileAppender"><file>${logPath}/${appName}_fix.log</file><append>true</append><prudent>false</prudent><BufferSize>1024</BufferSize><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender>file：设置文件名称，支持变量绑定
append：是否将日志追加到文件现有内容的末尾，默认为true。
prudent:是否prudent模式，默认为false。此项开启需谨慎，用于多个进程间的共享文件写入，会加文件锁，所以可能会有性能影响。（如果文件每秒只有30条日志，性能影响不大，但如果每秒超过100以上，那么就可能会有性能问题了）
BufferSize：缓存区大小。FileAppender用BufferedOutputStream实际输出日志，所以可以设置缓存区大小，默认8096。
（3）RollingFileAppender：也是输出到日志文件，继承FileAppender，但可以配置滚动策略实现日志滚动，这个在实际生产中用的比较大。如下示例是每天滚动一次文件，最多保留30天的日志。同时还按文件大小滚动，如果文件超过10M也会滚动
<appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender"><file>${logPath}/${appName}.log</file><rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy"><fileNamePattern>${logPath}/${appName}.%d{yyyy-MM-dd}.%i.log</fileNamePattern><maxHistory>30</maxHistory> <!-- 保留最近30天的日志文件 --><MaxFileSize>10MB</MaxFileSize></rollingPolicy><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender>继承自FileAppender，所以FileAppender可以设置的属性，它都可以设置。另外增加了RollingPolicy和TriggeringPolicy。设置滚动策略以及滚动触发的策略。SizeAndTimeBasedRollingPolicy继承自TimeBasedRollingPolicy，既是RollingPolicy也是TriggeringPolicy。所以不用额外设置TriggeringPolicy。
滚动策略和触发策略还可以有如下搭配：
按文件大小滚动：最多3个滚动文件，超过3个，会把旧的删掉。触发条件按文件大小，下面配置的是16kb。
<rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy"><fileNamePattern>${logPath}/${impossibleName}.%i.log.zip</fileNamePattern><minIndex>1</minIndex><maxIndex>3</maxIndex></rollingPolicy><triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy"><maxFileSize>16kb</maxFileSize></triggeringPolicy>按日期滚动：每天滚动一次，滚动的频率是根据所配置${yyyy-MM-dd}文件日期格式定的，如果配置按月，那么就是${yyyy-MM}
<appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender"><file>logs/logback.log</file><rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"><fileNamePattern>logs/logback.%d{yyyy-MM-dd}.log</fileNamePattern><maxHistory>30</maxHistory> <!-- 保留最近30天的日志文件 --></rollingPolicy><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender>（4）AsyncAppender：异步日志输出，需要appender-ref指定实际的appender组件。
<appender name="ASYNC" class="ch.qos.logback.classic.AsyncAppender"><!-- 如果队列的80%已满,则会丢弃TRACT、DEBUG、INFO级别的日志 --><discardingThreshold>20</discardingThreshold><!-- 更改默认的队列的深度,该值会影响性能.默认值为256 --><queueSize>512</queueSize><!-- 队列满了不阻塞调用者--><neverBlock>true</neverBlock><!-- 添加真实的appender,最多只能添加一个 --><appender-ref ref="ROLLING"/></appender>AsyncAppender是为了不阻塞主线程而使用的，日志不会直接输出，而是放到阻塞队列中。它会开启一个单独的后台线程，从ArrayBlockingQueue中日志获取再调用实际的appender输出日志。
discardingThreshold：设置队列容量剩余多少时直接丢弃info（包含info）级别以下的日志的阈值。日志容量达到阈值，说明此时日志负载是比较重的，这时保证重要级别的日志输出。默认为-1，表示不限制。
queueSize：队列的容量
neverBlock：设置日志事件添加到队列中的方式，如果是neverBlock那么使用offer添加日志事件，那么在日志容量满的情况下是不会阻塞的；但如果是false，那么使用put添加就会阻塞主线程进入等待了。
8、logger：日志记录实例
标签属性：
name:logger的名称，有层级关系。如com.example.ClassInfo，那么它父级logger是com.example-》com-》root。所有的logger的根logger都是root。
level：定义日志级别，如果没有定义则继承父级logger的日志级别。
additivity：定义日志是否传递到父级，如果为true的话，那么除了会输出到当前logger的appender以外，还会传递给父级的appender。那么一条日志记录会输出到多个日志文件中。默认为true。
内嵌标签：
appender-ref：引用的appender
<logger name="impossible" additivity="false"><appender-ref ref="impossible"/><appender-ref ref="fileAppender"/></logger>9、include：内嵌配置文件
标签属性：
file：定义内嵌文件的绝对路径
url：url形式引入内嵌文件
resource：相对于resources路径引入内嵌文件
optional：是否输出解析内嵌配置文件过程中的状态日志，默认是false。
file、url、resource只能配置其中一个。内嵌文件必须以<included>开头，以<included>结尾。
如定义一个logProperty.xml：
<included><property name="logPath" value="logs"/><property name="appName" value="mallSystem"/>
</included>然后在主配置文件中引入：
<include resources="logProperty.xml"/>
![[羊城杯 2024]1z_misc](https://i-blog.csdnimg.cn/img_convert/a97f7f710b4c1e9c6f395b0db6e2402f.png)
