Log4j

建一个Maven简单项目 

pom.xml引入log4j

1
2
3
4
5
<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>


log4j.properties(把Debug信息输出到控制台和本地文件   指定布局格式以及输出地址 

1
2
3
4
5
6
7
8
9
10
11
12
log4j.rootLogger=DEBUG, Console ,File  
   
#Console  
log4j.appender.Console=org.apache.log4j.ConsoleAppender  
log4j.appender.Console.layout=org.apache.log4j.PatternLayout  
log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n
   
#File
log4j.appender.File = org.apache.log4j.FileAppender
log4j.appender.File.File = C://log.log
log4j.appender.File.layout = org.apache.log4j.PatternLayout
log4j.appender.File.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n


Test.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
package com.open1111.log4j;
 
import org.apache.log4j.Logger;
 
/**
 * Log4j测试类
 * @author user
 *
 */
public class Test {
 
    private static Logger logger=Logger.getLogger(Test.class); // 获取logger实例
     
    public static void main(String[] args) {
        logger.info("普通Info信息");
        logger.debug("调试debug信息");
    }
}


运行输出:

2017-03-20 10:26:46,635 [main] INFO  [com.open1111.log4j.Test] - 普通Info信息

2017-03-20 10:26:46,636 [main] DEBUG [com.open1111.log4j.Test] - 调试debug信息

本地C盘也会有一个log.log日志文件 打开 也会有对应的日志信息;

Log4j日志等级

Log4j根据日志信息的重要程度,分OFF、FATAL、ERRORWARNINFODEBUG、ALL

Log4j官方建议实际使用只使用四个级别,优先级从高到低分别是 ERROR、WARN、INFO、DEBUG

假如rootLogger定义的是DEBUG 那所有的报错信息都会输出;

假如rootLogger定义的是INFO 那么DEBUG信息是不会输出的,其他信息输出;

假如rootLogger定义最高等级ERROR,那么只有ERROR信息会输出,其他低等级信息是不会输出的;

Log4j rootLogger配置

Log4j 根配置语法

1
log4j.rootLogger = [ level ] , appenderName, appenderName, …

指代 把指定级别的日志信息输出到指定的一个或者多个位置


Log4j appender输出类型配置

Log4j官方的appender给出了一下几种实现

    org.apache.log4j.ConsoleAppender(控制台),  

    org.apache.log4j.FileAppender(文件),  

    org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),  

    org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件),  

    org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)

实际开发我们使用第1,第3和第4种实现;

假如日志数据量不是很大,我们可以用DailyRollingFileAppender 每天产生一个日志,方便查看;

假如日志数据量很大,我们一般用RollingFileAppender,固定尺寸的日志,假如超过了 就产生一个新的文件;

    这里有两个新的配置项解释下:

    MaxFileSize 是日志文件的最大尺寸;根据实际需求来定 10KB 100KB也行

    MaxBackupIndex是日志文件的个数,假如超过了,则覆盖,主要考虑到的是硬盘的容量问题;根据实际需求来定 比如 100  500;


我们这里给出一些实例;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
log4j.rootLogger=DEBUG, Console ,File ,DailyRollingFile ,RollingFile
    
#Console  
log4j.appender.Console=org.apache.log4j.ConsoleAppender  
log4j.appender.Console.layout=org.apache.log4j.PatternLayout  
log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n
    
#File
log4j.appender.File = org.apache.log4j.FileAppender
log4j.appender.File.File = C://log2.log
log4j.appender.File.layout = org.apache.log4j.PatternLayout
log4j.appender.File.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n
 
#DailyRollingFile
log4j.appender.DailyRollingFile = org.apache.log4j.DailyRollingFileAppender
log4j.appender.DailyRollingFile.File = C://log3.log
log4j.appender.DailyRollingFile.layout = org.apache.log4j.PatternLayout
log4j.appender.DailyRollingFile.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n
 
#RollingFile
log4j.appender.RollingFile = org.apache.log4j.RollingFileAppender
log4j.appender.RollingFile.File = C://log4.log
log4j.appender.RollingFile.MaxFileSize=1KB
log4j.appender.RollingFile.MaxBackupIndex=3
log4j.appender.RollingFile.layout = org.apache.log4j.PatternLayout
log4j.appender.RollingFile.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n


测试代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
package com.open1111;
 
import org.apache.log4j.Logger;
 
public class Test {
 
    private static Logger logger=Logger.getLogger(Test.class); // 获取logger实例
     
    public static void main(String[] args) {
        logger.info("普通Info信息");
        logger.debug("调试debug信息");
        logger.error("报错error信息");
        logger.warn("警告warn信息");
        logger.fatal("严重错误fatal信息");
         
        logger.error("报错信息"new IllegalArgumentException("非法参数"));
        int i=0;
        while(i<10000){
            logger.debug(" RollingFile 调试debug信息");
            logger.debug(" RollingFile 调试debug信息");
            logger.debug(" RollingFile 调试debug信息");
            logger.debug(" RollingFile 调试debug信息");
            logger.debug(" RollingFile 调试debug信息");
            i++;
        }
    }
     
}


log4j layout日志信息格式

Log4j提供的layout有以下几种

    org.apache.log4j.HTMLLayout(以HTML表格形式布局),  

    org.apache.log4j.PatternLayout(可以灵活地指定布局模式),  

    org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),  

    org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)


HTMLLayout实例,我们把前面的实例的配置文件改下

1
2
3
#Console  
log4j.appender.Console=org.apache.log4j.ConsoleAppender  
log4j.appender.Console.layout=org.apache.log4j.HTMLLayout


PatternLayout是我们以后推荐使用的,很灵活;

有个ConversionPattern属性,灵活配置输出属性:

    %m 输出代码中指定的消息;

    %M 输出打印该条日志的方法名;

    %p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL;

    %r 输出自应用启动到输出该log信息耗费的毫秒数;

    %c 输出所属的类目,通常就是所在类的全名;

    %t 输出产生该日志事件的线程名;

    %n 输出一个回车换行符,Windows平台为"rn”,Unix平台为"n”;

    %d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,

    比如:%d{yyyy-MM-dd HH:mm:ss,SSS},输出类似:2002-10-18 22:10:28,921;

    %l 输出日志事件的发生位置,及在代码中的行数;


SimpleLayout简单布局:

1
2
3
#Console  
log4j.appender.Console=org.apache.log4j.ConsoleAppender  
log4j.appender.Console.layout=org.apache.log4j.SimpleLayout

运行输出:(只有级别和信息,确实简单

INFO - 普通Info信息

DEBUG - 调试debug信息

ERROR - 报错error信息

WARN - 警告warn信息

FATAL - 严重错误fatal信息

ERROR - 报错信息

java.lang.IllegalArgumentException: 非法参数

at com.open1111.Test.main(Test.java:16)


TTCCLayout我们测试下:

1
2
3
#Console  
log4j.appender.Console=org.apache.log4j.ConsoleAppender  
log4j.appender.Console.layout=org.apache.log4j.TTCCLayout

运行输出:

[main] INFO com.open1111.Test - 普通Info信息

[main] DEBUG com.open1111.Test - 调试debug信息

[main] ERROR com.open1111.Test - 报错error信息

[main] WARN com.open1111.Test - 警告warn信息

[main] FATAL com.open1111.Test - 严重错误fatal信息

[main] ERROR com.open1111.Test - 报错信息

java.lang.IllegalArgumentException: 非法参数

at com.open1111.Test.main(Test.java:16)

我们实际开发使用的是灵活的PatternLayout 其他的了解即可


Log4j Threshold属性指定输出等级


有时候我们需要把一些报错ERROR日志单独存到指定文件 ,这时候,Threshold属性就派上用场了;

Threshold属性可以指定日志level 

Log4j根据日志信息的重要程度,分OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL

比如我们指定某个appender的Threshold为WARN,那这个appender输出的日志信息就是WARN级别以及WARN以上的级别; 

假如我们指定的是ERROR,那这个就输出ERROR或者FATAL日志信息;

当然这里有个提前  rootLogger里配置的level比如小于Threshold层级  否则无效 还是按照总的rootLogger里的level来输出,一般我们实际实用的话 rootLogger里配置DEBUG,然后某个文件专门存储ERRO日志,就配置下Threshold为ERROR,这个就是我们的最佳实践,不要乱七八糟瞎配置;


我们给下参考配置:

log4j.rootLogger=DEBUG, Console ,DFile ,EFILE

#Console  

log4j.appender.Console=org.apache.log4j.ConsoleAppender  

log4j.appender.Console.layout=org.apache.log4j.TTCCLayout  

#DEBUGFile

log4j.appender.DFile = org.apache.log4j.FileAppender

log4j.appender.DFile.File = C://DEBUG.log

log4j.appender.DFile.layout = org.apache.log4j.PatternLayout

log4j.appender.DFile.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n

log4j.appender.DFile.Threshold = DEBUG

#ERRORFile

log4j.appender.EFILE = org.apache.log4j.FileAppender

log4j.appender.EFILE.File = C://ERROR.log

log4j.appender.EFILE.layout = org.apache.log4j.PatternLayout

log4j.appender.EFILE.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n

log4j.appender.EFILE.Threshold = ERROR


rootLogger里配置DEBUG,

DFile的Threshold 配置为DEBUG   

EFILE的Threshold 配置为ERROR 只输入ERROR信息;

ERROR.LOG只输出error信息;

Log4j Append属性指定是否追加内容


Log4j默认是不断的把日志内容追加到日志文件;

属性 Append 默认就是true;

假如我们设置成false 就不追加了 直接覆盖前面的内容;

这个属性我们了解下即可 用默认的true即可;


我们来测试下:

log4j.rootLogger=DEBUG, Console ,FIEL

#Console  

log4j.appender.Console=org.apache.log4j.ConsoleAppender  

log4j.appender.Console.layout=org.apache.log4j.TTCCLayout  

#FIEL

log4j.appender.FIEL = org.apache.log4j.FileAppender

log4j.appender.FIEL.File = C://log.log

log4j.appender.FIEL.layout = org.apache.log4j.PatternLayout

log4j.appender.FIEL.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n

log4j.appender.FIEL.Append = false


测试类:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
package com.open1111;
 
import org.apache.log4j.Logger;
 
public class Test {
 
    private static Logger logger=Logger.getLogger(Test.class); // 获取logger实例
     
    public static void main(String[] args) {
        logger.info("普通Info信息");
        logger.debug("调试debug信息");
        logger.error("报错error信息");
        logger.warn("警告warn信息");
        logger.fatal("严重错误fatal信息");
         
        logger.error("报错信息"new IllegalArgumentException("非法参数"));
         
    }
     
}


我们第一次执行:

Log4j


我们修改下测试代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
package com.open1111;
 
import org.apache.log4j.Logger;
 
public class Test {
 
    private static Logger logger=Logger.getLogger(Test.class); // 获取logger实例
     
    public static void main(String[] args) {
        logger.info("普通Info信息22222222222222");
        logger.debug("调试debug信息");
        logger.error("报错error信息");
        logger.warn("警告warn信息");
        logger.fatal("严重错误fatal信息");
         
        logger.error("报错信息222222222222222"new IllegalArgumentException("非法参数"));
         
    }
     
}

按照默认 Append true是追加的,

我们这里Append false结果是覆盖前面的

Log4j