logback日志配置

logback日志配置
==============================================================================================
例子:

<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="3 seconds">
    
    <property name="CATALINA_BASE" value="../logs"></property>
    
    <!-- 控制台输出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder charset="UTF-8">
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- 文件输出=每天产生一个文件-->
    <appender name="FILE1" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- daily rollover -->
            <fileNamePattern>${CATALINA_BASE}/aa.%d{yyyyMMdd}.log</fileNamePattern>
            <!-- keep 30 days' worth of history -->
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder charset="UTF-8">
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <appender name="FILE2" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${CATALINA_BASE}/bb.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${CATALINA_BASE}/bb.%d{yyyyMMdd}.log</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder charset="UTF-8">
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    
    <appender name="CUSTOM" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${CATALINA_BASE}/custom.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- daily rollover -->
            <fileNamePattern>${CATALINA_BASE}/custom.%d{yyyy-MM-dd}.log</fileNamePattern>
            <!-- keep 30 days' worth of history -->
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder charset="UTF-8">
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    
    <root level="ERROR">
        <appender-ref ref="CONSOLE" />
    </root>
    <logger name="com.taiyang.aa" level="DEBUG">
        <appender-ref ref="FILE1" />
    </logger>
    <logger name="com.taiyang.bb" level="INFO">
        <appender-ref ref="FILE2" />
    </logger>
    <!-- 自定义logger -->
    <logger name="custom" level="INFO">
        <appender-ref ref="CUSTOM" />
    </logger>
    
</configuration>

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

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

2：根节点<configuration>的子节点：

  

 2.1、设置变量：<property>
    <property name="CATALINA_BASE" value="../logs/app"></property><!--设置log路径-->
    定义变量后，可以使“${}”来使用变量。
  2.2、设置loger
 用来设置某一个包或者具体的某一个类的日志打印级别、以及指定<appender>。
 <loger>仅有一个name属性，一个可选的level和一个可选的addtivity属性。

  name:用来指定受此loger约束的某一个包或者具体的某一个类。
  level:用来设置打印级别，大小写无关：TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF，
       还有一个特俗值INHERITED或者同义词NULL，代表强制执行上级的级别。
       如果未设置此属性，那么当前loger将会继承上级的级别。
  addtivity:是否向上级loger传递打印信息。默认是true。
-------------------------------------------
 name可以是自定义的名称,例如:
 <logger name="data1" level="INFO">
        <appender-ref ref="FILES" />
 </logger>
 java中使用:
 private static Logger logger = LoggerFactory.getLogger("data1");
-------------------------------------------
<loger>可以包含零个或多个<appender-ref>元素，标识这个appender将会添加到这个loger。

-------------<root>
也是<loger>元素，但是它是根loger。只有一个level属性.
level:
用来设置打印级别，大小写无关：TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF，不能设置为INHERITED或者同义词NULL。
默认是DEBUG。
<root>可以包含零个或多个<appender-ref>元素，标识这个appender将会添加到这个loger。
2.3、<appender>
 <appender>是<configuration>的子节点，是负责写日志的组件。
 <appender>有两个必要属性name和class。name指定appender名称，class指定appender的类名。
  1.ConsoleAppender--控制台输出
   <encoder>：对日志进行格式化。

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

  2.FileAppender--文件输出
把日志添加到文件，有以下子节点：
<file>：被写入的文件名，可以是相对目录，也可以是绝对目录，如果上级目录不存在会自动创建，没有默认值。
<append>：如果是true，日志被追加到文件结尾，如果是false，清空现存文件，默认是true。
<encoder>：对日志进行格式化。
<prudent>：如果是true，日志会被安全的写入文件，即使其他的FileAppender也在向此文件做写入操作，效率低，默认是 false。

<configuration>      
    <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>  
        </appender>            
    <root level="DEBUG">  
        <appender-ref ref="FILE" />  
    </root>  
</configuration>  

  3.RollingFileAppender:
滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件。有以下子节点：
<file>：被写入的文件名，可以是相对目录，也可以是绝对目录，如果上级目录不存在会自动创建，没有默认值。
<append>：如果是true，日志被追加到文件结尾，如果是 false，清空现存文件，默认是true。
<encoder>：对记录事件进行格式化。
<rollingPolicy>:当发生滚动时，决定RollingFileAppender的行为，涉及文件移动和重命名。
<prudent>：当为true时，不支持FixedWindowRollingPolicy。支持TimeBasedRollingPolicy，但是有两个限制，1不支持也不允许文件压缩，2不能设置file属性，必须留空。
rollingPolicy：
1.TimeBasedRollingPolicy：最常用的滚动策略，它根据时间来制定滚动策略，既负责滚动也负责出发滚动。有以下子节点：
<fileNamePattern>:
必要节点，包含文件名及“%d”转换符，“%d”可以包含一个java.text.SimpleDateFormat指定的时间格式，如：%d{yyyy-MM}。
如果直接使用%d，默认格式是yyyy-MM-dd。
RollingFileAppender的 file子节点可有可无，
通过设置file，可以为活动文件和归档文件指定不同位置，
当前日志总是记录到file指定的文件（活动文件），活动文件的名字不会改变；
如果没设置file，活动文件的名字会根据fileNamePattern的值，每隔一段时间改变一次。“/”或者“\”会被当做目录分隔符。
<maxHistory>:
可选节点，控制保留的归档文件的最大数量，超出数量就删除旧文件。
假设设置每个月滚动，且<maxHistory>是6，则只保存最近6个月的文件，删除之前的旧文件。
注意，删除旧文件时，那些为了归档而创建的目录也会被删除。
2.SizeBasedTriggeringPolicy：查看当前活动文件的大小，如果超过指定大小会告知RollingFileAppender触发当前活动文件滚动。
只有一个节点:
<maxFileSize>:这是活动文件的大小，默认值是10MB。
 例如：每天生成一个日志文件，保存30天。

<configuration>   
      <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>     
      
      <root level="DEBUG">   
        <appender-ref ref="FILE" />   
      </root>   
    </configuration>  

 另外还有SocketAppender、SMTPAppender[邮件输出]、DBAppender[数据库输出]、SyslogAppender、SiftingAppender。

参考: http://blog.csdn.net/haidage/article/details/6794509

********************************************************************************************************************************

自定义Pattern模板

创建自定义格式转换符：

1.写一个转换器类，继承ClassicConvert

public class IpConvert extends ClassicConverter {   
    @Override  
    public String convert(ILoggingEvent event) {  
        return "10.10.10.10";  
    }  
}  

2.在logback.xml中注册该转换器，并自定义转换符
注册：

<conversionRule conversionWord="ip" converterClass="com.cj.log.IpConvert" />

自定义ip转换符使用：

<Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS}<span style="color:#FF0000;">%ip</span> [%thread] %-5level %logger{36} -% msg%n</Pattern>

--------------------------------------------------------------------------------------------------------------------------------------

上面的步骤只是基本的自定义模板方法，不好的地方就是要在配置文件里注册，

(注意：logback在项目启动时，会生成fileNamePattern定义的日志文件，想要在文件名中应用自定义的转换符ip，则加载不到。

日志文件名自定义转换符怎么做，后议吧。)

实际上只要模仿logback原生创建的方法把这个转换符加进去就可以了。
可以看下PatternLayout.java源码：

public class PatternLayout extends PatternLayoutBase<ILoggingEvent> {  
    public static final Map<String, String> defaultConverterMap = new HashMap<String, String>();  
    static {  
        defaultConverterMap.putAll(Parser.DEFAULT_COMPOSITE_CONVERTER_MAP);  
        defaultConverterMap.put("d",DateConverter.class.getName());  
        defaultConverterMap.put("date",DateConverter.class.getName());  
        defaultConverterMap.put("r",RelativeTimeConverter.class.getName());  
        defaultConverterMap.put("relative",RelativeTimeConverter.class.getName());  
         ...  

现在只需在这个static方法快里加上一句即可：

defaultConverterMap.put("ip",IpConvert.class.getName());

"ip"是转换的字符，IpConvert是上面定义的转换器类。
但如何添加进去呢？下面便是一种实现方案：

首先，定义一个类，该类继承PatternLayout.java：

 public class MyPatternLayout extends PatternLayout {  
    static {  
        defaultConverterMap.put("ip",IpConvert.class.getName());  
    }  
} 

直接调用父类的属性，将自定义的转换符添加进去。IpConvert便是上面已实现的转换器。

之后，便是在logback.xml中配置我们自定义的PatternLayout：
<!-- 日志输出格式 -->  

<layout class="com.cj.log.MyPatternLayout">  
  <Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %ip [%thread] %-5level %logger{36} -%msg%n</Pattern>  
</layout>

原先的layout的class类为"ch.qos.logback.classic.PatternLayout"，这里换成我们自定义的即可。

参考:http://blog.csdn.net/zhuyucheng123/article/details/21524529