log4j.properties配置文件及详解

log4j配置文件有三个主要的组件：Logger，Appender和Layout，分别为日志类型，日志输出目的地，日志输出格式。

1. 配置日志级别及appenderName

log4j.rootLogger=[level],console,debugFileAppender,errorFileAppender,...

注：其中 [level] 是日志输出级别：FATAL、ERROR、WARN、INFO、DEBUG 五个级别，通过定义的级别，你可以控制程序中的日志输出，例：如果定义了ERROR级别，程序中只有FARAL、ERROR 级别的 log 会被输出。

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

2. Log4j提供的输出目的地有以下几种：

log4j.appender.appenderName= 输出目的地 (这里的appenderName是在前面定义的，可任意起名)

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

3. 配置布局类型

log4j.appender.appenderName.layout = 布局类型(设置布局类型)

Log4j提供的layout有以下4种：

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

4. 配置符号所代表的含义：log4j.appender.根.layout.ConversionPattern=

%p：输出日志信息的优先级，即FATAL、ERROR、WARN、INFO、DEBUG。
%d：输出日志日期或时间，默认格式为ISO8601，也可以在其后指定格式。例：%d{yyyy MMM dd HH:mm:ss,SSS}，输出：2000年01月01日 00：00：10,000
%c：输出日志信息所属的类目，通常就是所在类的全名。
%F：输出日志消息产生时所在的文件名称
%L：输出代码中的行号。
%l：输出日志事件的发生位置，包括全类名方法名、发生的线程，以及在代码中的行号，相当于%c(%F:%L)的组合，但这个组合不包括方法名。例：cn.xiwh.test.Testlog4j.main(TestLog4j.java:10)
%m：输出代码中指定产生的日志的具体信息。
%n：输出一个回车换行符，Windows平台为"\r\n"，Unix平台为"\n"输出日志信息换行。
%r：输出自应用启动到输出该log信息耗费的毫秒数。
%t：输出产生该日志事件的线程名。
%x：输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。
%%：输出一个"%"字符。
[QC]：是log信息的开头，可以为任意字符，一般为项目简称。
-X号：X信息输出时左对齐。

可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、及文本的对齐方式。例：

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

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

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

4). %20.30c：如果类的名称小于20就补空格并且右对齐，如果其名称大于30就从左边较远输出的字符截掉。

5. 配置文件 log4j.properties

### 配置日志级别及appenderName ###

log4j.rootLogger=error,console,debugFileAppender,errorFileAppender,dailyRollingFile,rollingFile,mail

### 配置输出信息到控制抬 ###

log4j.appender.console=org.apache.log4j.ConsoleAppender

#默认值是System.out，指定输出控制台。

log4j.appender.console.Target=System.out

log4j.appender.console.layout=org.apache.log4j.PatternLayout

log4j.appender.console.layout.ConversionPattern=[%-5p] [%d{yyyy-MM-dd HH:mm:ss,SSS}] method:%l%n%m%n

### 配置输出DEBUG级别以上的日志文件到> D://logs/debug.log ###

log4j.appender.debugFileAppender=org.apache.log4j.FileAppender

log4j.appender.debugFileAppender.File=D://logs/debug.log

log4j.appender.debugFileAppender.Append=true

log4j.appender.debugFileAppender.Threshold=DEBUG

log4j.appender.debugFileAppender.layout=org.apache.log4j.PatternLayout

log4j.appender.debugFileAppender.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 配置输出ERROR级别以上的日志文件到> D://logs/error.log ###

log4j.appender.errorFileAppender=org.apache.log4j.FileAppender

log4j.appender.errorFileAppender.File=D://logs/error.log

log4j.appender.errorFileAppender.Append=true

log4j.appender.errorFileAppender.Threshold=ERROR

log4j.appender.errorFileAppender.layout=org.apache.log4j.PatternLayout

log4j.appender.errorFileAppender.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 配置输出DEBUG级别以上的日志文件到> D://logs/debug.log 并且每天都创建一个文件 ###

log4j.appender.dailyRollingFile=org.apache.log4j.DailyRollingFileAppender

log4j.appender.dailyRollingFile.File=D://logs/debug.log

log4j.appender.dailyRollingFile.Append=true

log4j.appender.dailyRollingFile.Threshold=DEBUG

log4j.appender.dailyRollingFile.layout=org.apache.log4j.PatternLayout

log4j.appender.dailyRollingFile.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 配置输出DEBUG级别以上的日志文件到> D://logs/debugRolling.log 且大小到达指定尺寸的时候产生一个新的文件 ###

log4j.appender.rollingFile=org.apache.log4j.RollingFileAppender

#指定消息输出到> D://logs/debugRolling.log文件

log4j.appender.rollingFile.File=D://logs/debugRolling.log

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

log4j.appender.rollingFile.Append=true

#指定日志消息的输出最低层次

log4j.appender.rollingFile.Threshold=DEBUG

#后缀可以是KB、MB或者是GB，在日志文件到达该大小时，将会自动滚动，即将原来的内容移到debug.log.1文件。

log4j.appender.rollingFile.MaxFileSize=10KB

#指定可以产生的滚动文件的最大数

log4j.appender.rollingFile.MaxBackupIndex=1

log4j.appender.rollingFile.layout=org.apache.log4j.PatternLayout

log4j.appender.rollingFile.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

### 配置输出到邮件 ###

log4j.appender.mail=org.apache.log4j.net.SMTPAppender

# 日志的错误级别

log4j.appender.mail.Threshold=DEBUG

# 缓存文件大小，日志达到10K时发送Email

log4j.appender.mail.BufferSize=10

# 发送邮件的服务器

log4j.appender.mail.SMTPHost=smtp.163.com

# 邮件的标题

log4j.appender.mail.Subject=Log4J DebugMessage

# 邮箱地址

log4j.appender.mail.SMTPUsername=test@163.com

# 密码

log4j.appender.mail.SMTPPassword=test

# 发件人

log4j.appender.mail.From=test@163.com

# 收件人

log4j.appender.mail.To=receive@163.com

# 日志PatternLayout

log4j.appender.mail.layout=org.apache.log4j.PatternLayout

# 日志的格式

log4j.appender.mail.layout.ConversionPattern=[DebugMessage] %d - %c -%-4r [%t] %-5p %c %x - %m%n