Log4j XML 配置说明

Appender

Appender:日志输出器,配置日志的输出级别、输出位置等,包括以下几类:

  • ConsoleAppender: 日志输出到控制台;
  • FileAppender:输出到文件;
  • RollingFileAppender:输出到文件,文件达到一定阈值时,自动备份日志文件;
  • DailyRollingFileAppender:可定期备份日志文件,默认一天一个文件,也可设置为每分钟一个、每小时一个;
  • WriterAppender:可自定义日志输出位置。

日志级别

  • 一般日志级别包括:ALL,DEBUG, INFO, WARN, ERROR,FATAL,OFF
  • Log4J推荐使用:DEBUG, INFO, WARN, ERROR

输出格式

  • %n - 换行
  • %m - 日志内容
  • %p - 日志级别(FATAL, ERROR,WARN, INFO,DEBUG or custom)
  • %r - 程序启动到现在的毫秒数
  • %t - 当前线程名
  • %d - 日期和时间, 一般使用格式 %d{yyyy-MM-dd HH: mm:ss, SSS}
  • %l - 输出日志事件的发生位置, 同 %F%L%C%M
  • %F - java 源文件名
  • %L - java 源码行数
  • %C - java 类名,%C{1} 输出最后一个元素
  • %M - java 方法名

代码示例

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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration PUBLIC "-//log4j/log4j Configuration//EN" "log4j.dtd">

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">

<!-- 日志输出到控制台 -->
<appender name="console" class="org.apache.log4j.ConsoleAppender">
<!-- 日志输出格式 -->
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%p][%d{yyyy-MM-dd HH:mm:ss SSS}][%c]-[%m]%n"/>
</layout>

<!--过滤器设置输出的级别-->
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<!-- 设置日志输出的最小级别 -->
<param name="levelMin" value="INFO"/>
<!-- 设置日志输出的最大级别 -->
<param name="levelMax" value="ERROR"/>
</filter>
</appender>


<!-- 输出日志到文件 -->
<appender name="fileAppender" class="org.apache.log4j.FileAppender">
<!-- 输出文件全路径名-->
<param name="File" value="/data/applogs/own/fileAppender.log"/>
<!--是否在已存在的文件追加写:默认时true,若为false则每次启动都会删除并重新新建文件-->
<param name="Append" value="false"/>
<param name="Threshold" value="INFO"/>
<!--是否启用缓存,默认false-->
<param name="BufferedIO" value="false"/>
<!--缓存大小,依赖上一个参数(bufferedIO), 默认缓存大小8K -->
<param name="BufferSize" value="512"/>
<!-- 日志输出格式 -->
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%p][%d{yyyy-MM-dd HH:mm:ss SSS}][%c]-[%m]%n"/>
</layout>
</appender>


<!-- 输出日志到文件,当文件大小达到一定阈值时,自动备份 -->
<!-- FileAppender子类 -->
<appender name="rollingAppender" class="org.apache.log4j.RollingFileAppender">
<!-- 日志文件全路径名 -->
<param name="File" value="/data/applogs/RollingFileAppender.log" />
<!--是否在已存在的文件追加写:默认时true,若为false则每次启动都会删除并重新新建文件-->
<param name="Append" value="true" />
<!-- 保存备份日志的最大个数,默认值是:1 -->
<param name="MaxBackupIndex" value="10" />
<!-- 设置当日志文件达到此阈值的时候自动回滚,单位可以是KB,MB,GB,默认单位是KB,默认值是:10MB -->
<param name="MaxFileSize" value="10KB" />
<!-- 设置日志输出的样式 -->`
<layout class="org.apache.log4j.PatternLayout">
<!-- 日志输出格式 -->
<param name="ConversionPattern" value="[%d{yyyy-MM-dd HH:mm:ss:SSS}] [%-5p] [method:%l]%n%m%n%n" />
</layout>
</appender>


<!-- 日志输出到文件,可以配置多久产生一个新的日志信息文件 -->
<appender name="dailyRollingAppender" class="org.apache.log4j.DailyRollingFileAppender">
<!-- 文件文件全路径名 -->
<param name="File" value="/data/applogs/own/dailyRollingAppender.log"/>
<param name="Append" value="true" />
<!-- 设置日志备份频率,默认:为每天一个日志文件 -->
<param name="DatePattern" value="'.'yyyy-MM-dd'.log'" />

<!--每分钟一个备份-->
<!--<param name="DatePattern" value="'.'yyyy-MM-dd-HH-mm'.log'" />-->
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%p][%d{HH:mm:ss SSS}][%c]-[%m]%n"/>
</layout>
</appender>



<!--
1. 指定logger的设置,additivity是否遵循缺省的继承机制
2. 当additivity="false"时,root中的配置就失灵了,不遵循缺省的继承机制
3. 代码中使用Logger.getLogger("mylogger")获得此输出器,且不会使用根输出器
参考下面继承配置的说明
-->
<logger name="mylogger" additivity="false">
<level value ="INFO"/>
<appender-ref ref="dailyRollingAppender"/>
</logger>


<!-- 根logger的设置,若代码中未找到指定的logger,则会根据继承机制,使用根logger-->
<root>
<appender-ref ref="console"/>
<appender-ref ref="fileAppender"/>
<appender-ref ref="rollingAppender"/>
<appender-ref ref="dailyRollingAppender"/>
</root>

</log4j:configuration>

测试程序

1
2
3
4
5
6
7
8
9
10
11
12
13
@Component
public class LogTest {
Logger logger = Logger.getLogger("mylogger");

@PostConstruct
public void test(){
for (int i=0; i<200; i++) {
logger.info(i + "----mylogger.Info----");
logger.info(i + "----mylogger.Info----");
logger.info(i + "----mylogger.Info----");
}
}
}

继承规则

Log4j是按照Logger的名称识别继承关系的,名称为 “com.foo”的logger是名称为 “com.foo.Bar”的父logger,同理”java” 是 “java.util” 父logger 是 “java.util.Vector”爷爷logger。
Log4j会根据名称按照层级超找配置,如果当前层级没有就会查找上层的配置,依次类推。
在上面的mylogger配置项中指定了dailyRollingAppender和INFO级别的Level,如果additivity为true,root logger也会同时输出内容,所以additivity设置为false,避免冗余的输出

参考Log4j2的Additivity说明 http://home.apache.org/~rpopma/log4j/2.6/manual/configuration.html#Additivity