[关闭]
@haokuixi 2015-05-18T09:25:25.000000Z 字数 2551 阅读 3068

log4j 配置详解

log4j


Log4j 的配置文件用来设置记录器的级别输出目的地布局,可以是 log4j.properties 或 log4j.xml。以下讲解以 log4j.properties 的配置方式进行。

配置文件的基本格式

基本格式如下:

  1. #配置根 Logger
  2. log4j.rootLogger = [ level ], appenderName1, appenderName2, ……
  3. #配置日志信息输出目的地 (Appender)
  4. log4j.appender.appenderName = fully.qualified.name.of.appender.class
  5. log4j.appender.appenderName.option1 = value1
  6. ……
  7. log4j.appender.appenderName.optionN = valueN
  8. #配置日志信息的格式 (Layout)
  9. log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
  10. log4j.appender.appenderName.layout.option1 = value1
  11. ……
  12. log4j.appender.appenderName.layout.optionN = valueN

Level

Level 是日志输出级别,共有5级:

名称 级别
FATAL 0
ERROR 3
WARN 4
INFO 6
DEBUG 7

Appender

Appender 为日志输出目的地,Log4j 提供的 appender 有以下几种:

ConsoleAppender 可配置项

解释
Threshold=DEBUG 指定日志消息的输出最低层次
ImmediateFlush=true 默认值是 true,意味着所有的消息都会被立即输出
Target=System.err 默认情况下是 System.out,指定输出控制台

FileAppender 可配置项

解释
Threshold=DEBUF 指定日志消息的输出最低层次
ImmediateFlush=true 默认值是 true,意味着所有的消息都会被立即输出
File=mylog.txt 指定消息输出到 mylog.txt 文件
Append=false 默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容

RollingFileAppender 可配置项

解释
Threshold=DEBUG 指定日志消息的输出最低层次。
ImmediateFlush=true 默认值是true,意味着所有的消息都会被立即输出。
File=mylog.txt 指定消息输出到mylog.txt文件。
Append=false 默认值是true即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。
MaxFileSize=100KB 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时,将会自动滚动,即将原来的内容移到mylog.log.1文件。
MaxBackupIndex=2 指定可以产生的滚动文件的最大数。

Layout

Layout 为日志输出格式,Log4j 提供的 layout 有以下几种:

Layout 示例

log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n
符号 意义
- 信息输出时左对齐
%p 输出日志信息优先级,即DEBUG,INFO,WARN,ERROR,FATAL
%d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},输出类似:2002年10月18日 22:10:28,921
%r 输出自应用启动到输出该log信息耗费的毫秒数
%c 输出日志信息所属的类,通常就是所在类的全名
%t 输出产生该日志事件的线程名
%l 输出日志事件的发生位置,相当于%C.%M(%F:%L)的组合,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main (TestLog4.java:10)
%x 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。
%% 输出一个"%"字符
%F 输出日志消息产生时所在的文件名称
%L 输出代码中的行号
%m 输出代码中指定的消息,产生的日志具体信息
%n 输出一个回车换行符,Windows平台为"\r\n",Unix平台为"\n"

修饰符

可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度和文本的对齐方式,如:

示例 表示
%20c 指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,默认的情况下右对齐。
%-20c 指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,"-"号指定左对齐。
%.30c 指定输出category的名称,最大的宽度是30,如果category的名称大于30的话,就会将左边多出的字符截掉,但小于30的话也不会有空格。
%20.30c 如果category的名称小于20就补空格,并且右对齐,如果其名称长于30字符,就从左边较远输出的字符截掉。
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注