1、到apache网站下载最新的log4j2的jar包,导入入log4j-api-2.0-beta5.jar和log4j-core-2.0-beta5.jar

 

2、用LogManager的getLogger函数获取一个logger,就可以使用logger记录日志,代码如下:

 

 
  
  1. import org.apache.logging.log4j.LogManager;  
  2. import org.apache.logging.log4j.Logger;  
  3.  
  4. public class Test {  
  5.     private static Logger logger = LogManager.getLogger("HelloWorld");  
  6.     public static void main(String[] args){  
  7.         Test.logger.info("hello,world");  
  8.         Test.logger.error("There is a error here");  
  9.     }  
  10.  
 
  
  1. import org.apache.logging.log4j.LogManager;  
  2. import org.apache.logging.log4j.Logger;  
  3.  
  4. public class HelloLog4j {  
  5.     private static Logger logger = LogManager.getLogger("HelloLog4j");  
  6.     public static void main(String[] args) {  
  7.         MyApplication myApplication =  new MyApplication();  
  8.           
  9.         logger.entry();  
  10.         logger.info("Hello, World!");   
  11.         myApplication.doIt();  
  12.         logger.error("Hello, World!");  
  13.         logger.exit();  
  14.     }  

 

 
  
  1. import org.apache.logging.log4j.LogManager;  
  2. import org.apache.logging.log4j.Logger;  
  3.  
  4.  
  5. public class MyApplication {  
  6.     static Logger logger = LogManager.getLogger(MyApplication.class.getName());    
  7.       
  8.     public boolean doIt() {    
  9.       logger.entry();   //Log entry to a method    
  10.       logger.error("Did it again!");   //Log a message object with the ERROR level    
  11.       logger.exit();    //Log exit from a method     
  12.       return false;    
  13.     }    
  14. }  

运行结果为:

 
  
  1. 16:10:28.672 [main] ERROR MyApplication - Did it again!  
  2. 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)。

 

log4j2的其配置文件只能采用.xml, .json或者 .jsn。在默认情况下,系统选择configuration文件的优先级如下:(classpath为src文件夹)System.setProperty("log4j.configurationFile", "配置文件名");

 

  1. classpath下名为 log4j2-test.json 或者log4j2-test.jsn文件
  2. classpath下名为 log4j2-test.xml
  3. classpath下名为 log4j2.json 或者log4j2.jsn文件
  4. classpath下名为 log4j2.xml
下面以log4j2.xml为例来介绍log4j的配置
 
  
  1. <?xml version="1.0" encoding="UTF-8"?> 
  2. <configuration status="OFF"> 
  3.   <appenders> 
  4.     <Console name="Console" target="SYSTEM_OUT"> 
  5.       <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/> 
  6.     </Console> 
  7.   </appenders> 
  8.   <loggers> 
  9.     <root level="trace"> 
  10.       <appender-ref ref="Console"/> 
  11.     </root> 
  12.   </loggers> 
  13. </configuration> 

首先介绍loggers标签,用于定义logger的lever和所采用的appender,其中appender-ref必须为先前定义的appenders的名称,例如,此处为Console。那么log就会以appender所定义的输出格式来输出log。

root标签为log的默认输出形式,如果一个类的log没有在loggers中明确指定其输出lever与格式,那么就会采用root中定义的格式。例如以下定义:
 
  
  1. <?xml version="1.0" encoding="UTF-8"?> 
  2. <configuration status="OFF"> 
  3.   <appenders> 
  4.     <Console name="Console" target="SYSTEM_OUT"> 
  5.       <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/> 
  6.     </Console> 
  7.   </appenders> 
  8.   <loggers> 
  9.     <logger name="com.relin.HelloLog4j" level="error" additivity="false"> 
  10.       <appender-ref ref="Console"/> 
  11.     </logger> 
  12.     <root level="trace"> 
  13.       <appender-ref ref="Console"/> 
  14.     </root> 
  15.   </loggers> 
  16. </configuration> 

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

其他

 
  
  1. <?xml version="1.0" encoding="UTF-8"?>    
  2. <configuration status="error">    
  3.   <appenders>    
  4.     <Console name="Console" target="SYSTEM_OUT">    
  5.       <ThresholdFilter level="trace" onMatch="ACCEPT" onMismatch="DENY"/>    
  6.       <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/>    
  7.     </Console>    
  8.     <File name="log" fileName="target/test.log" append="false">    
  9.       <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/>    
  10.     </File>    
  11.     <RollingFile name="RollingFile" fileName="logs/app.log"    
  12.                  filePattern="logs/$${date:yyyy-MM}/app-%d{MM-dd-yyyy}-%i.log.gz">    
  13.       <PatternLayout pattern="%d{yyyy.MM.dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/>    
  14.       <SizeBasedTriggeringPolicy size="500 MB" />    
  15.     </RollingFile>    
  16.   </appenders>    
  17.   <loggers>    
  18.     <root level="trace">    
  19.       <appender-ref ref="RollingFile"/>    
  20.       <appender-ref ref="Console"/>    
  21.     </root>    
  22.   </loggers>    
  23. </configuration>  

若是我们想去掉除com.foo.Bar以外所有的trace输出,我们可以增加一个新的注册事件,如下所示

 
  
  1. <?xml version="1.0" encoding="UTF-8"?> 
  2. <configuration status="OFF"> 
  3.   <appenders> 
  4.     <Console name="Console" target="SYSTEM_OUT"> 
  5.       <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/> 
  6.     </Console> 
  7.   </appenders> 
  8.   <loggers> 
  9.     <logger name="com.foo.Bar" level="trace" additivity="false"> 
  10.       <appender-ref ref="Console"/> 
  11.     </logger> 
  12.     <root level="error"> 
  13.       <appender-ref ref="Console"/> 
  14.     </root> 
  15.   </loggers> 
  16. </configuration> 

 

扩展组件

1,ConsoleAppender

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

2,FileAppender

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

3,RollingFileAppender

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

过滤标签

1,ThresholdFilter

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

2,TimeFilter

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

如何改变Log4j2的名称和路径?

如果想要改变默认的配置,那么就需要configuration file。Log4j的配置是写在log4j.properties文件里面,但是Log4j2就可以写在XML和JSON文件里了。

(1)放在classpath(src)下,以log4j2.xml命名

使用Log4j2的一般都约定俗成的写一个log4j2.xml放在src目录下使用。这一点没有争议。

(2)将配置文件放到别处

在系统工程里面,将log4j2的配置文件放到src目录底下很不方便。如果能把工程中用到的所有配置文件都放在一个文件夹里面,当然就更整齐更好管理了。但是想要实现这一点,前提就是Log4j2的配置文件能重新定位到别处去,而不是放在classpath底下。

可见,如果没有设置"log4j.configurationFile" system property的话,application将在classpath中按照如下查找顺序来找配置文件:

  log4j2-test.json 或log4j2-test.jsn文件

  log4j2-test.xml文件

  log4j2.json 或log4j2.jsn文件

  log4j2.xml文件

这就是为什么在src目录底下放log4j2.xml文件可以被识别的原因了。

如果想将配置文件重命名并放到别处,就需要设置系统属性log4j.configurationFile

设置的方式是在VM arguments中写入该属性的key和value:

-Dlog4j.configurationFile="D:\learning\blog\20130115\config\LogConfig.xml"

在myeclipse中,就是 右键-》run as -》run configuration-》右边窗口的“(x)=argument”=》VM arguments

然后写入上述key和value即可。

-D是参数,不能缺少。

或在程序中设置:

System.setProperty("log4j.configurationFile", "配置文件名");

例如,编辑配置文件

然后在myeclipse设置VM参数