浅谈Log4j的扩展 (二)

转自：http://blog.sina.com.cn/s/blog_5f53615f0100sfo2.html

4.2   Log4j配置文件详细说明（*.properties和*.xml）

4.2.1  属性文件Properties

 

properties属性文件
编号	配置项	配置项描述	示例
1	log4j.threshold	阈值项	log4j.threshold = error
2	log4j.rootLogger	根日志属性项	log4j.rootLogger = info,stdout1,stdout2
3	log4j.category.	子日志属性项（旧）	log4j.category.com.eos = NULL,stdout1
4	log4j.logger.	子日志属性项（新）	log4j.logger.com.eos.log = debug,stdout2
5	log4j.additivity.	appender是否继承设置	log4j.additivity.com.eos = false
6	log4j.appender.	输出目的地定义项	log4j.appender.stdout2 = org.apache.log4j.ConsoleAppender
7	log4j.appender.A.layout	输出格式定义项	log4j.appender.stdout2.layout = org.apache.log4j.PatternLayout

 

4.2.2  文件xml

 

xml文件
编号	配置项	配置项描述	示例
1	threshold	阈值项	<log4j:configuration xmlns:log4j=" http://jakarta.apache.org/log4j/" debug="false" threshold="null">
2	root	根日志属性项	<root>     <priority value="info"/>      <appender-ref ref="CONSOLE"/>    </root>
3	priority	级别项（旧）	<priority value="info"/>
4	level	级别项（新）	<level value="info"/>
5	category	子日志属性项（旧）	<category additivity="true" name="com.eos.log">
6	logger	子日志属性项（新）	<logger additivity="true" name="com.eos">
7	appender-ref	输出端控制项	<appender-ref ref="CONSOLE"/>
8	additivity	appender是否继承设置	<logger additivity="true" name="com.eos">
9	appender	输出目的地定义项	<appender class="org.apache.log4j.ConsoleAppender" name="CONSOLE">
10	layout	输出格式定义项	<layout class="org.apache.log4j.PatternLayout">

 

4.2.3  详细说明（只针对Log4j常用的，用户可以自定义）Appender

Appender继承关系

Appender基本种类

org.apache.log4j.ConsoleAppender（控制台）

org.apache.log4j.FileAppender（文件）

org.apache.log4j.DailyRollingFileAppender （每天产生一个日志文件）

org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件）

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

· ConsoleAppender选项

Threshold=WARN:指定日志消息的输出最低层次。

ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。

Target=System.err：默认情况下是：System.out,指定输出控制台

· FileAppender 选项

Threshold=WARN:指定日志消息的输出最低层次。

ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。

File=mylog.txt:指定消息输出到mylog.txt文件。

Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。

· DailyRollingFileAppender 选项

Threshold=WARN:指定日志消息的输出最低层次。

ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。

File=mylog.txt:指定消息输出到mylog.txt文件。

Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。

DatePattern='.'yyyy-ww:每周滚动一次文件，即每周产生一个新的文件。当然也可以指定按月、周、

天、时和分。即对应的格式如下：

1)'.'yyyy-MM: 每月

2)'.'yyyy-ww: 每周

3)'.'yyyy-MM-dd: 每天

4)'.'yyyy-MM-dd-a: 每天两次

5)'.'yyyy-MM-dd-HH: 每小时

6)'.'yyyy-MM-dd-HH-mm: 每分钟

n RollingFileAppender 选项

Threshold=WARN:指定日志消息的输出最低层次。

ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。

File=mylog.txt:指定消息输出到mylog.txt文件。

Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。

MaxFileSize=100KB: 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时，将会自动滚动，即将原来

的内容移到mylog.log.1文件。

MaxBackupIndex=2:指定可以产生的滚动文件的最大数。

4.2.4  详细说明（只针对Log4j，用户可以自定义）Layout

Log4j的Layout基本种类

org.apache.log4j.HTMLLayout（以HTML表格形式布局），

org.apache.log4j.PatternLayout（可以灵活地指定布局模式），

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

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

· HTMLLayout选项

LocationInfo=true:默认值是false,输出java文件名称和行号

Title=my app file: 默认值是 Log4J Log Messages.       

n PatternLayout 选项

log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n

这里需要说明的就是日志信息格式中几个符号所代表的含义：

 

%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"输出日志信息换行，可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如：

1) c：指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，默认的情况下右对齐。

2)%-20c:指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，"-"号指定左对齐。

3)%.30c:指定输出category的名称，最大的宽度是30，如果category的名称大于30的话，就会将左边多出的字符截掉，但小于30的话也不会有空格。

4) .30c:如果category的名称小于20就补空格，并且右对齐，如果其名称长于30字符，就从左边交远销出的字符截掉。

· XMLLayout 选项

LocationInfo=true:默认值是false,输出java文件和行号

4.3   日志配置文件内容范例

4.3.1  log4j.properties

1. log4j.rootLogger=DEBUG, CONSOLE
2. #DEBUG, CONSOLE,FILE,ROLLING_FILE,MAIL,DATABASE
3. log4j.logger.org.apache=INFO, FILE
4. log4j.additivity.org.apache=false
5. ###################
6. # Console Appender
7. ###################
8. log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
9. log4j.appender.Threshold=DEBUG
10. log4j.appender.CONSOLE.Target=System.out
11. log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
12. log4j.appender.CONSOLE.layout.ConversionPattern=%d [%p] - %m%n
13. #####################
14. # File Appender
15. #####################
16. log4j.appender.FILE=org.apache.log4j.FileAppender
17. log4j.appender.FILE.File=file.log
18. log4j.appender.FILE.Append=false
19. log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
20. log4j.appender.FILE.layout.ConversionPattern=%d [%p] - %m%n
21. ########################
22. # Rolling File
23. ########################
24. log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender
25. log4j.appender.ROLLING_FILE.Threshold=ERROR
26. log4j.appender.ROLLING_FILE.File=rolling.log
27. log4j.appender.ROLLING_FILE.Append=true
28. log4j.appender.ROLLING_FILE.MaxFileSize=10KB
29. log4j.appender.ROLLING_FILE.MaxBackupIndex=1
30. log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout
31. log4j.appender.ROLLING_FILE.layout.ConversionPattern=%d [%p] - %m%n
32. ####################
33. # Socket Appender
34. ####################
35. log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender
36. log4j.appender.SOCKET.RemoteHost=localhost
37. log4j.appender.SOCKET.Port=5001
38. log4j.appender.SOCKET.LocationInfo=true
39. # Set up for Log Facter 5
40. log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout
41. log4j.appender.SOCET.layout.ConversionPattern=%d [%p] - %m%n
42. ########################
43. # Log Factor 5 Appender
44. ########################
45. log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender
46. log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000
47. ########################
48. # SMTP Appender
49. #######################
50. log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
51. log4j.appender.MAIL.Threshold=FATAL
52. log4j.appender.MAIL.BufferSize=10
53. log4j.appender.MAIL.From=wuyh@primeton.com
54. log4j.appender.MAIL.SMTPHost=mail.primeton.com
55. log4j.appender.MAIL.Subject=Log4J Message
56. log4j.appender.MAIL.To=test@primeton.com
57. log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
58. log4j.appender.MAIL.layout.ConversionPattern=%d [%p] - %m%n
59. ########################
60. # JDBC Appender
61. #######################
62. log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender
63. log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test
64. log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver
65. log4j.appender.DATABASE.user=root
66. log4j.appender.DATABASE.password=
67. log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES (%d [%p] - %m%n)
68. log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout
69. log4j.appender.DATABASE.layout.ConversionPattern=%d [%p] - %m%n
70. log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
71. log4j.appender.A1.File=SampleMessages.log4j
72. log4j.appender.A1.DatePattern=yyyyMMdd-HH'.log4j'
73. log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout
74. ###################
75. #自定义Appender
76. ###################
77. log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender
78. log4j.appender.im.host = mail.cybercorlin.net
79. log4j.appender.im.username = username
80. log4j.appender.im.password = password
81. log4j.appender.im.recipient = wuyh@primeton.com
82. log4j.appender.im.layout=org.apache.log4j.PatternLayout
83. log4j.appender.im.layout.ConversionPattern =%d [%p] - %m%n

#注意：在属性配置文件中，属性值的第一个一定是级别，输出端可有可无，以逗号分割。（而xml文件格式没有这种限制）

4.3.2  log4j.xml

1. < xml version="1.0" encoding="UTF-8" >
2. <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
3. <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/" debug="false" threshold="null">
4. <appender class="org.apache.log4j.ConsoleAppender" name="CONSOLE">
5. <param name="Target" value="System.out"/>
6. <param name="Threshold" value="INFO"/>
7. <layout class="org.apache.log4j.PatternLayout">
8. <param name="ConversionPattern" value="%d [%p] - %m%n "/>
9. </layout>
10. <filter class="org.apache.log4j.varia.DenyAllFilter"/>
11. <errorHandler class="org.apache.log4j.varia. FallbackErrorHandler"/>
12. </appender>
13. <appender class="org.apache.log4j.FileAppender" name="FILE">
14. <param name="File" value="file.log"/>
15. <param name="Append" value="false"/>
16. <param name="Threshold" value="INFO"/>
17. <layout class="org.apache.log4j.PatternLayout">
18. <param name="ConversionPattern" value="%d [%p] - %m%n "/>
19. </layout>
20. </appender>
21. <appender class="org.apache.log4j.RollingFileAppender" name="ROLLING_FILE">
22. <param name="Threshold" value="INFO"/>
23. <param name="File" value="rolling.log"/>
24. <param name="Append" value="false"/>
25. <param name="MaxFileSize" value="10KB"/>
26. <param name="MaxBackupIndex" value="1"/>
27. <layout class="org.apache.log4j.PatternLayout">
28. <param name="ConversionPattern" value="%d [%p] - %m%n "/>
29. </layout>
30. </appender>
31. <logger additivity="false" name="com.eos">
32. <level value="info"/>
33. <appender-ref ref="CONSOLE"/>
34. </logger>
35. <category additivity="true" name="com.eos.log">
36. <priority value="warn"/>
37. </category>
38. <root>
39. <priority value="info"/>
40. <appender-ref ref="CONSOLE"/>
41. </root>
42. </log4j:configuration>