Logback-spring.xml配置文件
1、日志级别:日志级别从低到高分为TRACE < DEBUG < INFO < WARN < ERROR < FATAL,例如:如果设置为WARN,则低于WARN的信息都不会输出
2、根节点:configuration
configuration 有三个可选属性:
a、scan属性:用来设置配置文件变动时是否重新加载,值是true\false,默认是true即配置变动时重新加载
b、scanperiod属性:用来设置每隔多久检查一次配置是否变动,默认是1分钟,默认单位是毫秒
c、debug属性:用来设置是否将logback内部的日志打印出来,即启动时输出配置加载信息。值为true\false 默认为false
3、property节点:
设置要使用的或者共用的变量,property包含两个属性name和value;其中name的值是变量的名称,value的值是变量所代表的值。
4、springProperty节点
该标签的工作方式类似于Logback的标准
如果需要将属性存储在local范围之外的其他位置,则可以使用该scope属性。
如果需要后备值(如果未在中设置属性Environment),则可以使用defaultValue属性。
5.appender节点
appender节点可以有多个,分别针对不同的包或者类做不同的输出,
如果appender输出到文件时,可以设置append子节点值true/false,是末尾追加日志还是替换日志,值为true时表示追加。
可以在appender中使用filter节点(过滤器),在此节点内过滤日志级别(使用level节点指定),过滤后会返回一个枚举值,
即DENY,NEUTRAL,ACCEPT其中之一:
A、返回DENY,日志将立即被抛弃不再经过其他过滤器;
B、返回NEUTRAL,有序列表里的下个过滤器接着处理日志;
C、返回ACCEPT,日志会被立即处理,不再经过剩余过滤器
如果需要使用这些值做处理时,需要使用onMatch(level级别或大于level级别的)和onMismatch(级别小于level级别的)
6、logger节点
用来设置某一个包或者具体的某一个类的日志打印级别、以及指定appender。logger仅有一个name属性和两个可选的level、addtivity属性。
Name属性:用来指定受此logger约束的某一个包或者具体的某一个类。
Level属性:用来设置打印级别,大小写无关:TRACE, DEBUG, INFO, WARN, ERROR
如果未设置此属性,那么当前logger将会继承上级的级别。
Addtivity属性:用来设置是否向上级logger传递打印信息。默认是true。
logger可以包含零个或多个appender-ref元素,标识这个appender将会添加到这个logger
7、root节点
也是
level:用来设置打印级别,大小写无关:TRACE, DEBUG, INFO, WARN, ERROR。默认是DEBUG。
root可以包含零个或多个appender-ref元素,标识这个appender将会添加到这个logger
8、pattern节点定义的输出模式解释
%d{HH:mm:ss.SSS} 当前时间;
[%thread] [当前线程名称]
%-5level logger级别
%logger{36} logger名称
-%msg%n 定义的输出
%line 输出日志的行号
%n 换行
%date和%d{yyyy-MM-dd HH:mm:ss.SSS} 当前时间包含年月日
{%C.java:%L} 输出日志所在的java类、所在行及路径可以替换[%thread]
9、appender下的filter的常见种类
在logback中,过滤器可以添加到Appender上。通过添加一个或多个过滤器到Appender,你可以通过任意条件,
比如:日志内容、MDC内容、时间等等日志的任何部分,过滤日志事件。
级别过滤器
级别过滤器(LevelFilter)是基于准确匹配日志级别。如果日志级别等于配置的级别,过滤器通过配置中的OnMatch与OnMismatch属性决定是接受还是拒绝事件。
阀值过滤器
阀值过滤器(ThresholdFilter)过滤低于指定阀值的事件。当事件中的日志级别大于等于指定阀值时,过滤器的decide方法返回NEUTRAL。然而,拒绝日志级别小于阀值的事件。
条件过滤器
条件过滤器(EvaluatorFilter)是一种封装了EventEvaluator的通过过滤器。像名字代表的,条件过滤器是根据判断事件是否符合指定条件来分别返回OnMatch与OnMismatch属性里的值。
注意:EventEvaluator是一个抽象类,通过继承它,你可以实现你自己的条件逻辑。
详细注释见下图:
xml version="1.0" encoding="UTF-8"?> <configuration debug="false" scan="false"> <property name="LOG_ROOT" value="/home/pams">property> <property name="LOG_PATH" value="log"/> <springProperty scop="context" name="spring.application.name" source="spring.application.name" defaultValue="dotware"/> <property name="log.path" value="${LOG_ROOT}/${LOG_PATH}/${spring.application.name}"/> <appender name="console" class="ch.qos.logback.core.ConsoleAppender"> <encoder> <pattern>%d{MM-dd HH:mm:ss.SSS} %-5level [%logger{50}] - %msg%npattern> encoder> appender> <appender name="info" class="ch.qos.logback.core.rolling.RollingFileAppender"> <file>${log.path}/info.logfile> <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy"> <fileNamePattern>${log.path}/%d{yyyy-MM}/info.%d{yyyy-MM-dd}.%i.logfileNamePattern> <maxFileSize>20MBmaxFileSize> <maxHistory>30maxHistory> <cleanHistoryOnStart>truecleanHistoryOnStart> rollingPolicy> <encoder> <pattern>%date [%thread] %-5level [%logger{50}] %file:%line - %msg%npattern> encoder> <filter class="ch.qos.logback.classic.filter.ThresholdFilter"> <level>infolevel> filter> appender> <appender name="debug" class="ch.qos.logback.core.rolling.RollingFileAppender"> <file>${log.path}/debug.logfile> <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy"> <fileNamePattern>${log.path}/%d{yyyy-MM}/debug.%d{yyyy-MM-dd}.%i.logfileNamePattern> <maxFileSize>20MBmaxFileSize> <maxHistory>30maxHistory> <cleanHistoryOnStart>truecleanHistoryOnStart> rollingPolicy> <encoder> <pattern>%date [%thread] %-5level [%logger{50}] %file:%line - %msg%npattern> encoder> <filter class="ch.qos.logback.classic.filter.ThresholdFilter"> <level>debuglevel> filter> appender> <appender name="error" class="ch.qos.logback.core.rolling.RollingFileAppender"> <file>${log.path}/error.logfile> <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy"> <fileNamePattern>${log.path}/%d{yyyy-MM}/error.%d{yyyy-MM-dd}.%i.logfileNamePattern> <maxFileSize>20MBmaxFileSize> <maxHistory>30maxHistory> <cleanHistoryOnStart>truecleanHistoryOnStart> rollingPolicy> <encoder> <pattern>%date [%thread] %-5level [%logger{50}] %file:%line - %msg%npattern> encoder> <filter class="ch.qos.logback.classic.filter.ThresholdFilter"> <level>errorlevel> filter> appender> <logger name="org.springframework" level="INFO"/> <logger name="org.springframework.web" level="INFO"/> <logger name="org.springframework.beans" level="INFO"/> <logger name="org.apache" level="WARN"/> <logger name="org.springboot.sample" level="INFO"/> <logger name="javax.activation" level="WARN"/> <logger name="org.mybatis.spring" level="INFO"/> <root level="INFO"> <appender-ref ref="console"/> <appender-ref ref="debug"/> <appender-ref ref="error"/> <appender-ref ref="info"/> root> configuration>