• logback.xml配置详解


    先附上本文分析用的例子:

     1 <?xml version="1.0" encoding="UTF-8" ?>
     2 <configuration>
     3     <appender name="logDirfile"
     4         class="ch.qos.logback.core.rolling.RollingFileAppender">
     5         <Prudent>true</Prudent>
     6         <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
     7             <FileNamePattern>
     8                 ../logs/java_logs/%d{yyyy-MM-dd_HH}/access.%d{yyyy-MM-dd}.log
     9             </FileNamePattern>
    10         </rollingPolicy>
    11         <filter class="ch.qos.logback.classic.filter.LevelFilter">
    12             <level>INFO</level>
    13             <onMatch>ACCEPT</onMatch>
    14             <onMismatch>DENY</onMismatch>
    15          </filter> 
    16         <layout class="ch.qos.logback.classic.PatternLayout">
    17             <Pattern>
    18                 %d{yyyy-MM-dd HH:mm:ss} -%msg%n
    19             </Pattern>
    20         </layout>
    21     </appender>
    22      
    23     <appender name="WarnLog" class="ch.qos.logback.core.rolling.RollingFileAppender"> 
    24         <Prudent>true</Prudent>
    25          <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
    26             <fileNamePattern>../logs/strength_logs/%d{yyyy-MM-dd_HH}/access.%d{yyyy-MM-dd}.log</fileNamePattern> 
    27          </rollingPolicy> 
    28         <filter class="ch.qos.logback.classic.filter.LevelFilter">
    29             <level>WARN</level>
    30             <onMatch>ACCEPT</onMatch>
    31             <onMismatch>DENY</onMismatch>
    32          </filter> 
    33          <encoder> 
    34            <pattern>%d{yyyy-MM-dd HH:mm:ss} -%msg%n</pattern> 
    35          </encoder> 
    36     </appender>
    37      
    38     <root level="info">
    39         <appender-ref ref="logDirfile"></appender-ref>
    40         <appender-ref ref="WarnLog"/>
    41     </root>
    42 </configuration>

    <appender>标签:

    <appender>是<configuration>的子节点,是负责写日志的组件。
    ​<appender>有两个必要属性name和class。name指定appender名称,class指定appender的全限定名。

    RollingFileAppender:

    滚动记录文件,先将日志记录到指定文件,当符合某个条件时,将日志记录到其他文件。有以下子节点:

    • <file>:被写入的文件名,可以是相对目录,也可以是绝对目录,如果上级目录不存在会自动创建,没有默认值。
    • <append>:如果是 true,日志被追加到文件结尾,如果是 false,清空现存文件,默认是true。
    • <encoder>:对记录事件进行格式化。
    • <rollingPolicy>:当发生滚动时,决定 RollingFileAppender 的行为,涉及文件移动和重命名。
    • <triggeringPolicy >: 告知 RollingFileAppender 合适激活滚动。
    • <prudent>:当为true时,不支持FixedWindowRollingPolicy。支持TimeBasedRollingPolicy,但是有两个限制,1不支持也不允许文件压缩,2不能设置file属性,必须留空。

    <rollingPolicy>标签:
    负责指定日志分包策略

    TimeBasedRollingPolicy:
    最常用的滚动策略,它根据时间来制定滚动策略,既负责滚动也负责触发滚动。有以下子节点:

    • <FileNamePattern>:
      必要节点,包含文件名及“%d”转换符, “%d”可以包含一个java.text.SimpleDateFormat指定的时间格式,如:%d{yyyy-MM}。如果直接使用 %d,默认格式是 yyyy-MM-dd。RollingFileAppender 的file字节点可有可无,通过设置file,可以为活动文件和归档文件指定不同位置,当前日志总是记录到file指定的文件(活动文件),活动文件的名字不会改变;如果没设置file,活动文件的名字会根据FileNamePattern的值,每隔一段时间改变一次。“/”或者“”会被当做目录分隔符。
    • <maxHistory>:
      可选节点,控制保留的归档文件的最大数量,超出数量就删除旧文件。假设设置每个月滚动,且<maxHistory>是6,则只保存最近6个月的文件,删除之前的旧文件。注意,删除旧文件时,那些为了归档而创建的目录也会被删除。

    例子:

    1 <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">  
    2     <fileNamePattern>E:/logs/mylog-%d{yyyy-MM-dd_HH-mm}.%i.log</fileNamePattern>
    3     <maxHistory>5</maxHistory>
    4      
    5     <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
    6         <maxFileSize>100MB</maxFileSize>
    7     </timeBasedFileNamingAndTriggeringPolicy>
    8 </rollingPolicy>

    分析:ch.qos.logback.core.rolling.TimeBasedRollingPolicy类实现的是基于时间的分包策略,分包间隔是根据fileNamePattern中指定的事件最小单位,比如例子中的%d{yyyy-MM-dd_HH-mm}的最小事件单位为分,它的触发方式就是1分钟,策略在每次向日志中添加新内容时触发,如果满足条件,就将mylog.txt复制到E:/logs/目录并更名为mylog-2010-06-22_13-13.1.log,并删除原mylog.txt。
    maxHistory的值为指定E:/logs目录下存在的类似mylog-2010-06-22_13-13.1.log文件的最大个数,当超过时会删除最早的文件。
    此外,分包策略还可以互相嵌套,比如本例中在时间策略中又嵌套了文件大小策略,ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP实现对单文件大小的判断,当超过maxFileSize中指定大大小时,文件名中的变量%i会加一,即在不满足时间触发且满足大小触发时,会生成mylog-2010-06-22_13-13.1.log和mylog-2010-06-22_13-13.2.log两个文件。


    <filter>标签:
    过滤器,执行一个过滤器会有返回个枚举值,即DENY,NEUTRAL,ACCEPT其中之一。
    返回DENY,日志将立即被抛弃不再经过其他过滤器;
    返回NEUTRAL,有序列表里的下个过滤器过接着处理日志;
    返回ACCEPT,日志会被立即处理,不再经过剩余过滤器。
    过滤器被添加到<Appender> 中,为<Appender> 添加一个或多个过滤器后,可以用任意条件对日志进行过滤。<Appender> 有多个过滤器时,按照配置顺序执行。

    下面是几个常用的过滤器:

    1. LevelFilter: 级别过滤器,根据日志级别进行过滤。如果日志级别等于配置级别,过滤器会根据onMath 和 onMismatch接收或拒绝日志。有以下子节点:
      <level>:设置过滤级别(INFO、WARN、ERROR)
      <onMatch>:用于配置符合过滤条件的操作
      <onMismatch>:用于配置不符合过滤条件的操作。例如:将过滤器的日志级别配置为INFO,所有INFO级别的日志交给appender处理,非INFO级别的日志,被过滤掉。
    2. ThresholdFilter: 临界值过滤器,过滤掉低于指定临界值的日志。当日志级别等于或高于临界值时,过滤器返回NEUTRAL;当日志级别低于临界值时,日志会被拒绝。
      例子:
       1 <configuration>
       2     <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">   
       3         <!-- 过滤掉 TRACE 和 DEBUG 级别的日志-->  
       4         <filter class="ch.qos.logback.classic.filter.ThresholdFilter">   
       5             <level>INFO</level>   
       6         </filter>   
       7         <encoder>
       8             <pattern>%-4relative [%thread] %-5level %logger{30} - %msg%n</pattern>   
       9         </encoder>   
      10     </appender>   
      11     <root level="DEBUG">   
      12         <appender-ref ref="CONSOLE" />   
      13     </root>   
      14 </configuration>
    3. EvaluatorFilter: 求值过滤器,评估、鉴别日志是否符合指定条件。
      例如:过滤掉所有日志消息中不包含“billing”字符串的日志:
       1 <configuration>
       2     <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">   
       3         <filter class="ch.qos.logback.core.filter.EvaluatorFilter">
       4             <evaluator>
       5                 <expression>return message.contains("billing");</expression>   
       6             </evaluator>   
       7             <OnMatch>ACCEPT</OnMatch>  
       8             <OnMismatch>DENY</OnMismatch>  
       9         </filter>
      10          
      11         <encoder>   
      12             <pattern>%-4relative [%thread] %-5level %logger - %msg%n</pattern>   
      13         </encoder>   
      14     </appender>   
      15  
      16     <root level="INFO">   
      17         <appender-ref ref="STDOUT" />   
      18     </root>   
      19 </configuration>

      <Pattern>标签:
      例如:<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} – %msg%n</pattern>

      含义:%d表示日期;%thread表示线程名;%-5level:级别从左显示5个字符宽度;%msg:日志消息;%n是换行符


      <root>标签:
      例如:<root level="info"><appender-ref ref="logDirfile"></appender-ref></root>
      含义:<root level="INFO">将root的打印级别设置为“INFO”,指定了名字为“logDirfile”的appender。
      当执行logback.LogbackDemo类的main方法时,root将级别为“INFO”及大于“INFO”的日志信息交给已经配置好的名为“logDirfile”的appender处理,“logDirfile”appender将信息打印到控制台。


      初始化logback 配置文件的代码:

       1 public static void initLogback() throws UnknownHostException{
       2         try {
       3             LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();
       4             JoranConfigurator configurator = new JoranConfigurator();
       5             configurator.setContext(lc);
       6             lc.reset();
       7             configurator.doConfigure("src/logback.xml");
       8         } catch (Exception e) {
       9             e.printStackTrace();
      10             System.err.println("logback 配置初始化报错,服务器关闭。");
      11             System.exit(0);
      12         }
      13     }
  • 相关阅读:
    servlet中Cookie的编码问题
    servlet关于转发用法
    eclipse界面更改为黑色
    猜字符小游戏——可以设置等级
    uva 10655
    uva11029
    UVA11388 GCD LCM1 2 -1
    uva 11609
    poj 2436
    poj 2431
  • 原文地址:https://www.cnblogs.com/xianDan/p/4292874.html
Copyright © 2020-2023  润新知