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)%20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,默认的情况下右对齐。
2)%-20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,"-"号指定左对齐。
3)%.30c:指定输出category的名称,最大的宽度是30,如果category的名称大于30的话,就会将左边多出的字符截掉,但小于30的话也不会有空格。
4)%20.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.
4.log4j.logger.org.apache=INFO, FILE
5.log4j.additivity.org.apache=false
6.
7.###################
8.# Console Appender
9.###################
10.log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
11.log4j.appender.Threshold=DEBUG
12.log4j.appender.CONSOLE.Target=System.out
13.log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
14.log4j.appender.CONSOLE.layout.ConversionPattern=%d [%p] - %m%n
15.
16.
17.#####################
18.# File Appender
19.#####################
20.log4j.appender.FILE=org.apache.log4j.FileAppender
21.log4j.appender.FILE.File=file.log
22.log4j.appender.FILE.Append=false
23.log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
24.log4j.appender.FILE.layout.ConversionPattern=%d [%p] - %m%n
25.
26.
27.########################
28.# Rolling File
29.########################
30.log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender
31.log4j.appender.ROLLING_FILE.Threshold=ERROR
32.log4j.appender.ROLLING_FILE.File=rolling.log
33.log4j.appender.ROLLING_FILE.Append=true
34.log4j.appender.ROLLING_FILE.MaxFileSize=10KB
35.log4j.appender.ROLLING_FILE.MaxBackupIndex=1
36.log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout
37.log4j.appender.ROLLING_FILE.layout.ConversionPattern=%d [%p] - %m%n
38.
39.
40.####################
41.# Socket Appender
42.####################
43.log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender
44.log4j.appender.SOCKET.RemoteHost=localhost
45.log4j.appender.SOCKET.Port=5001
46.log4j.appender.SOCKET.LocationInfo=true
47.# Set up for Log Facter 5
48.log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout
49.log4j.appender.SOCET.layout.ConversionPattern=%d [%p] - %m%n
50.
51.
52.########################
53.# Log Factor 5 Appender
54.########################
55.log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender
56.log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000
57.
58.
59.########################
60.# SMTP Appender
61.#######################
62.log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
63.log4j.appender.MAIL.Threshold=FATAL
64.log4j.appender.MAIL.BufferSize=10
65.log4j.appender.MAIL.From=wuyh@primeton.com
66.log4j.appender.MAIL.SMTPHost=mail.primeton.com
67.log4j.appender.MAIL.Subject=Log4J Message
68.log4j.appender.MAIL.To=test@primeton.com
69.log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
70.log4j.appender.MAIL.layout.ConversionPattern=%d [%p] - %m%n
71.
72.
73.########################
74.# JDBC Appender
75.#######################
76.log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender
77.log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test
78.log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver
79.log4j.appender.DATABASE.user=root
80.log4j.appender.DATABASE.password=
81.log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES (%d [%p] - %m%n)
82.log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout
83.log4j.appender.DATABASE.layout.ConversionPattern=%d [%p] - %m%n
84.
85.
86.log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
87.log4j.appender.A1.File=SampleMessages.log4j
88.log4j.appender.A1.DatePattern=yyyyMMdd-HH'.log4j'
89.log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout
90.
91.###################
92.#自定义Appender
93.###################
94.log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender
95.
96.log4j.appender.im.host = mail.cybercorlin.net
97.log4j.appender.im.username = username
98.log4j.appender.im.password = password
99.log4j.appender.im.recipient = wuyh@primeton.com
100.
101.log4j.appender.im.layout=org.apache.log4j.PatternLayout
102.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.
5.
6.<appender class="org.apache.log4j.ConsoleAppender" name="CONSOLE">
7.<param name="Target" value="System.out"/>
8.<param name="Threshold" value="INFO"/>
9.<layout class="org.apache.log4j.PatternLayout">
10.<param name="ConversionPattern" value="%d [%p] - %m%n "/>
11.</layout>
12.<filter class="org.apache.log4j.varia.DenyAllFilter"/>
13.<errorHandler class="org.apache.log4j.varia. FallbackErrorHandler"/>
14.</appender>
15.
16.<appender class="org.apache.log4j.FileAppender" name="FILE">
17.<param name="File" value="file.log"/>
18.<param name="Append" value="false"/>
19.<param name="Threshold" value="INFO"/>
20.<layout class="org.apache.log4j.PatternLayout">
21.<param name="ConversionPattern" value="%d [%p] - %m%n "/>
22.</layout>
23.</appender>
24.
25.<appender class="org.apache.log4j.RollingFileAppender" name="ROLLING_FILE">
26.<param name="Threshold" value="INFO"/>
27.<param name="File" value="rolling.log"/>
28.<param name="Append" value="false"/>
29.<param name="MaxFileSize" value="10KB"/>
30.<param name="MaxBackupIndex" value="1"/>
31.<layout class="org.apache.log4j.PatternLayout">
32.<param name="ConversionPattern" value="%d [%p] - %m%n "/>
33.</layout>
34.</appender>
35.
36.<logger additivity="false" name="com.eos">
37.<level value="info"/>
38.<appender-ref ref="CONSOLE"/>
39.</logger>
40.
41.<category additivity="true" name="com.eos.log">
42.<priority value="warn"/>
43.</category>
44.
45.<root>
46.<priority value="info"/>
47.<appender-ref ref="CONSOLE"/>
48.</root>
49.</log4j:configuration>