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 #设置输出格式