Apache Log4j配置说明

1. Log4j简介

Log4j是Apache的一个开源项目，它容许开发者以任意间隔输出日志信息。Log4j主要由三大类组件构成： 1）Logger-负责输出日志信息，并可以对日志信息进行分类筛选，即决定哪些日志信息应该被输出，哪些该被忽略。Loggers组件输出日志信息时分为5个级别：DEBUG、INFO、WARN、ERROR、FATAL。这五个级别的顺序是：DEBUG<INFO<WARN<ERROR<FATAL。若是设置某个Logger组件的级别是P，则只有级别比P高的日志信息才能输出。Logger是有继承关系的，最上层是rootLogger，定义的其余Logger都会继承rootLogger。

2）Appender-定义了日志输出目的地，指定日志信息应该被输出到什么地方。输出的目的地能够是控制台、文件或网络设备。

3）Layout-经过在Appender的后面附加Layout来实现格式化输出。

PS:一个Logger能够有多个Appender，每一个Appender对应一个Layout。

2.Loggers

Logger的定义格式：log4j.[loggername]=[level],appenderName,appenderName… 这里level是指Logger的优先级，appenderName是日志信息的输出地，能够同时定义多个输出地。

3.Appenders

Appender 为日志输出目的地，Log4j提供的appender有如下几种：

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

1）ConsoleAppender选项 -Threshold=WARN:指定日志消息的输出最低层次。 -ImmediateFlush=true:默认值是true,意谓着全部的消息都会被当即输出。 -Target=System.err：默认状况下是：System.out,指定输出控制台。

2）FileAppender 选项 -Threshold=WARN:指定日志消息的输出最低层次。 -ImmediateFlush=true:默认值是true,意谓着全部的消息都会被当即输出。 -File=mylog.txt:指定消息输出到mylog.txt文件。

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

3）DailyRollingFileAppender 选项 -Threshold=WARN:指定日志消息的输出最低层次。 -ImmediateFlush=true:默认值是true,意谓着全部的消息都会被当即输出。 -File=mylog.txt:指定消息输出到mylog.txt文件。 -Append=false:默认值是true,即将消息增长到指定文件中，false指将消息覆盖指定的文件内容。 -DatePattern='.'yyyy-ww:每周滚动一次文件，即每周产生一个新的文件。固然也能够指定按月、周、天、时和分。即对应的格式以下： '.'yyyy-MM: 每个月 '.'yyyy-ww: 每周 '.'yyyy-MM-dd: 天天 '.'yyyy-MM-dd-a: 天天两次 '.'yyyy-MM-dd-HH: 每小时 '.'yyyy-MM-dd-HH-mm: 每分钟

4）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.Layout

日志输出格式，Log4j提供的layout有如下几种：

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

1）HTMLLayout 选项 -LocationInfo=true:默认值是false,输出java文件名称和行号。 -Title=my app file: 默认值是 Log4J Log Messages。

2）PatternLayout 选项

• ConversionPattern=%m%n :指定怎样格式化指定的消息。

3）XMLLayout 选项 -LocationInfo=true:默认值是false,输出java文件和行号。

部分二 log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n

这里须要说明的就是日志信息格式中几个符号所表明的含义：

1. －X号: X信息输出时左对齐。

2. %p: 输出日志信息优先级，即DEBUG，INFO，WARN，ERROR，FATAL。

3. %d: 输出日志时间点的日期或时间，默认格式为ISO8601，也能够在其后指定格式，好比：%d{yyy MMM dd HH:mm:ss,SSS}，输出相似：2002年10月18日 22：10：28，921。

4. %r: 输出自应用启动到输出该log信息耗费的毫秒数。

5. %c: 输出日志信息所属的类目，一般就是所在类的全名。

6. %t: 输出产生该日志事件的线程名。

7. %l: 输出日志事件的发生位置，至关于%C.%M(%F:%L)的组合,包括类目名、发生的线程，以及在代码中的行数。举例：Testlog4.main(TestLog4.java:10)。

8. %x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤为用到像java servlets这样的多客户多线程的应用中。

9. %%: 输出一个"%"字符。

10. %F: 输出日志消息产生时所在的文件名称。

11. %L: 输出代码中的行号。

12. %m: 输出代码中指定的消息,产生的日志具体信息。

13. %n: 输出一个回车换行符，Windows平台为"\r\n"，Unix平台为"\n"输出日志信息换行。

    能够在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如：

14. %20c：指定输出category的名称，最小的宽度是20，若是category的名称小于20的话，默认的状况下右对齐。

15. %-20c:指定输出category的名称，最小的宽度是20，若是category的名称小于20的话，"-"号指定左对齐。

16. %.30c:指定输出category的名称，最大的宽度是30，若是category的名称大于30的话，就会将左边多出的字符截掉，但小于30的话也不会有空格。

17. %20.30c:若是category的名称小于20就补空格，而且右对齐，若是其名称长于30字符，就从左边交远销出的字符截掉。