Log4j配置文件详细说明[转]
属性文件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
文件xml
1
threshold
阈值项
<log4j:configurationxmlns:log4j=”http://jakarta.apache.org/log4j/”debug=”false”threshold=”null”>
2
root
根日志属性项
<root>
<priorityvalue=”info”/>
<appender-refref=”CONSOLE”/>
</root>
3
priority
级别项（旧）
<priorityvalue=”info”/>
4
level
级别项（新）
<levelvalue=”info”/>
5
category
子日志属性项（旧）
<categoryadditivity=”true”name=”com.eos.log”>
6
logger
子日志属性项（新）
<loggeradditivity=”true”name=”com.eos”>
7
appender-ref
输出端控制项
<appender-refref=”CONSOLE”/>
8
additivity
appender是否继承设置
<loggeradditivity=”true”name=”com.eos”>
9
appender
输出目的地定义项
<appenderclass=”org.apache.log4j.ConsoleAppender”name=”CONSOLE”>
10
layout
输出格式定义项
<layoutclass=”org.apache.log4j.PatternLayout”>
详细说明（只针对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:每分钟
nRollingFileAppender选项
Threshold=WARN:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
File=mylog.txt:指定消息输出到mylog.txt文件。
Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。
MaxFileSize=100KB:后缀可以是KB,MB或者是GB.在日志文件到达该大小时，将会自动滚动，即将原来
的内容移到mylog.log.1文件。
MaxBackupIndex=2:指定可以产生的滚动文件的最大数。
详细说明（只针对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=myappfile:默认值是Log4JLogMessages.
nPatternLayout选项
log4j.appender.A1.layout.ConversionPattern=%-4r%-5p%d{yyyy-MM-ddHH:mm:ssS}%c%m%n
这里需要说明的就是日志信息格式中几个符号所代表的含义：
%X:信息输出时左对齐；
%p:输出日志信息优先级，即DEBUG，INFO，WARN，ERROR，FATAL,
%d:输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyyMMMddHH: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(嵌套诊断环境),尤其用到像javaservlets这样的多客户多线程的应用中。
%%:输出一个”%”字符
%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文件和行号
日志配置文件内容范例
log4j.properties
log4j.rootLogger=DEBUG, CONSOLE #DEBUG, CONSOLE,FILE,ROLLING_FILE,MAIL,DATABASE log4j.logger.org.apache=INFO, FILE log4j.additivity.org.apache=false ################### # Console Appender ################### log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender log4j.appender.Threshold=DEBUG log4j.appender.CONSOLE.Target=System.out log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout log4j.appender.CONSOLE.layout.ConversionPattern=%d [%p] - %m%n ##################### # File Appender ##################### log4j.appender.FILE=org.apache.log4j.FileAppender log4j.appender.FILE.File=file.log log4j.appender.FILE.Append=false log4j.appender.FILE.layout=org.apache.log4j.PatternLayout log4j.appender.FILE.layout.ConversionPattern=%d [%p] - %m%n ######################## # Rolling File ######################## log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender log4j.appender.ROLLING_FILE.Threshold=ERROR log4j.appender.ROLLING_FILE.File=rolling.log log4j.appender.ROLLING_FILE.Append=true log4j.appender.ROLLING_FILE.MaxFileSize=10KB log4j.appender.ROLLING_FILE.MaxBackupIndex=1 log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout log4j.appender.ROLLING_FILE.layout.ConversionPattern=%d [%p] - %m%n #################### # Socket Appender #################### log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender log4j.appender.SOCKET.RemoteHost=localhost log4j.appender.SOCKET.Port=5001 log4j.appender.SOCKET.LocationInfo=true # Set up for Log Facter 5 log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout log4j.appender.SOCET.layout.ConversionPattern=%d [%p] - %m%n ######################## # Log Factor 5 Appender ######################## log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000 ######################## # SMTP Appender ####################### log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender log4j.appender.MAIL.Threshold=FATAL log4j.appender.MAIL.BufferSize=10 [email protected] log4j.appender.MAIL.SMTPHost=mail.primeton.com log4j.appender.MAIL.Subject=Log4J Message [email protected] log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout log4j.appender.MAIL.layout.ConversionPattern=%d [%p] - %m%n ######################## # JDBC Appender ####################### log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver log4j.appender.DATABASE.user=root log4j.appender.DATABASE.password= log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES (%d [%p] - %m%n) log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout log4j.appender.DATABASE.layout.ConversionPattern=%d [%p] - %m%n log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender log4j.appender.A1.File=SampleMessages.log4j log4j.appender.A1.DatePattern=yyyyMMdd-HH’.log4j’ log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout ################### #自定义Appender ################### log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender log4j.appender.im.host = mail.cybercorlin.net log4j.appender.im.username = username log4j.appender.im.password = password log4j.appender.im.recipient = [email protected] log4j.appender.im.layout=org.apache.log4j.PatternLayout log4j.appender.im.layout.ConversionPattern =%d [%p] - %m%n #注意：在属性配置文件中，属性值的第一个一定是级别，输出端可有可无，以逗号分割。（而xml文件格式没有这种限制）
log4j.xml
< xml version=”1.0″ encoding=”UTF-8″ > <!DOCTYPE log4j:configuration SYSTEM “log4j.dtd”> <log4j:configuration xmlns:log4j=”http://jakarta.apache.org/log4j/” debug=”false” threshold=”null”> <appender class=”org.apache.log4j.ConsoleAppender” name=”CONSOLE”> <param name=”Target” value=”System.out”/> <param name=”Threshold” value=”INFO”/> <layout class=”org.apache.log4j.PatternLayout”> <param name=”ConversionPattern” value=”%d [%p] - %m%n “/> </layout> <filter class=”org.apache.log4j.varia.DenyAllFilter”/> <errorHandler class=”org.apache.log4j.varia. FallbackErrorHandler”/> </appender> <appender class=”org.apache.log4j.FileAppender” name=”FILE”> <param name=”File” value=”file.log”/> <param name=”Append” value=”false”/> <param name=”Threshold” value=”INFO”/> <layout class=”org.apache.log4j.PatternLayout”> <param name=”ConversionPattern” value=”%d [%p] - %m%n “/> </layout> </appender> <appender class=”org.apache.log4j.RollingFileAppender” name=”ROLLING_FILE”> <param name=”Threshold” value=”INFO”/> <param name=”File” value=”rolling.log”/> <param name=”Append” value=”false”/> <param name=”MaxFileSize” value=”10KB”/> <param name=”MaxBackupIndex” value=”1″/> <layout class=”org.apache.log4j.PatternLayout”> <param name=”ConversionPattern” value=”%d [%p] - %m%n “/> </layout> </appender> <logger additivity=”false” name=”com.eos”> <level value=”info”/> <appender-ref ref=”CONSOLE”/> </logger> <category additivity=”true” name=”com.eos.log”> <priority value=”warn”/> </category> <root> <priority value=”info”/> <appender-ref ref=”CONSOLE”/> </root> </log4j:configuration>