Log4j的配置文件

SEG的命名空间

2012-02-14

Log4j支持两种配置文件格式，一种是java属性文件（键—值），一种是xml格式文件。

这里仅介绍下java属性文件的配置方法。

先看看个配置文件：log4j.properties

log4j.rootCategory=debug,stdout,R

log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] (%F:%L) -%m%n

log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%p %t %c -%m%n
#输出结果将写入 example.log
log4j.appender.R.File=example.log
log4j.appender.R.MaxFileSize=100KB
log4j.appender.R.MaxBackupIndex=1

1、Log4j.rootCategory=[level|null],appenderName,appenderName,….

level:是日记记录的优先级，优先级由高到低分为OFF,FATAL,ERROR,WARN,INFO,DEBUG,ALL。Log4j建议只使用FATAL,ERROR,WARN,INFO,DEBUG这四个级别。主意看到了null了吧，所以在这里可以为空。

appenderName:指定日志信息输出到哪个地方，可以同时指定多个输出目的地。

2、Appender的语法为：

log4j.appender.appenderName=fullnameofappender’sclass

log4j.appender.appenderName.kind=kind1

…

log4j.appender.appenderName.kind=kindN

有5种appender,分别为

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

org.apache.log4j.FileAppender(文件)

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

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

3、Layout的语法为：

log4j.appender.appenderName.layout=fullnameoflayout’sclass

log4j.appender.appenderName.layout.kind=kind

…

log4j.appender.appenderName.layout.kind=kindN

有4种layout,分别为

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

org.apache.log4j.PatternLayout（自定义布局）

org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串）

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

4、输出

都以%开始后面不同的参数代表不同的格式化信息（参数按字母表顺序列出）：

%c输出所属类的全名，可在修改为%d{Num},Num类名输出的范围如："org.apache.xyz.SomeClass",%C{2}将输出xyz.SomeClass

%d输出日志时间其格式为%d{yyyy-MM-ddHH:mm:ss,SSS}，可指定格式如%d{HH:mm:ss}

%l输出日志事件发生位置，包括类目名、发生线程，在代码中的行数

%n换行符

%m输出代码指定信息，如info(“message”),输出message

%p输出优先级，即FATAL,ERROR等

%r输出从启动到显示该log信息所耗费的毫秒数

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

5、Threshold的语法

log4j.threshold=level

level就是前面所说的OFF,FATAL,ERROR,WARN,INFO,DEBUG,ALL。Threshold是个全局的过滤器，它将把低于所设置的level的信息过滤不显示出来。

看一个例子：

log4j.rootLogger=DEBUG, CON
log4j.appender.CON=org.apache.log4j.ConsoleAppender
log4j.appender.CON.layout=org.apache.log4j.PatternLayout
log4j.appender.CON.layout.ConversionPattern=[%t] %-5p %c - %m%n
#Only print log statement of level WARN or above regardless of the（只打印warn级别以上的信息）
#logger.
log4j.threshold=WARN

Threshold的用法很灵活，还可以在appender中增加threshold

log4j.rootLogger=DEBUG, C
log4j.appender.C=org.apache.log4j.ConsoleAppender
# Set the appender threshold to INFO
log4j.appender.C.Threshold=INFO
log4j.appender.C.layout=org.apache.log4j.PatternLayout
log4j.appender.C.layout.ConversionPattern=%-4r [%t] %-5p %c %x - %m%n

这里初始设置level为DEBUG，但log4j.appender.C.Threshold=INFO设置为INFO。因为INFO>DEBUG所以如果含有DEBUG级别的信息，将被过滤。

6、levelofalogger

与threshold相似，不过过滤得不是全部，而是将其所过滤的范围缩小到loggers所指级别内。

同样看个例子（指定在chapter3包里面）

log4j.rootLogger=DEBUG, CON
log4j.appender.CON=org.apache.log4j.ConsoleAppender
log4j.appender.CON.layout=org.apache.log4j.PatternLayout
log4j.appender.CON.layout.ConversionPattern=[%t] %-5p %c - %m%n
# Print only messages of priority WARN or above in package "chapter3".
log4j.logger.chapter3=WARN

下面是说明chapter3包里面各个level

LoggernameAssignedlevelEffectivelevel

RootDEBUGDEBUG

chapter3WARNWARN

chapter3.MyApp2nullWARN

chapter3.FoonullWARN

接着把上面的例子改动一下：

log4j.rootLogger=DEBUG, CON
log4j.appender.CON=org.apache.log4j.ConsoleAppender
log4j.appender.CON.layout=org.apache.log4j.PatternLayout
log4j.appender.CON.layout.ConversionPattern=%d %-5p %c - %m%n
# Allow requests level WARN or above in "chapter3" package except in
# "chapter3.Foo" where DEBUG or above is allowed.
log4j.logger.chapter3=WARN
log4j.logger.chapter3.Foo=DEBUG

可以看到在最后一行增加了log4j.logger.chapter3.Foo=DEBUG

可以通过运行程序来查看效果（这里将不详细介绍程序）

Chapter3.Foo的级别已上升为DEBUG了

LoggernameAssignedlevelEffectivelevel

RootDEBUGDEBUG

chapter3WARNWARN

chapter3.MyApp2nullWARN

chapter3.FooDEBUGDEBUG

写了这么多相信也累了吧，那就休息下吧，这么多的内容好好消化理解，以后继续学习:)，了解这些基础的东西还不够，如果想更深入的理解推荐log4jTheCompleteManual.pdf

log4j log4j配置 apache