logger 配置文件详解

Logback配置文件详解

Logback，Java 日志框架。

Logback 如何加载配置的

1. logback 首先会查找 logback.groovy 文件
2. 当没有找到，继续试着查找 logback-test.xml 文件
3. 当没有找到时，继续试着查找 logback.xml 文件
4. 若是仍然没有找到，则使用默认配置（打印到控制台）

 

configuration

configuration 是配置文件的根节点，他包含的属性：

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

<configuration scan="true" scanPeriod="60 seconds" debug="false"> 
 <!-- 其余配置省略--> 
</configuration> 

 

configuration 的子节点

设置上下文名称：contextName

每一个 logger 度关联到 logger 上下文，默认上下文名称为 “default”。能够经过设置 contextName 修改上下文名称，用于区分不一样应该程序的记录

<configuration scan="true" scanPeriod="60 seconds" debug="false"> 
 <contextName>myAppName</contextName> 
 <!-- 其余配置省略--> 
</configuration>

 

设置变量：property

用于定义键值对的变量， property 有两个属性 name 和 value，name 是键，value 是值，经过 property 定义的键值对会保存到logger 上下文的 map 集合内。定义变量后，可使用 “${}” 来使用变量

<configuration scan="true" scanPeriod="60 seconds" debug="false"> 
 <property name="APP_Name" value="myAppName" /> 
 <contextName>${APP_Name}</contextName> 
 <!-- 其余配置省略--> 
</configuration> 

 

获取时间戳字符串：timestamp

timestamp 有两个属性，key：标识此 timestamp 的名字；datePattern：时间输出格式，遵循SimpleDateFormat 的格式

<configuration scan="true" scanPeriod="60 seconds" debug="false"> 
 <timestamp key="bySecond" datePattern="yyyyMMdd'T'HHmmss"/> 
 <contextName>${bySecond}</contextName> 
 <!-- 其余配置省略--> 
</configuration> 

 

logger

logger 有两种级别，一种是 root，一种是普通的 logger，logger 是用来设置某一个包或者具体的某一个类的日志打印机级别，以及制定的 appender。 
logger 有三个属性

• name：用来指定此 logger 约束的某一个包或者具体的某一个类
• level：用来设置打印机别，
• addtivity：是否向上级 logger 传递打印信息。默认是 true

每一个 logger 都有对应的父级关系，它经过包名来决定父级关系，root 是最高级的父元素。 
下面定义了四个 logger，他们的父子关系从小到大为： 
com.lwc.qg.test.logbackDemo → com.lwc.qg.tes → com.lwc.qg → root

<!-- 根 logger -->
 <root level="info">
 <appender-ref ref="STDOUT"/>
 </root>

 <!--
 普通的 logger
 name：类名或包名，标志该 logger 与哪一个包或哪一个类绑定
 level：该 logger 的日志级别
 additivity：是否将日志信息传递给上一级
 -->
 <logger name="com.lwc.qg.test.logbackDemo" level="debug" additivity="true">
 <appender-ref ref="STDOUT"/>
 </logger>

 <logger name="com.lwc.qg.test" level="info" additivity="true">
 <appender-ref ref="STDOUT"/>
 </logger>

 <logger name="com.lwc.qg" level="info" additivity="true">
 <appender-ref ref="STDOUT"/>
 </logger>

　　从该种级别来看，若是此时在最低层的 logger 输出日志信息，以该配置做为基础，它将会向父级的全部 logger 依次传递，因此按理来讲一个打印信息将会打印四次

　　从控制台上看，的确每条日志信息都被打印出了四次，可是细心从配置文件上来看，root 的日志级别配置的为 info，可是却输出 debug 级别的日志信息，因此从测试结果能够看出，向上传递的日志信息的日志级别将由最底层的子元素决定（最初传递信息的 logger），由于子元素设置的日志级别为 debug，因此也输出了 debug 级别的信息。 
　　所以，从理论上来讲，若是子元素日志级别设置高一点，那么也将会只输出高级别的日志信息。实际上也是如此，若是咱们把 com.lwc.qg.test.logbackDemo 对应的 logger 日志级别设为 warn，那么将只会输出 warn 及其以上的信息

 

root

root 也是 logger 元素，但它是根 logger。只有一个 level 属性

 

appender

appender 是负责写日志的组件，经常使用的组件有：

• ConsoleAppender
• FileAppender
• RollingFileAppender

 

ConsoleAppender

控制台日志组件，该组件将日志信息输出到控制台,该组件有如下节点

• encoder：对日志进行格式化
• target：System.out 或者 System.err，默认是 System.out

<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> 
 <encoder> 
 <pattern>%-4relative [%thread] %-5level %logger{35} - %msg %n</pattern> 
 </encoder> 
 <target>System.out</target> 
 </appender> 

 

FileAppender

文件日志组件，该组件将日志信息输出到日志文件中，该组件有如下节点

• file：被写入的文件名，能够是相对路径，也能够是绝对路径。若是上级目录不存在会自动建立，没有默认值
• append：若是是 true，日志被追加到文件结尾；若是是 false，清空现存文件，默认是 true。
• encoder：格式化
• prudent：若是是 true，日志会被安全的写入文件，即便其余的 FileAppender 也在向此文件作写入操做，效率低，默认是 false。

<appender name="FILE" class="ch.qos.logback.core.FileAppender">
 <file>testFile.log</file>
 <append>true</append>
 <encoder>
 <pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern>
 </encoder>
 <prudent>true</prudent>
 </appender>

 

RollingFileAppender

滚动记录文件日志组件，先将日志记录记录到指定文件，当符合某个条件时，将日志记录到其余文件，该组件有如下节点

• file：文件名
• encoder：格式化
• rollingPolicy：当发生滚动时，决定 RollingFileAppender 的行为，涉及文件移动和重命名
• triggeringPolicy：告知 RollingFileAppender 合适激活滚动
• prudent：当为true时，不支持FixedWindowRollingPolicy。支持TimeBasedRollingPolicy，可是有两个限制，1不支持也不容许文件压缩，2不能设置file属性，必须留空。

 

rollingPolicy

滚动策略

1. TimeBasedRollingPolicy：最经常使用的滚动策略，它根据时间来制定滚动策略，即负责滚动也负责触发滚动，包含节点：

   • fileNamePattern：文件名模式
   • maxHistoury：控制文件的最大数量，超过数量则删除旧文件

2. FixedWindowRollingPolicy：根据固定窗口算法重命名文件的滚动策略，包含节点

   • minInedx：窗口索引最小值
   • maxIndex：串口索引最大值，当用户指定的窗口过大时，会自动将窗口设置为12
   • fileNamePattern：文件名模式，必须包含%i，命名模式为 log%i.log，会产生 log1.log，log2.log 这样的文件

3. triggeringPolicy：根据文件大小的滚动策略，包含节点

   • maxFileSize：日志文件最大大小

<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">

 <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
 <fileNamePattern>logFile.%d{yyyy-MM-dd}.log</fileNamePattern>
 <maxHistory>30</maxHistory>
 </rollingPolicy>

 <encoder>
 <pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern>
 </encoder>
 </appender>

 

filter 过滤器

过滤器是用于日志组件中的，每通过一个过滤器都会返回一个确切的枚举值，分别是

• DENY：返回 DENY，日志将当即被抛弃再也不通过其余过滤器
• NEUTRAL：有序列表的下个过滤器接着处理日志
• ACCEPT：日志会被当即处理，再也不通过剩余过滤器

 

经常使用过滤器

经常使用的过滤器有如下：

• LevelFilter 
  级别过滤器，根据日志级别进行过滤。若是日志级别等于配置级别，过滤器会根据 omMatch 和 omMismatch 接受或拒绝日志。他有如下节点 
  　　level：过滤级别 
  　　onMatch：配置符合过滤条件的操做 
  　　onMismatch：配置不符合过滤条件的操做 
  例：该组件设置一个 INFO 级别的过滤器，那么全部非 INFO 级别的日志都会被过滤掉　　

<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> 
 <filter class="ch.qos.logback.classic.filter.LevelFilter">
 <level>INFO</level>
 <onMatch>ACCEPT</onMatch>
 <onMismatch>DENY</onMismatch>
 </filter>
 <encoder> 
 <pattern>%-4relative [%thread] %-5level %logger{35} - %msg %n</pattern> 
 </encoder> 
 <target>System.out</target> 
 </appender> 

• ThresholdFilter 
  临界值过滤器，过滤掉低于指定临界值的日志。当日志级别等于或高于临界值时，过滤器会返回 NEUTRAL；当日志级别低于临界值时，日志会被拒绝 
  例：过滤掉全部低于 INFO 级别的日志

<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> 
 <filter class="ch.qos.logback.classic.filter.ThresholdFilter"> 
 <level>INFO</level> 
 </filter>
 <encoder> 
 <pattern>%-4relative [%thread] %-5level %logger{35} - %msg %n</pattern> 
 </encoder> 
 <target>System.out</target> 
 </appender> 

• EvaluatorFilter 求值过滤器，评估、鉴别日志是否符合指定条件，包含节点： 　　evaluator：鉴别器，经过子标签 expression 配置求值条件 　　onMatch：配置符合过滤条件的操做 　　onMismatch：配置不符合过滤条件的操做