logback.xml 配置详解

<?xml version="1.0" encoding="UTF-8">

<configuration>

    <!-- 设置控制台日志输出格式 -->
    <appender name="consoleLog" class="ch.qos.logback.core.ConsoleAppender">
        <layout class="ch.qos.logback.classic.PatternLayout">
            <pattern>
                %d - %msg%n
            </pattern>
        </layout>
    </appender>

    <!-- 设置记录除ERROR日志的文件 -->    
    <appender name="fileInfoLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 过滤方式：匹配过滤，对匹配到的日志执行匹配策略 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <!-- 匹配级别 -->
            <level>ERROR</level>
            <!-- 匹配到的执行策略 -->
            <onMatch>DENY</onMatch>
            <!-- 不匹配的执行策略 -->
            <onMismatch>ACCEPT</onMismatch>
        </filter>
        <encoder>
            <pattern>
                %msg%n
            </pattern>
        </encoder>
        <!-- 滚动策略 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 路径 -->
            <fileNamePattern>/var/log/tomcat/sell/info.%d.log</fileNamePattern>
        </rollingPolicy>
    </appender>

    <!-- 设置记录ERROR日志的文件 -->
    <appender name="fileErrorLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 过滤方式：门槛过滤，只记录ERROR级别以上的日志 -->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>ERROR</level>
        </filter>
        <encoder>
            <pattern>
                %msg%n
            </pattern>
        </encoder>
        <!-- 滚动策略 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 路径 -->
            <fileNamePattern>/var/log/tomcat/sell/error.%d.log</fileNamePattern>
        </rollingPolicy>
    </appender>

    <root>
        <appender-ref ref="consoleLog">
        <appender-ref ref="fileInfoLog">
        <appender-ref ref="fileErrorLog">
    </root>

</configuration>

• 根节点<configuration>
  • scan: 当此属性设置为true时，配置文件如果发生改变，将会被重新加载。默认值为true。
  • scanPeriod: 设置监测配置文件是否有修改的时间间隔，如果没有给出时间单位，默认单位是毫秒。当scan为true时，此属性生效。默认的时间间隔为1分钟。
  • debug: 当此属性设置为true时，将打印出logback内部日志信息，实时查看logback运行状态。默认值为false。
  • <contextName>: 每个logger都关联到logger上下文，默认上下文名称为“default”。但可以使用设置成其他名字，用于区分不同应用程序的记录。一旦设置，不能修改,可以通过%contextName来引用日志上下文名称
  • <property>: 用来定义变量值的标签,通过定义的值会被插入到logger上下文中。定义变量后，可以使 ${} 来使用变量。
  • <appender>: 用来格式化日志输出节点，
    有两个属性 name 和 class，class 用来指定哪种输出策略，常用就是：
  • 控制台输出策略(class = ch.qos.logback.core.ConsoleAppender)
    • <layout>
      • class = ch.qos.logback.classic.PatternLayout: 控制台日志输出模式
      • <pattern>: 设置日志记录行格式
  • 文件输出策略(class = ch.qos.logback.core.rolling.RollingFileAppender)
    常见的日志输出到文件，随着应用的运行时间越来越长，日志也会增长的越来越多，将他们输出到同一个文件并非一个好办法，ch.qos.logback.core.rolling.RollingFileAppender 用于切分文件日志
    • <filter>
      • class = ch.qos.logback.classic.filter.LevelFilter: 匹配过滤，对匹配到的日志执行匹配策略
      • <level>: 匹配级别
      • <onMatch>: 匹配到的执行策略
      • <onMisMatch>: 不匹配的执行策略
      • class = ch.qos.logback.classic.filter.ThresholdFilter: 门槛过滤，只记录级别以上的日志
      • <level>: 匹配级别
    • <encoder>
      • <pattern>: 设置日志记录行格式
    • <rollingPolicy>
      • class = ch.qos.logback.core.rolling.TimeBasedRollingPolicy: 根据时间来分割日志文件，每天生成一个，这样可能每天的日志文件的大小不固定
      • class = ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy: 根据文件大小来分割，每达到maxFileSize就分割出来一个文件
      • class = ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy: 同时按照每天和大小来分割日志文件, 这种方式pattern中必须包含 %d 和%i。
      • <fileNamePattern>: 定义分隔的日志文件的名称规则
      • <maxHistory>: 表示只保留最近N天的日志，以防止日志填满整个磁盘空间
      • <totalSizeCap>: 指定日志文件的上限大小，例如设置为1GB的话，那么到了这个值，就会删除旧的日志
  • <root>: 用来指定最基础的日志输出级别，可以包含零个或多个 <appender-ref>，标识这个appender将会添加到这个logger。
    • level: 用来设置打印级别，大小写无关：TRACE， DEBUG， INFO， WARN，ERROR， ALL 和 OFF
    • <appender-ref>
      • ref: 指向 <appender> 的 name 属性
  • <logger>: 用来设置某一个包或者具体的某一个类的日志打印级别，以及指定appender
    • name: 用来指定受此logger约束的某一个包或者具体的某一个类。
    • level: 用来设置打印级别，大小写无关：TRACE， DEBUG， INFO， WARN，ERROR， ALL 和 OFF，如果未设置此属性，那么当前logger将会继承上级的级别，所谓向上级传递就是是否使用root的配置
    • addtivity: 是否向上级logger传递打印信息。默认是true
    • <appender-ref>
      • ref: 指向 <appender> 的 name 属性

logback 异步输出日志

一般的日志配置方式是基于同步的，每次日志输出到文件都会进行一次磁盘 IO。采用异步写日志的方式而不让此次写日志发生磁盘 IO，阻塞线程从而造成不必要的性能损耗。异步输出日志的方式很简单，添加一个基于异步写日志的 appender，并指向原先配置的 appender 即可。

<!-- 异步输出 -->
<appender name="ASYNC-INFO" class="ch.qos.logback.classic.AsyncAppender">
	<!-- 不丢失日志，默认的，如果队列的 80% 已满，则会丢弃 TRACT、DEBUG、INFO 级别的日志 -->
	<discardingThreshold>0</discardingThreshold>
	<!-- 更改默认的队列的深度，该值会影响性能，默认值为 256 -->
	<queueSize>256</queueSize>
	<!-- 添加附加的 appender，最多只能添加一个 -->
	<appender-ref ref="INFO-LOG"/>
</appender>