log4j.properties配置说明
在log4j中最重要的一步就是在log4j.properties中的配置,log4j.properties的配置格式为:
#配置根Logger
log4j.rootLogger = [ level ] , appenderName1 , appenderName2 , …
#以下代码为appenderName*的基本格式配置
----------------------------------------------------------------------------------------
#配置日志信息输出目的地Appender
log4j.appender.appenderName1 = fully.qualified.name.of.appender.class
log4j.appender.appenderName1.option1 = value1
…
log4j.appender.appenderName1.optionN = valueN
#配置日志信息的格式布局(layout)
log4j.appender.appenderName1.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName1.layout.option1 = value1
…
log4j.appender.appenderName1.layout.optionN = valueN
#配置日志信息输出目的地Appender
log4j.appender.appenderName2 = fully.qualified.name.of.appender.class
log4j.appender.appenderName2.option1 = value1
…
log4j.appender.appenderName2.optionN = valueN
#配置日志信息的格式布局(layout)
log4j.appender.appenderName2.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName2.layout.option1 = value1
…
log4j.appender.appenderName2.layout.optionN = valueN
-----------------------------------------------------------------------------------------
下面对日志配置的各个部分的设置项进行介绍:
全局日志等级配置,输出标准设置:
log4j.rootLogger = [ level ] , appenderName1 , appenderName2 , …
日志等级分为以下几级:
- off 最高等级,用于关闭所有日志记录。
- fatal 指出每个严重的错误事件将会导致应用程序的退出。
- error 指出虽然发生错误事件,但仍然不影响系统的继续运行。
- warm 表明会出现潜在的错误情形。
- info 一般和在粗粒度级别上,强调应用程序的运行全程。
- debug 一般用于细粒度级别上,对调试应用程序非常有帮助。
- all 最低等级,用于打开所有日志记录。
所以日志级别从低到高依次为:all<debug<info<warm<error<fatal<off
常用的只有debug、info、warm、error四个等级;
通过在这里定义的日志级别,您可以控制到应用程序中相应级别的日志信息的开关。比如在这里定义了INFO级别,则应用程序中所有DEBUG级别的日志信息将不被打印出来。
每个appenderName都要有相对应的设置包括Appender和Layout的配置:
log4j提供的Appender有以下几种:
- org.apache.log4j.ConsoleAppender(控制台),
- org.apache.log4j.FileAppender(文件),
- org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),
- org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件),
- org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
log4j提供的布局格式Layout有以下几种:
- org.apache.log4j.HTMLLayout(以HTML表格形式布局),
- org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
- org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
- org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
设置日志输出格式(layout.ConversionPattern):
- %m 输出代码中指定的消息
- %p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL
- %r 输出自应用启动到输出该log信息耗费的毫秒数
- %c 输出所属的类目,通常就是所在类的全名
- %t 输出产生该日志事件的线程名
- %n 输出一个回车换行符,Windows平台为“/r/n”,Unix平台为“/n”
- %d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss , SSS},输出类似:2002年10月18日 22 : 10 : 28 , 921
- %l 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main(TestLog4.java: 10 )
- 所以可以根据自己的需求配置自由搭配的输出格式,如:%-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
下面是一个log4j.properties配置同时生成debug级别、error级别日志文件和打印到控制台示例:
### 全局日志等级配置,输出标准设置 ###
log4j.rootLogger=debug,stdout,DDD,EEE
### 输出信息到控制台 ###
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=[%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
### 输出DEBUG 级别以上的日志到=/Users/tinybye/Documents/log4j/debug.log ###
log4j.appender.DDD=org.apache.log4j.DailyRollingFileAppender
log4j.appender.DDD.File=/Users/tinybye/Documents/log4j/debug.log
log4j.appender.DDD.Append=true
log4j.appender.DDD.Threshold=DEBUG
log4j.appender.DDD.layout=org.apache.log4j.PatternLayout
log4j.appender.DDD.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
### 输出ERROR 级别以上的日志到=/Users/tinybye/Documents/log4j/error.log ###
log4j.appender.EEE=org.apache.log4j.DailyRollingFileAppender
log4j.appender.EEE.File=/Users/tinybye/Documents/log4j/error.log
log4j.appender.EEE.Append=true
log4j.appender.EEE.Threshold=ERROR
log4j.appender.EEE.layout=org.apache.log4j.PatternLayout
log4j.appender.EEE.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
配置语句作用详解:
#全局日志等级配置,输出位置
#log4j.rootLogger = [ level ] , appenderName1 , appenderName2 , …
log4j.rootLogger=error, stdout,logfile
#stdout控制器(标准输出)
log4j.appender.stdout=org.apache.log4j.ConsoleAppender #设置Appender
log4j.appender.stdout.Target=System.out #设置输出目标
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout #设置布局
log4j.appender.stdout.layout.ConversionPattern=%d %p [%c]:%L - %m%n #设置输出格式
#输出日志文件
log4j.appender.logfile=org.apache.log4j.RollingFileAppender #设置Appender
log4j.appender.logfile.File=pss.log #默认输出到tomcat的根路径或者运行测试工程的根路径
log4j.appender.logfile.MaxFileSize=512KB #设置日志文件的最大内存大小
# Keep three backup files.
log4j.appender.logfile.MaxBackupIndex=3 #设置日志文件的最大数量,当日志文件达到最大指定内存时则另外再生成一个文件存放日志
log4j.appender.logfile.Append = true #ture则将日志信息增加到指定文件中,false则将日志信息覆盖指定文件内容,默认是true
log4j.appender.logfile.Threshold = ERROR #设置只输出ERROR级别以上的日志
# Pattern to output: date priority [category] - message
log4j.appender.logfile.layout=org.apache.log4j.PatternLayout #设置布局
log4j.appender.logfile.layout.ConversionPattern=%d %p [%c] - %m%n #设置输出格式