Log4j配置说明

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

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

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
log4j.appender.MAIL.From=[e-mail]
log4j.appender.MAIL.SMTPHost=mail.primeton.com
log4j.appender.MAIL.Subject=Log4J Message
log4j.appender.MAIL.To=[e-mail]
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 = [e-mail]
log4j.appender.im.layout=org.apache.log4j.PatternLayout
log4j.appender.im.layout.ConversionPattern =%d [%p] - %m%n
#注意：在属性配置文件中，属性值的第一个一定是级别，输出端可有可无，以逗号分割。（而xml文件格式没有这种限制）

4.3.2   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>