官方文档:
http://logback.qos.ch/manual/configuration.html
主要关注右侧目录中的
- configuration 跟节点
- Appenders 日志滚动策略
- Layouts 内容的格式化
-
Filters 过滤
我只对大家比较疑惑的内容进行说明
首先是滚动策略:
比较常用的应该就是按时间和文件大小滚动了,主要以日期进行滚动,但是在当日达到了指定的文件大小,就会按序列号滚动,所以FileNamePattern标签配置的文件生成策略必须含有%i
<!--
%d{yyyy-MM-dd} 日期格式化 说明按日滚动
%i:在这种滚动策略下,必须参数,当达到指定日志文件大小按序列号生成文件
例:
error.2020-08-30_1.log
error.2020-08-30_2.log
-->
<FileNamePattern>${LOG_HOME}/error/error.%d{yyyy-MM-dd}_%i.log</FileNamePattern>
内容的格式化encoder
-
%ex:异常堆栈跟踪内容,格式有
- short:打印堆栈跟踪的第一行
- full:打印完整的堆栈跟踪
-
任何整数:打印给定行数的堆栈跟踪
%c和%logger区别在于%c打印的是完整的类路径
%logger打印的是简单类名-
%highlight可以高亮()中的内容,如图
<!--
%highlight : 以不同的颜色高亮
%c:打印类的全限定名
-->
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %highlight(%-5level) %c : %n --- %msg%n</pattern>
</encoder>
filter的作用
在日志文件滚动策略中配置后可以只记录指定等级的日志,比如error日志中只记录error,那么就需要配置filter,否则error日志中也会有其他级别日志
以下是完整配置,基本够用了
<!--
scan : 自动热加载
scanPeriod:加载时间间隔 可用的单位是 milliseconds,seconds,minutes 和 hours,这默认单位为 milliseconds。
debug: 当此属性设置为true时,将打印出logback内部日志信息,实时查看logback运行状态。默认值为false。
-->
<configuration scan="false" scanPeriod="30 seconds" debug="false">
<!--可以自定义变量-->
<property name="LOG_HOME" value="logs/" />
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<!--
%highlight : 以不同的颜色高亮
%c:打印类的全限定名
-->
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %highlight(%-5level) %c : %n --- %msg%n</pattern>
</encoder>
</appender>
<appender name="error" class="ch.qos.logback.core.rolling.RollingFileAppender">
<!--写入的日志文件名-->
<file>${LOG_HOME}/error/error.log</file>
<!--
只记录error级别日志
配置该filter以后,在error.log文件中只有error级别日志
-->
<filter class="ch.qos.logback.classic.filter.LevelFilter">
<level>ERROR</level>
<onMatch>ACCEPT</onMatch>
<onMismatch>DENY</onMismatch>
</filter>
<!--如果是 true,日志被追加到文件结尾,如果是 false,清空现存文件,默认是true。-->
<append>true</append>
<!--滚动行为 基于时间和大小-->
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy" >
<!--
%d{yyyy-MM-dd} 日期格式化 说明按日滚动
%i:在这种滚动策略下,必须参数,当达到指定日志文件大小按序列号生成文件
例:
error.2020-08-30_1.log
error.2020-08-30_2.log
-->
<FileNamePattern>${LOG_HOME}/error/error.%d{yyyy-MM-dd}_%i.log</FileNamePattern>
<maxFileSize>100MB</maxFileSize>
<maxHistory>20</maxHistory>
</rollingPolicy>
<!-- %c:打印类的全限定名 -->
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %c - %msg%n</pattern>
</encoder>
</appender>
<appender name="info" class="ch.qos.logback.core.rolling.RollingFileAppender">
<!--写入的日志文件名-->
<file>${LOG_HOME}/info/info.log</file>
<!--如果是 true,日志被追加到文件结尾,如果是 false,清空现存文件,默认是true。-->
<append>true</append>
<!--滚动行为 基于时间和大小-->
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy" >
<!--error.2020-08-30_1.log-->
<!--
%i:在这种滚动策略下,必须参数,当达到指定日志文件大小按序列号生成文件
-->
<FileNamePattern>${LOG_HOME}/info/info.%d{yyyy-MM-dd}_%i.log</FileNamePattern>
<maxFileSize>100MB</maxFileSize>
<maxHistory>20</maxHistory>
</rollingPolicy>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %c - %msg%n</pattern>
</encoder>
</appender>
<!--
additivity: 是否向上级logger传递打印信息。默认是true。
-->
<!--
可以指定某个包,某个类的日志级别
appender-ref 指定适用那种日志滚动策略
additivity 是否继承root的级别
-->
<logger name="com.liyonglong.searchrecommond" level="ERROR" additivity="false">
<appender-ref ref="error" />
<appender-ref ref="STDOUT" />
</logger>
<logger name="com.liyonglong.searchrecommond" level="INFO" additivity="false">
<appender-ref ref="info" />
</logger>
<root level="DEBUG">
<appender-ref ref="STDOUT" />
</root>
</configuration>