# Log4J Settings for log4j 1.2.x (via jakarta-commons-logging)
#
# The five logging levels used by Log are (in order):
#
# 1. DEBUG (the least serious)
# 2. INFO
# 3. WARN
# 4. ERROR
# 5. FATAL (the most serious)
# Set root logger level to WARN and append to stdout
log4j.rootLogger = WARN, FILE, CONSOLE
log4j.appender.CONSOLE = org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.Threshold=DEBUG
log4j.appender.CONSOLE.Target=System.out
log4j.appender.CONSOLE.Encoding=GBK
log4j.appender.CONSOLE.layout = org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern = %d %5p (%c:%L) - %m%n
log4j.appender.FILE = org.apache.log4j.RollingFileAppender
log4j.appender.FILE.layout = org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern = %d %5p (%c:%L) - %m%n
log4j.appender.FILE.File = ./typical.log
log4j.appender.FILE.Append = true
log4j.appender.FILE.MaxFileSize = 10MB
log4j.appender.FILE.MaxBackupIndex = 10
#spring
log4j.rootCategory=INFO, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %t %c{2}:%L - %m%n
log4j.category.org.springframework.beans.factory=DEBUG
# Set the package specified log level.
log4j.logger.console=DEBUG
log4j.logger.com.hr.ssh=DEBUG
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=full name of appender’s class
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=full name of layout’s class
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-dd HH:mm:ss,SSS},可指定格式 如 %d{HH:mm:ss}
%l 输出日志事件发生位置,包括类目名、发生线程,在代码中的行数
%n 换行符
%m 输出代码指定信息,如info(“message”),输出message
%p 输出优先级,即 FATAL ,ERROR 等
%r 输出从启动到显示该log信息所耗费的毫秒数
%t 输出产生该日志事件的线程名
由上可大致了解log4j.properties 文件了吧(通过以上几步已经是个配置文件了)。不过还有一些也应该了解:
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、level of a logger
与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
Logger name Assigned level Effective level
Root DEBUG DEBUG
chapter3 WARN WARN
chapter3.MyApp2 null WARN
chapter3.Foo null WARN
接着把上面的例子改动一下:
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 了
Logger name Assigned level Effective level
Root DEBUG DEBUG
chapter3 WARN WARN
chapter3.MyApp2 null WARN
chapter3.Foo DEBUG DEBUG
写了这么多相信也累了吧,那就休息下吧,这么多的内容好好消化理解,以后继续学习 : ) ,了解这些基础的东西还不够,如果想更深入的理解 推荐 log4j The Complete Manual.pdf