学习笔记：log4j.properties配置

示例：

log4j.debug=true   
log4j.rootLogger=DEBUG,stdout,D      //所有输出都会用到这里的appedder
log4j.logger.com.test.server=DEBUG,E //为特定的的包指定输出
//output log to console
log4j.appender.stdout=org.apache.log4j.ConsoleAppender   
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout     
log4j.appender.stdout.layout.ConversionPattern=%d %p [%c] - %m%n  

log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File = logs/logs.log
log4j.appender.E.Append = true
log4j.appender.E.Threshold = DEBUG
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = logs/error.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = ERROR
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

log4j.properties的配置参数

1. 基本格式如下：

#配置根Logger
log4j.rootLogger  =   [ level ]   ,  appenderName1 ,  appenderName2 ,  …

#配置日志信息输出目的地Appender
log4j.appender.appenderName  =  fully.qualified.name.of.appender.class 
　　log4j.appender.appenderName.option1  =  value1 
　　… 
　　log4j.appender.appenderName.optionN  =  valueN 

#配置日志信息的格式（布局）
log4j.appender.appenderName.layout  =  fully.qualified.name.of.layout.class 
　　log4j.appender.appenderName.layout.option1  =  value1 
　　… 
　　log4j.appender.appenderName.layout.optionN  =  valueN 

其中 [ level ]日志输出级别共有五级

• FATAL 0
• ERROR 3
• WARN 4
• INFO 6
• DEBUG 7

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

• org.apache.log4j.ConsoleAppender（控制台），
• org.apache.log4j.FileAppender（文件），
• org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件），
• org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件），
• org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）

Layout：日志输出格式，Log4j提供的layout有以下几种：

• org.apache.log4j.HTMLLayout（以HTML表格形式布局），
• org.apache.log4j.PatternLayout（可以灵活地指定布局模式），
• org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），
• org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）

打印参数: Log4J采用类似C语言中的printf函数的打印格式格式化日志信息，如下:

• %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 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。举例：test.main(test.java: 10 )

2.参数意义说明
输出级别的种类

• ERROR 为严重错误 主要是程序的错误
• WARN 为一般警告，比如session丢失
• INFO 为一般要显示的信息，比如登录登出
• DEBUG 为程序的调试信息

配置日志信息输出目的地

• log4j.appender.appenderName=??
• 1.org.apache.log4j.ConsoleAppender（控制台）
• 2.org.apache.log4j.FileAppender（文件）
• 3.org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件）
• 4.org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件）
• 5.org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）

配置日志信息的格式

• log4j.appender.appenderName.layout = ??
• 1.org.apache.log4j.HTMLLayout（以HTML表格形式布局），
• 2.org.apache.log4j.PatternLayout（可以灵活地指定布局模式），
• 3.org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），
• 4.org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）

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:指定可以产生的滚动文件的最大数。

日志信息格式中几个符号所代表的含义：

• -X号: X信息输出时左对齐；
• %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"输出日志信息换行