一 logback简介

      Logback是一个开源日志组件。Logback一般和SLF4结合起来使用。外层使用SLF4J,里面的实现是logback。什么意思，简单来说我们使用层看到的是SLF4J。我们使用的时候就是和SLF4J提供的一些api打交道。

      我们可能经常听到SLF4J,logback,log4j,logging这些个名词。下面我们用一个简单的图来解释下他们之间的关系之间的关系。我们用一个图来表述他们之间的关系。

log.png

• SLF4J: Simple Logging Facade for Java 简单日志门面，不是具体的日志解决方案，它只服务于各种各样的日志系统。换句话说SLF4J只是一个日志标准(按照我们程序员的思维，我们可以把它认为是接口)。并不是日志系统的具体实现。如果项目只有slf4j的包是没办法实现日志功能的，需要配合其他的实现框架比如logback，logback，log4j，logging等。
• Logback：logback框架完全按照slf4j的规范开发。是日志的具体实现框架。
• log4j：log4j不是按照slf4j标准来开发的，所以log4j需要一个中间适配器。
• logging: logging是jdk提供的一个日志框架，也不是按照slf4j标准来的，所以也需要一个总结适配器。才能兼容slf4j。

因为logback的使用不需要适配器，讲道理logback比其他需要中间适配器的日志框架要快。

二 logback配置文件

      logback使用最关键在配置文件的使用。因为在logbakc(包括其他的日志框架)的使用过程中，有很大一部分工作都是在配置文件上做文章的，比如需要输出什么级别的日志，日志文件怎么归档，打印日志文件的时候需要打印哪些信息等等。这些个东西都是通过logback的配置文件来定义的。

      logback的配置文件是一个xml格式的文件logback-test.xml或者logback.xml，读取配置文件的步骤：

• （1）尝试classpath下查找文件logback-test.xml
• （2）如果文件不存在，尝试查找logback.xml
• （3）如果两个文件都不存在，LogBack用BasicConfiguration自动对自己进行最小化配置，这样既实现了上面我们不需要添加任何配置就可以输出到控制台日志信息。

      logback配置文件是一个xml文件，根节点是configuration标签。如下就是一个完成的logback配置文件。

<?xml version="1.0" encoding="UTF-8"?>
<!--
   说明：
   1、日志级别及文件
       日志记录采用分级记录，级别与日志文件名相对应，不同级别的日志信息记录到不同的日志文件中
       例如：error级别记录到xxx-error-xxx.log（该文件为当前记录的日志文件），而xxx-error-xxx.x.log为归档日志，
       日志文件按日期记录，同一天内，若日志文件大小等于或大于2M，则按0、1、2...顺序分别命名
       例如xxx-error-2013-12-21.0.log
       其它级别的日志也是如此。
   2、文件路径
       若本地开发，以绝对路径指定，如：/Users/zhangboqing/Downloads/logs。
       若部署到服务器，则各个服务器约定一个固定的日志路径如/data/home/logs/【项目名】/
   3、Appender
       FILE-ALL对应所有级别，文件名以xxx-all-xxx.log形式命名
       FILE-ERROR对应error级别，文件名以xxx-error-xxx.log形式命名
       FILE-WARN对应warn级别，文件名以xxx-warn-xxx.log形式命名
       FILE-INFO对应info级别，文件名以xxx-info-xxx.log形式命名
       FILE-DEBUG对应debug级别，文件名以xxx-debug-xxx.log形式命名
       STDOUT将日志信息输出到控制上，为方便开发测试使用
-->

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

<configuration scan="true" scanPeriod="10 seconds">

    <!--
        子节点<property name="" value=""> ：用来定义变量值，它有两个属性name和value，通过<property>定义的值会被插入到logger上下文中，可以使“${}”来使用变量。
    -->
    <!--
        子节点<property resource=""/> ：用来引入外部属性文件，可以使“${}”来使用变量。
    -->
    <property name="APP_NAME" value="IoServer4J"/>
    <property name="LOG_DIR" value="./logs/${APP_NAME}"/>

    <property name="LOG_FILE_NAME" value="sys"/>
    <property name="ERROR_LOG_FILE_NAME" value="error"/>
    <property name="DB_LOG_FILE_NAME" value="db"/>

    <property name="logFileNamePattern" value="${LOG_FILE_NAME}_%d{yyyy-MM-dd}_%i"/>
    <property name="errorLogFileNamePattern" value="${ERROR_LOG_FILE_NAME}_%d{yyyy-MM-dd}_%i"/>
    <property name="dbLogFileNamePattern" value="${DB_LOG_FILE_NAME}_%d{yyyy-MM-dd}_%i"/>

    <!-- 注册转换器，颜色转化器 -->
    <!-- 彩色日志依赖的渲染类 -->
    <conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter"/>
    <conversionRule conversionWord="wex"
                    converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter"/>
    <conversionRule conversionWord="wEx"
                    converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter"/>

    <!-- 日志输出格式 -->
    <!--
    日志输出格式：
        %d:             表示日期时间，
        %5p:            级别从左显示5个字符宽度，
        ${PID:- }:      pid
        %15.20t:        线程名字(如果宽度不足15，左侧补空白；如果宽度超过20，从左侧截断)
        %logger{50}:    表示logger名字最长50个字符，否则按照句点分割
        %%-4L:          行号，保留后面四位字符宽度
        %m:             日志消息
        %n:             换行符
        ${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}:
-->
    <property name="consoleLayoutPattern"
              value="%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(%5p) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.20t]){faint} %clr(%-40.40logger{60} Line:%-4L){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}"/>

    <property name="fileLayoutPattern"
              value="%d{yyyy-MM-dd HH:mm:ss.SSS} %5p ${PID:- } --- [%15.20t] %-40.40logger{60} Line:%-4L : %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}"/>

    <!--
        子节点<contextName>：用来设置上下文名称，每个logger都关联到logger上下文，默认上下文名称为default。但可以使用<contextName>设置成其他名字，用于区分不同应用程序的记录。一旦设置，不能修改。
    -->
    <contextName>${APP_NAME}</contextName>

    <!--
        子节点<appender>：负责写日志的组件，它有两个必要属性name和class。name指定appender名称，class指定appender的全限定名
        class为ch.qos.logback.core.ConsoleAppender 把日志输出到控制台
        class为ch.qos.logback.core.FileAppender 把日志添加到文件
        class为ch.qos.logback.core.rolling.RollingFileAppender 滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件
    -->

    <!-- 控制台输出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <charset>UTF-8</charset>
            <pattern>${consoleLayoutPattern}</pattern>
        </encoder>
    </appender>

    <appender name="SYS_LOG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_DIR}/${LOG_FILE_NAME}.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_DIR}/${logFileNamePattern}.log.zip
            </fileNamePattern>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <charset>UTF-8</charset>
            <pattern>${fileLayoutPattern}</pattern>
        </encoder>
    </appender>

    <appender name="ERROR_LOG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_DIR}/${ERROR_LOG_FILE_NAME}.log</file>
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>ERROR</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_DIR}/${errorLogFileNamePattern}.log.zip
            </fileNamePattern>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
            <maxHistory>30</maxHistory><!-- days -->
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <charset>UTF-8</charset>
            <pattern>${fileLayoutPattern}</pattern>
        </encoder>
    </appender>

    <appender name="DB_LOG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_DIR}/${DB_LOG_FILE_NAME}.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_DIR}/${dbLogFileNamePattern}.log.zip
            </fileNamePattern>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
            <maxHistory>30</maxHistory><!-- days -->
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <charset>UTF-8</charset>
            <pattern>${fileLayoutPattern}</pattern>
        </encoder>
    </appender>

    <!--
        子节点<logger>：用来设置某一个包或者具体的某一个类的日志打印级别，以及指定<appender>,
        logger 仅有一个name属性，两个可选属性 level／additivity
            name：用来指定受此logger约束的某一个包或者具体的某一个类。
            level：用来设置打印级别，大小写无关，TRACE,DEBUG,INFO,WARE,ERROR,ALL和OFF,还有一个特俗值INHERITED
                    或者 同义词NULL，代表强制执行上级的级别。
            additivity:是否向上级logger传递打印信息。默认是true。
    -->

    <!-- db/sql logger -->
    <logger name="java.sql.Connection" level="warn" additivity="true">
        <appender-ref ref="DB_LOG"/>
    </logger>
    <logger name="java.sql.PreparedStatement" level="warn" additivity="true">
        <appender-ref ref="DB_LOG"/>
    </logger>
    <logger name="java.sql.Statement" level="warn" additivity="true">
        <appender-ref ref="DB_LOG"/>
    </logger>

    <!-- sql -->
    <logger name="com.pilot.ioserver.basic.biz.pbl.core.db.mapper" level="warn" additivity="true">
        <appender-ref ref="DB_LOG"/>
    </logger>

    <!-- 生产环境下，将此级别配置为适合的级别，以免日志文件太多或影响程序性能 -->
    <!--
        <root>元素也是<logger>元素,logger。只有一个level属性。
        root 元素配置根 logger。该元素有一个 level 属性。没有 name 属性，因为已经被命名为“root”
        <root>可以包含零个或多个<appender-ref>元素,标识这个appender将会添加到这个logger。
    -->
    <root level="warn">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
        <!-- 文件输出 -->
        <appender-ref ref="SYS_LOG"/>
        <!-- 错误日志 -->
        <appender-ref ref="ERROR_LOG"/>
    </root>
</configuration>

2.1 configuration

      configuration标签是logback文件的根目录。

2.1.1 configuration属性

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

      上述配置代码每隔60毫秒会检查logback配置文件是否有修改，如果有修改就重写加载。并且不会输出logback的内部日志。

2.1.2 configuration子节点

2.2 contextName

      contextName标签用于设置日志上下文名称，后面输出格式中可以通过定义%contextName来打印日志上下文名称。每个logger都关联到logger上下文，默认上下文名称为default。可以使用<contextName>设置成其他名字，用于区分不同的应用程序的记录。一旦设置，不能修改。

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

2.3 property

      property标签用来设置相关变量,通过key-value的方式配置，然后在后面的配置文件中通过 ${key}来访问。

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

2.4 timestamp

      timestamp标签用于获取时间戳字符串，有两个属性key和datePattern。

<configuration scan="true" scanPeriod="60 seconds" debug="false">
    <timestamp key="bySecond"datePattern="yyyyMMdd'T'HHmmss"></timestamp>
    <contextName>${bySecond}</contextName>
</configuration>

2.5 appender

      appender标签负责主要负责日志的输出以及格式化日志。当一个日志记录被触发的时候，logback会根据我们的配置信息把这个事件交给appender处理。appender有两个必要属性name和class。

appender属性

      append属性class设置的不同，append子节点也不同，所以这里我们直接看appender对应的class类型有哪些。

appender class 类型

      ConsoleAppender、FileAppender、RollingFileAppender。这几个appender是最常用的,我们对他们的使用做一个简单的介绍。

2.5.1 ConsoleAppender

      ConsoleAppender用于把日志输出到控制台。

      如下配置会把DEBUG级别的日志输出到控制台。

<configuration>

  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <!-- encoders are assigned the type
         ch.qos.logback.classic.encoder.PatternLayoutEncoder by default -->
    <encoder>
      <pattern>%-4relative [%thread] %-5level %logger{35} - %msg %n</pattern>
    </encoder>
  </appender>

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

      ConsoleAppender节点介绍。

2.5.2 FileAppender

      FileAppender用于把日志添加到文件。

      比如如下的配置会把DEBUG级别的日志输出到log-${bySecond}.txt文件。

<configuration>

  <!-- Insert the current time formatted as "yyyyMMdd'T'HHmmss" under
       the key "bySecond" into the logger context. This value will be
       available to all subsequent configuration elements. -->
  <timestamp key="bySecond" datePattern="yyyyMMdd'T'HHmmss"/>

  <appender name="FILE" class="ch.qos.logback.core.FileAppender">
    <!-- use the previously created timestamp to create a uniquely
         named log file -->
    <file>log-${bySecond}.txt</file>
    <encoder>
      <pattern>%logger{35} - %msg%n</pattern>
    </encoder>
  </appender>

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

      FileAppender节点介绍。

2.5.3 RollingFileAppender

      RollingFileAppender是对FileAppender的一个扩展。相较于它的父类，它的主要作用是滚动记录日志。先将日志文件指定到文件，当符合某个条件时，将日志记录到其他文件。所以这里有两个重要的点，一是什么时候滚动(触发triggeringPolicy)、二是发生滚动的时候怎么去保存文件(动作，策略rollingPolicy)。

      RollingFileAppender节点介绍。

RollingFileAppender子节点

2.5.3.1 rollingPolicy介绍

      rollingPolicy节点用于定义当发生日志切换时(发生日志滚动是)，RollingFileAppender的切换行为。例如日志文件名的修改。(RollingPolicy实际上就是负责日志文件的切换以及重命名的)。logback里面已经给我们提供个多种切换的实现类。下面我们对这些实现类做一个简单的介绍。

2.5.3.1.1 TimeBasedRollingPolicy

      是最受欢迎的日志滚动策略。它的滚动策略是基于时间的。根据时间触发滚动(fileNamePattern属性会解析到)，同时可以设置保留的文件的最大大小(超过最大大小就会把之前的覆盖掉)，以及最大保留的粒度(如果是触发保存是按天来的，可以设置最大保留多少天的日志。如果是月，可以设置最多保留多少月等等)。

注意，TimeBasedRollingPolicy已经包含了triggeringPolicy节点的功能。所以设置了rollingPolicy为TimeBasedRollingPolicy就不需要在设置triggeringPolicy了。

      比如如下的配置，会每天保存一个日志文件，并且最大保存30天的日志，同时限制所以日志文件的最大大小为3G。

<configuration>
  <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>logFile.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <!-- daily rollover -->
      <fileNamePattern>logFile.%d{yyyy-MM-dd}.log</fileNamePattern>

      <!-- keep 30 days' worth of history capped at 3GB total size -->
      <maxHistory>30</maxHistory>
      <totalSizeCap>3GB</totalSizeCap>

    </rollingPolicy>

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

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

      TimeBasedRollingPolicy属性介绍。

旧版本的logback里可以在TimeBasedRollingPolicy这个rollingPolicy下配置一个timeBasedFileNamingAndTriggeringPolicy（实现类为SizeAndTimeBasedFNATP）达到同时配置时间和文件大小的滚动策略；而在新版本里可以使用SizeAndTimeBasedRollingPolicy替代。

2.5.3.1.2 SizeAndTimeBasedRollingPolicy

      有时候你不仅想通过时间来规定滚动策略，还希望同时限制每个日志文件的大小。在TimeBasedRoolingPolicy中已经提供限制总日志文件的大小的功能，而SizeAndTimeBasedRollingPolicy提供了更为强大的针对单个日志文件的大小限制能力。

      比如如下的配置，按天触发日志的保存，同时限制了单个文件的大小。所以每天可能有多个日志文件。关于fileNamePattern的使用我们会在下文中讲到。

<configuration>
  <appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>mylog.txt</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
      <!-- rollover daily -->
      <fileNamePattern>mylog-%d{yyyy-MM-dd}.%i.txt</fileNamePattern>
       <!-- each file should be at most 100MB, keep 60 days worth of history, but at most 20GB -->
       <maxFileSize>100MB</maxFileSize>    
       <maxHistory>60</maxHistory>
       <totalSizeCap>20GB</totalSizeCap>
    </rollingPolicy>
    <encoder>
      <pattern>%msg%n</pattern>
    </encoder>
  </appender>


  <root level="DEBUG">
    <appender-ref ref="ROLLING" />
  </root>

</configuration>

      SizeAndTimeBasedRollingPolicy属性介绍，SizeAndTimeBasedRollingPolicy继承TimeBasedRollingPolicy就额外的多一个属性maxFileSize

2.5.3.1.3 FixedWindowRollingPolicy

      基于窗口大小的滚动策略。这个听起来可能有点难理解，其实说白了就是将归档日志文件到最大了就写到下一个文件里，而窗口大小就是最多允许多少份日志文件。要特别注意FixedWindowRollingPolicy是没有告知什么时候触发日志的保存的。所以FixedWindowRollingPolicy的使用需要配合triggeringPolicy标签一起使用，而且一般triggeringPolicy标签会设置SizeBasedTriggeringPolicy。

      比如如下的配置，保存DEBUG级别的日志，并且每5MB保存一个文件，窗口大小是1到3，当保存了3个归档文件后，将覆盖最早的日志。

<configuration>
  <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>test.log</file>

    <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
      <fileNamePattern>tests.%i.log.zip</fileNamePattern>
      <minIndex>1</minIndex>
      <maxIndex>3</maxIndex>
    </rollingPolicy>

    <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
      <maxFileSize>5MB</maxFileSize>
    </triggeringPolicy>
    <encoder>
      <pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern>
    </encoder>
  </appender>
        
  <root level="DEBUG">
    <appender-ref ref="FILE" />
  </root>
</configuration>

      FixedWindowRollingPolicy属性属性介绍。

特别要注意，如果rollingPolicy标签设置为FixedWindowRollingPolicy。一定要设置triggeringPolicy标签的内容。要不然是没办法触发保存日志的。

2.5.3.2 triggeringPolicy介绍

      triggeringPolicy标签设置的值用于告知RollingFileAppender什么时候触发滚动操作。上面rollingPolicy介绍的各种rollingPolicy类型里面，其实TimeBasedRollingPolicy和SizeAndTimeBasedRollingPolicy已经包含了triggeringPolicy的功能(会通过fileNamePattern属性解析出来)，只有FixedWindowRollingPolicy是没有triggeringPolicy功能的，所以FixedWindowRollingPolicy要设置triggeringPolicy。一般都是设置SizeBasedTriggeringPolicy。

      SizeBasedTriggeringPolicy只有一个属性，就是文件大小。当到达了设置的大小的时候RollingFileAppender就触发一次滚动操作。

2.6 filter

      logback的过滤器可以过滤记录日志的内容，执行一个过滤器会有返回个枚举值，即DENY，NEUTRAL，ACCEPT其中之一。从而将不符合条件的日志信息过滤掉。

• DENY: 日志将立即被抛弃不再经过其他过滤器。
• NEUTRAL: 有序列表里的下个过滤器过接着处理日志。
• ACCEPT: 日志会被立即处理，不再经过剩余过滤器。

      过滤器被添加到<Appender>中，为<Appender>添加一个或多个过滤器后，可以用任意条件对日志进行过滤。<Appender>有多个过滤器时，按照配置顺序执行。

      关于Filter的实现类有多种,这里我们主要讲两种:LevelFilter以及ThresholdFilter.

2.6.1 LevelFilter

      级别过滤器，根据日志级别进行过滤。如果日志级别等于配置级别，过滤器会根据onMath 和 onMismatch接收或拒绝日志。

      比如以下的配置，只接受ERROR级别的日志，非ERROR级别的日志都会被过滤掉。

    <appender name="ERROR_LOG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_DIR}/${ERROR_LOG_FILE_NAME}.log</file>
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>ERROR</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_DIR}/${errorLogFileNamePattern}.log.zip
            </fileNamePattern>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
            <maxHistory>30</maxHistory><!-- days -->
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <charset>UTF-8</charset>
            <pattern>${fileLayoutPattern}</pattern>
        </encoder>
    </appender>

2.6.2 ThresholdFilter

      临界值过滤器，过滤掉低于指定临界值的日志。ThresholdFilter只有一个level子节点可以设置。当日志级别等于或高于临界值时，过滤器返回NEUTRAL；当日志级别低于临界值时，日志会被拒绝。

      比如如下的配置，过滤掉TRACE和DEBUG级别的日志。

    <appender name="ERROR_LOG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_DIR}/${ERROR_LOG_FILE_NAME}.log</file>
        <!-- 过滤掉 TRACE 和 DEBUG 级别的日志-->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>INFO</level>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_DIR}/${errorLogFileNamePattern}.log.zip
            </fileNamePattern>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
            <maxHistory>30</maxHistory><!-- days -->
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <charset>UTF-8</charset>
            <pattern>${fileLayoutPattern}</pattern>
        </encoder>
    </appender>

2.6.3 EvaluatorFilter

      求值过滤器，评估、鉴别日志是否符合指定条件。需要额外的两个JAR包，commons-compiler.jar和janino.jar。

      这里注意下evaluator子节点的使用，。evaluator有个子标签<expression>，用于配置求值条件。求值表达式作用于当前日志，logback向求值表达式暴露日志的各种字段如下：

      比如如下的配置，过滤掉所有日志消息中不包含“billing”字符串的日志。

    <appender name="ERROR_LOG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_DIR}/${ERROR_LOG_FILE_NAME}.log</file>
        <filter class="ch.qos.logback.core.filter.EvaluatorFilter">
            <evaluator> <!-- 默认为 ch.qos.logback.classic.boolex.JaninoEventEvaluator -->
                <expression>return message.contains("billing");</expression>
            </evaluator>
            <OnMatch>ACCEPT </OnMatch>
            <OnMismatch>DENY</OnMismatch>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_DIR}/${errorLogFileNamePattern}.log.zip
            </fileNamePattern>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
            <maxHistory>30</maxHistory><!-- days -->
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <charset>UTF-8</charset>
            <pattern>${fileLayoutPattern}</pattern>
        </encoder>
    </appender>

2.7 logger，root

2.7.1 logger

      用来设置某一个包或者具体某一个类的日志打印级别，以及指定<appender>。什么意思。

      关于addtivity。如果addtivity设置为true，那么当前logger标签作用完之后，logger标签对应类或者包的父类，继续作用一直到root标签。如果addtivity设置为false，那么当前logger标签作用完之后就直接掐断了，不在继续往上走了。

      <loger>可以包含零个或多个<appender-ref>元素，标识这个appender将会添加到这个loger。<appender-ref>标签就是去指定日志的相应操作，不管是控制台输出,还是保存到文件，还是滚动日志输出啥的。

2.7.2 root

      <root>也是<loger>元素，但是它是根loger。只有一个level属性。用来设置打印级别。

root是不用指定包或者类的,我们可以简单的认为root指定了所有的包.

      这里要重点说下logger和root的关系。怕有些同学搞混掉.我们通过几个例子来说明。

2.7.3 root，logger关系

      关于root和logger之间的关系要重点讲下。当root和logger同时存在的时候。要特别注意logger和root标签两者最终的level；和logger标签是否设置了向上传递的属性。

• logger没有设置level,那么logger直接继承root的level(如果有多个logger并且logger直接有上下级关系的话，就一层一层往上)。
• logger设置了level，同时如果logger设置了向上传递的话(additivity="true")。那么root标签和logger相同的包也使用logger的level。

2.7.3.1 情况一

    <logger name="com.tuacy.logback"/>

    <root level="info">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
    </root>

      因为logger没有设置等级,直接继承root的等级.addtivity默认就是true向上传递.可以认为当com.tuacy.logback包里面某个类打印日志的时候使用的配置为.

    <logger name="com.tuacy.logback" level="info" additivity="true"/>

    <root level="info">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
    </root>

      logger没有设置appender-ref所以logger没啥用，不打印，这个时候只有root设置起作用，com.tuacy.logback包下面的类info,warn,error的日志都会打印出来。

2.7.3.2 情况二

    <logger name="com.tuacy.logback" additivity="false"/>

    <root level="info">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
    </root>

      logger没有设置等级，继承root的等级，additivity为false,不往上传递，root不作用。配置相当于

    <logger name="com.tuacy.logback" additivity="false"/>

      如果这个时候有com.tuacy.logback包或者子包有打印的时候，不会有任何打印信息。

2.7.3.3 情况三

    <logger name="com.tuacy.logback" level="error"/>

    <root level="info">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
    </root>

      logger和root都有设置等级取两者等级较高的。所以上述配置等价于

    <logger name="com.tuacy.logback" level="error" additivity="true"/>

    <root level="error">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
    </root>

      这个时候只有error级别的信息会打印出来，root也使用logger的level。注意，只是针对com.tuacy.logback包和他的子包root的等级改变了。其他的包root还是保持原来的level。

2.7.3.4 情况四

    <logger name="com.tuacy.logback" level="error" additivity="false"/>

    <root level="info">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
    </root>

      上述配置等价于

    <logger name="com.tuacy.logback" level="error" additivity="false"/>

      不会有打印的

2.7.3.5 情况五

    <logger name="com.tuacy.logback" level="error">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
    </logger>

    <root level="info">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
    </root>

      上述配置等价于

    <logger name="com.tuacy.logback" level="error">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
    </logger>

    <root level="error">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
    </root>

      会打印error级别的日志，而且会打印两次。logger的一次，root的一次。

2.7.3.6 情况六

    <logger name="com.tuacy.logback" level="error" additivity="false">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
    </logger>

    <root level="info">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
    </root>

      上述配置等价于

    <logger name="com.tuacy.logback" level="error" additivity="false">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE"/>
    </logger>

      所以只会打印一次error级别的日志信息。

2.8 日志模板配置

      日志模板配置，使用%为前缀让解析器识别特殊输出模式，然后以{}后缀结尾，内部指定相应的参数设置。

2.8.1 模板输入参数

      d,data可以配置额外的参数，用来确定日期格式。输出日志的打印日志，模式语法与java.text.SimpleDateFormat 兼容。

      c、lo、logger输出日志的logger名，可有一个整形参数，功能是缩短logger名，设置为0表示只输入logger最右边点符号之后的字符串

2.8.2 模板长度设置

      每个模板配置都是可以限制模长度的，上面介绍了模块可以设置那么多的输入参数，其实每个输入参数都是可以限制长度的。

三 spring boot项目使用logback

3.1 pom依赖

      在Spring Boot项目中要使用logback原则上是要添加spring-boot-starter-logging依赖的。

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </dependency>

但是因为我们使用Spring Boot肯定会添加

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

又因为spring-boot-starter里面已经包含了对于spring-boot-starter-logging的依赖，所以我们一般在项目中不用显示的添加spring-boot-starter-logging。

3.1 logback配置文件

      spring boot项目中使用logback.关于配置文件官方推荐使用的xml名字的格式为：logback-spring.xml而不是logback.xml(当然了,你也可以使用logback.xml)，因为带spring后缀的可以使用<springProfile>这个标签来控制比如生成环境还是调试环境。比如如下的配置分了对生成环境和开发环境做了一个简单的区分.

<configuration scan="true" scanPeriod="10 seconds">

...

    <!-- 生产环境下，将此级别配置为适合的级别，以免日志文件太多或影响程序性能 -->
    <!--
        <root>元素也是<logger>元素,logger。只有一个level属性。
        root 元素配置根 logger。该元素有一个 level 属性。没有 name 属性，因为已经被命名为“root”
        <root>可以包含零个或多个<appender-ref>元素,标识这个appender将会添加到这个logger。
    -->
    <springProfile name="dev">
        <root level="info">
            <!-- 控制台输出 -->
            <appender-ref ref="CONSOLE"/>
            <!-- 文件输出 -->
            <appender-ref ref="SYS_LOG"/>
            <!-- 错误日志 -->
            <appender-ref ref="ERROR_LOG"/>
        </root>
    </springProfile>
    <springProfile name="pro">
        <root level="warn">
            <!-- 控制台输出 -->
            <appender-ref ref="CONSOLE"/>
            <!-- 文件输出 -->
            <appender-ref ref="SYS_LOG"/>
            <!-- 错误日志 -->
            <appender-ref ref="ERROR_LOG"/>
        </root>
    </springProfile>
</configuration>