log4j配置解析

一、rootLogger的配置方式：

log4j.rootLogger =[ level ],appenderName1,appenderName2, …
Log4j建议只使用四个级别，优先级从高到低分别是ERROR、WARN、INFO、DEBUG。

appenderName是日志信息输出位置，可以同时指定多个输出目的地

二、配置日志信息输出目的地Appender

1. Appender的配置方式：
   log4j.appender.appenderName = Log4j提供的appender类
   log4j.appender.appenderName.属性名 = 属性值
   log4j.appender.appenderName.属性名 = 属性值

2. Appender的配置详解
   Log4j提供的appender有以下5种，分别可以将日志信息输出到5个不同的平台

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

3. ConsoleAppender（控制台）

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

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

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

4. FileAppender（文件）

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

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

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

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

5. 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: 每分钟

6. 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：指定可以产生的滚动文件的最大数。

三.配置日志信息的格式（布局）

log4j.appender.appenderName.layout = Log4j提供的layout类
log4j.appender.appenderName.layout.属性 = 值

1. 日志信息格式的配置详解
   Log4j提供的layout有以下几种：

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

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

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

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

2. HTMLLayout
   LocationInfo=true：默认值是false,输出java文件名称和行号
   Title=my app file：默认值是 Log4J Log Messages

3. PatternLayout
   ConversionPattern=%m%n：指定怎样格式化指定的消息。

4. XMLLayout
   LocationInfo=true：默认值是false,输出java文件和行号

5. Log4J采用类似C语言中的printf函数的打印格式格式化日志信息，打印参数如下：
   og4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n

6. 日志信息格式中几个符号所代表的含义：

-X号: 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平台为” ”，Unix平台为” ”输出日志信息换行

可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如：
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字符，就从左边交远销出的字符截掉

四、案例

### 配置根 ###
log4j.rootLogger = DEBUG,console ,debug,info,warn,error

### 配置 包 com.potato.yeb.server.mapper 的日志级别为debug
### log4j.logger.com.potato.yeb.server.mapper=debug

### 配置输出到控制台 ###
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.console.Target = System.out
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern =  %d{ABSOLUTE} %5p %c{1}:%L - %m%n

### 配置输出到文件，并且每天都创建一个文件  DEBUG###
log4j.appender.debug = org.apache.log4j.DailyRollingFileAppender
log4j.appender.debug.File = logs/dubug.log
log4j.appender.debug.Append = true
log4j.appender.debug.Threshold = DEBUG
log4j.appender.debug.layout = org.apache.log4j.PatternLayout
log4j.appender.debug.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 配置输出到文件，并且每天都创建一个文件  INFO ###
log4j.appender.info = org.apache.log4j.DailyRollingFileAppender
log4j.appender.info.File = logs/info.log
log4j.appender.info.Append = true
log4j.appender.info.Threshold = INFO
log4j.appender.info.layout = org.apache.log4j.PatternLayout
log4j.appender.info.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 配置输出到文件，并且每天都创建一个文件  WARN ###
log4j.appender.warn = org.apache.log4j.DailyRollingFileAppender
log4j.appender.warn.File = logs/warn.log
log4j.appender.warn.Append = true
log4j.appender.warn.Threshold = WARN
log4j.appender.warn.layout = org.apache.log4j.PatternLayout
log4j.appender.warn.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 配置输出到文件，并且每天都创建一个文件  ERROR###
log4j.appender.error = org.apache.log4j.DailyRollingFileAppender
log4j.appender.error.File = logs/error.log
log4j.appender.error.Append = true
log4j.appender.error.Threshold = ERROR
log4j.appender.error.layout = org.apache.log4j.PatternLayout
log4j.appender.error.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n