log4j2的介绍与使用（配置文件，路径等）

log4j2的介绍与使用（配置文件，路径等）

1. Log4j2的导入

首先到http://logging.apache.org/log4j/2.x/download.html 上下载最新的log4j2的jar包，
需要注意的是不要将所有jar都导入工程造成不必要的混乱。

2. 测试用例

  log4j 2.0的使用非常简单，只要用LogManager的getLogger函数获取一个logger，
  就可以使用logger记录日志，代码如下：

import org.apache.logging.log4j.LogManager;  
import org.apache.logging.log4j.Logger;  

public class HelloLog4j {  
    private static Logger logger = LogManager.getLogger("HelloLog4j");  
    public static void main(String[] args) {  
        MyApplication myApplication =  new MyApplication();  

        logger.entry();  
        logger.info("Hello, World!");   
        myApplication.doIt();  
        logger.error("Hello, World!");  
        logger.exit();  
    }  
}  

import org.apache.logging.log4j.LogManager;  
import org.apache.logging.log4j.Logger;  


public class MyApplication {  
    static Logger logger = LogManager.getLogger(MyApplication.class.getName());    

    public boolean doIt() {    
      logger.entry();   //Log entry to a method    
      logger.error("Did it again!");   //Log a message object with the ERROR level    
      logger.exit();    //Log exit from a method     
      return false;    
    }    
}  

运行程序，输出结果为：

16:10:28.672 [main] ERROR MyApplication - Did it again!  
16:10:28.672 [main] ERROR HelloLog4j - Hello, World!  

注意到，输出的log都是在ERROR level上的，log4j定义了8个级别的log（除去OFF和ALL，可以说分为6个级别），
优先级从高到低依次为：OFF、FATAL、ERROR、WARN、INFO、DEBUG、TRACE、 ALL。
如果将log level设置在某一个级别上，那么比此级别优先级高的log都能打印出来。
例如，如果设置优先级为WARN，那么OFF、FATAL、ERROR、WARN 4个级别的log能正常输出，
而INFO、DEBUG、TRACE、 ALL级别的log则会被忽略。从我们实验的结果可以看出，
log4j默认的优先级为ERROR或者WARN（实际上是ERROR）。

3. 配置文件及路径

log4j是apache的一个开源项目，在写这篇博客的时候已经发布了2.0的beta版本，
首先需要注意的是，log4j 2.0与以往的1.x有一个明显的不同，其配置文件只能
采用.xml, .json或者 .jsn。在默认情况下，
系统选择configuration文件的优先级如下：（classpath为scr文件夹）

classpath下名为 log4j-test.json 或者log4j-test.jsn文件
classpath下名为 log4j2-test.xml
classpath下名为 log4j.json 或者log4j.jsn文件
classpath下名为 log4j2.xml
必须注意.xml 文件的文件名为log4j2，这里让我纠结了一个下午，系统一直找不到配置文件，  
最后发现是文件名里面少了一个2。下面以log4j2.xml为例来介绍log4j的配置。（文末有指定log4j2.xml的路径的方法）

  
<configuration status="OFF">  
  <appenders>  
    <Console name="Console" target="SYSTEM_OUT">  
      <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>  
    Console>  
  appenders>  
  <loggers>  
    <root level="trace">  
      <appender-ref ref="Console"/>  
    root>  
  loggers>  
configuration>  

首先介绍loggers标签，用于定义logger的lever和所采用的appender，
其中appender-ref必须为先前定义的appenders的名称，
例如，此处为Console。那么log就会以appender所定义的输出格式来输出log。
root标签为log的默认输出形式，如果一个
类的log没有在loggers中明确指定其输出lever与格式，那么就会采用root中定义的格式。例如以下定义：

  
<configuration status="OFF">  
  <appenders>  
    <Console name="Console" target="SYSTEM_OUT">  
      <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>  
    Console>  
  appenders>  
  <loggers>  
    <logger name="com.relin.HelloLog4j" level="error" additivity="false">  
      <appender-ref ref="Console"/>  
    logger>  
    <root level="trace">  
      <appender-ref ref="Console"/>  
    root>  
  loggers>  
configuration>  

此时，HelloLog4j则会在error级别上输出log，而其他类则会在trace级别上输出log。
需要注意的是 additivity选项，如果设置为true（默认值）则HelloLog4j的log
会被打印两次，第二次打印是由于HelloLog4j同时也满足root里面定义的trace

4. 其他特征

    
<configuration status="error">    
  <appenders>    
    <Console name="Console" target="SYSTEM_OUT">    
      <ThresholdFilter level="trace" onMatch="ACCEPT" onMismatch="DENY"/>    
      <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/>    
    Console>    
    <File name="log" fileName="target/test.log" append="false">    
      <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/>    
    File>    
    <RollingFile name="RollingFile" fileName="logs/app.log"    
                 filePattern="logs/$${date:yyyy-MM}/app-%d{MM-dd-yyyy}-%i.log.gz">    
      <PatternLayout pattern="%d{yyyy.MM.dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/>    
      <SizeBasedTriggeringPolicy size="500 MB" />    
    RollingFile>    
  appenders>    
  <loggers>    
    <root level="trace">    
      <appender-ref ref="RollingFile"/>    
      <appender-ref ref="Console"/>    
    root>    
  loggers>    
configuration> 

扩展组件

1，ConsoleAppender

输出结果到System.out或是System.err。

2，FileAppender

输出结果到指定文件，同时可以指定输出数据的格式。append=“false”指定不追加到文件末尾

3，RollingFileAppender

自动追加日志信息到文件中，直至文件达到预定的大小，然后自动重新生成另外一个文件来记录之后的日志。

过滤标签

1，ThresholdFilter

用来过滤指定优先级的事件。

2，TimeFilter

设置start和end，来指定接收日志信息的时间区间。

路径

• 方式一 默认路径

将log4j2.xml放到src目录下，Log4j2默认会去该位置读取。

• 方式二 指定路径

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.core.LoggerContext;


..........//省略

       LoggerContext logContext = (LoggerContext) LogManager.getContext(false);
       File conFile = new File("conf/logs/log4j2.xml");
       logContext.setConfigLocation(conFile.toURI());
       logContext.reconfigure();
       logger.debug("hello world...{}","How are you");


........//省略

• 转自：

http://blog.csdn.net/lrenjun/article/details/8178875
http://www.cnblogs.com/yoyotl/p/6737733.html

• 附录

<Configuration status="WARN" monitorInterval="600">

    <Properties>
        
        <Property name="LOG_HOME">${sys:catalina.home}/WebAppLogs/SSHExampleProperty>
    Properties>

    <Appenders>

        
        <Console name="console_out_appender" target="SYSTEM_OUT">
            
            <ThresholdFilter level="warn" onMatch="DENY" onMismatch="ACCEPT"/>  
            
            <PatternLayout pattern="%5p [%t] %d{yyyy-MM-dd HH:mm:ss} (%F:%L) %m%n"/>
        Console>
        
        <Console name="console_err_appender" target="SYSTEM_ERR">
            
            <ThresholdFilter level="warn" onMatch="ACCEPT" onMismatch="DENY"/>
            
            <PatternLayout pattern="%5p [%t] %d{yyyy-MM-dd HH:mm:ss} (%F:%L) %m%n"/>
        Console>

        
        
        <RollingRandomAccessFile name="trace_appender"
                                 immediateFlush="true" fileName="${LOG_HOME}/trace.log"
                                 filePattern="${LOG_HOME}/trace/trace - %d{yyyy-MM-dd HH_mm_ss}.log.gz">
            <PatternLayout>
                <pattern>%5p [%t] %d{yyyy-MM-dd HH:mm:ss} (%F:%L) %m%npattern>
            PatternLayout>
            <Policies>

                
                <SizeBasedTriggeringPolicy size="2MB"/>

            Policies>
            <Filters>
                
                <ThresholdFilter level="debug" onMatch="DENY" onMismatch="NEUTRAL"/>  
                <ThresholdFilter level="trace" onMatch="ACCEPT" onMismatch="DENY"/> 
            Filters>
        RollingRandomAccessFile>

        
        
        <RollingRandomAccessFile name="debug_appender"
                                 immediateFlush="true" fileName="${LOG_HOME}/debug.log"
                                 filePattern="${LOG_HOME}/debug/debug - %d{yyyy-MM-dd HH_mm_ss}.log.gz">
            <PatternLayout>
                <pattern>%5p [%t] %d{yyyy-MM-dd HH:mm:ss} (%F:%L) %m%npattern>
            PatternLayout>
            <Policies>

                
                <SizeBasedTriggeringPolicy size="2MB"/>

                


            Policies>
            <Filters>
                
                <ThresholdFilter level="info" onMatch="DENY" onMismatch="NEUTRAL"/>  
                <ThresholdFilter level="debug" onMatch="ACCEPT" onMismatch="DENY"/> 
            Filters>
        RollingRandomAccessFile>

        
        <RollingRandomAccessFile name="info_appender"
                                 immediateFlush="true" fileName="${LOG_HOME}/info.log"
                                 filePattern="${LOG_HOME}/info/info - %d{yyyy-MM-dd HH_mm_ss}.log.gz">
            <PatternLayout>
                <pattern>%5p [%t] %d{yyyy-MM-dd HH:mm:ss} (%F:%L) %m%npattern>
            PatternLayout>
            <Policies>
                <SizeBasedTriggeringPolicy size="2MB"/>
            Policies>
            <Filters>
                <ThresholdFilter level="warn" onMatch="DENY" onMismatch="NEUTRAL"/>  
                <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/> 
            Filters>
        RollingRandomAccessFile>

        
        <RollingRandomAccessFile name="warn_appender"
                                 immediateFlush="true" fileName="${LOG_HOME}/warn.log"
                                 filePattern="${LOG_HOME}/warn/warn - %d{yyyy-MM-dd HH_mm_ss}.log.gz">
            <PatternLayout>
                <pattern>%5p [%t] %d{yyyy-MM-dd HH:mm:ss} (%F:%L) %m%npattern>
            PatternLayout>
            <Policies>
                <SizeBasedTriggeringPolicy size="2MB"/>
            Policies>
            <Filters>
                <ThresholdFilter level="error" onMatch="DENY" onMismatch="NEUTRAL"/>  
                <ThresholdFilter level="warn" onMatch="ACCEPT" onMismatch="DENY"/> 
              Filters>
        RollingRandomAccessFile>

        
        <RollingRandomAccessFile name="error_appender"
                                 immediateFlush="true" fileName="${LOG_HOME}/error.log"
                                 filePattern="${LOG_HOME}/error/error - %d{yyyy-MM-dd HH_mm_ss}.log.gz">
            <PatternLayout>
                <pattern>%5p [%t] %d{yyyy-MM-dd HH:mm:ss} (%F:%L) %m%npattern>
            PatternLayout>
            <Policies>
                <SizeBasedTriggeringPolicy size="2MB"/>
            Policies>
            <Filters>
                <ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY"/>
              Filters>
        RollingRandomAccessFile>
    Appenders>

    <Loggers>
        
        <root level="trace">
            <appender-ref ref="console_out_appender"/>
            <appender-ref ref="console_err_appender"/>
            <appender-ref ref="trace_appender"/>
            <appender-ref ref="debug_appender"/>
            <appender-ref ref="info_appender"/>
            <appender-ref ref="warn_appender"/>
            <appender-ref ref="error_appender"/>
        root>

        
        <logger name="org.springframework.core" level="info"/>
        <logger name="org.springframework.beans" level="info"/>
        <logger name="org.springframework.context" level="info"/>
        <logger name="org.springframework.web" level="info"/>
        <logger name="org.jboss.netty" level="warn"/>
        <logger name="org.apache.http" level="warn"/>

    Loggers>

Configuration>

附录2（按天）

<configuration status="error">
    <properties>
       <property name="filenameLog">/home/webservice/ftp_home/i6Dataproperty>
    properties>

    
    <appenders>
        
        <Console name="Console" target="SYSTEM_OUT">
            
            <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/>
        Console>

        
        <RollingFile name="RollingFileInfo" fileName="${filenameLog}logs/info.log"
                     filePattern="${filenameLog}/$${date:yyyy-MM}/info-%d{MM-dd-yyyy}-%i.log.gz">
            <PatternLayout pattern="%d{yyyy-MM-dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/>
            
            <filters>
                <ThresholdFilter level="error" onMatch="DENY" onMismatch="NEUTRAL"/>
                <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>
            filters>
            <Policies>
                <TimeBasedTriggeringPolicy modulate="true" interval="1"/>
                <SizeBasedTriggeringPolicy size="100MB"/>
            Policies>
        RollingFile>

      
        <RollingFile name="RollingFileDebug" fileName="${filenameLog}logs/debug.log"
                     filePattern="${filenameLog}/$${date:yyyy-MM}/debug-%d{MM-dd-yyyy}-%i.log.gz">
            <PatternLayout pattern="%d{yyyy-MM-dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/>
            <filters>
                <ThresholdFilter level="info" onMatch="DENY" onMismatch="NEUTRAL"/>
                <ThresholdFilter level="debug" onMatch="ACCEPT" onMismatch="NEUTRAL"/>
            filters>
            <Policies>
                <TimeBasedTriggeringPolicy modulate="true" interval="1"/>
                <SizeBasedTriggeringPolicy size="100MB"/>
            Policies>
        RollingFile>

        


        
        <RollingFile name="RollingFileError" fileName="${filenameLog}logs/error.log"
                     filePattern="${filenameLog}/$${date:yyyy-MM}/error-%d{MM-dd-yyyy}-%i.log.gz">
            <PatternLayout pattern="%d{yyyy-MM-dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/>
            <ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY"/>
            <Policies>
                <TimeBasedTriggeringPolicy modulate="true" interval="1"/>
                <SizeBasedTriggeringPolicy size="100MB"/>
            Policies>
        RollingFile>

    appenders>
    
    <loggers>
        
        <root level="ALL">
            <appender-ref ref="Console"/>
            <appender-ref ref="RollingFileInfo" />
            <appender-ref ref="RollingFileDebug"/>
            <appender-ref ref="RollingFileError"/>
        root>
    loggers>
configuration>