Apache Log4j配置说明

雨点打透心脏的1/2处 2021-06-24 14:00 370阅读 0赞

Apache Log4j配置说明

*本文详细介绍Log4j的所有配置属性。*

author: ZJ 07-3-17

Blog: [\[url\]http://zhangjunhd.blog.51cto.com/\[/url\]][url_http_zhangjunhd.blog.51cto.com_url]

**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来实现格式化输出。

一个Logger可以有多个Appender，每个Appender对应一个Layout。

**2.Loggers**

Logger的定义格式：log4j.\[loggername\]=\[level\],appenderName,appenderName,…

这里level是指Logger的优先级，appenderName是日志信息的输出地，可以同时定义多个输出地。

**3.Appenders**

Appender的定义格式：

log4j.appender.appenderName = fully.qualified.name.of.appender.class

// "fully.qualified.name.of.appender.class" 可以指定下面五个目的地中的一个：

Appender类及其作用列表

<table style="color:rgb(44,44,44)"> 
 <tbody> 
  <tr> 
   <td> 
    <div> 
     <span style="font-size:12px">Appender类名</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="font-size:12px">作&nbsp;用</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="font-size:12px">org.apache.log4j.ConsoleAppender</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="font-size:12px">将日志输出到控制台</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="font-size:12px">org.apache.log4j.FileAppender</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="font-size:12px">将日志输出到文件</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="font-size:12px">org.apache.log4j.DailyRollingFileAppender</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="font-size:12px">每天产生一个日志文件</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="font-size:12px">org.apache.log4j.RollingFileAppender</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="font-size:12px">文件大小到达指定尺寸时产生一个新的文件</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="font-size:12px">org.apache.log4j. WriterAppender</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="font-size:12px">将日志信息以流格式发送到任意指定的地方</span> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

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.Layouts**

Layout的定义格式：

部分一log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class

//"fully.qualified.name.of.layout.class" 可以指定下面4个格式中的一个：

Layout类及其作用列表

<table style="color:rgb(44,44,44)"> 
 <tbody> 
  <tr> 
   <td> 
    <div> 
     <span style="font-size:12px">Layout类名</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="font-size:12px">作&nbsp;用</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="font-size:12px">org.apache.log4j.HTMLLayout</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="font-size:12px">以HTML表格形式布局</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="font-size:12px">org.apache.log4j.PatternLayout</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="font-size:12px">可以灵活地指定布局模式</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="font-size:12px">org.apache.log4j.SimpleLayout</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="font-size:12px">包含日志信息的级别和信息字符串</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="font-size:12px">org.apache.log4j.TTCCLayout</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="font-size:12px">包含日志产生的时间、线程、类别等等信息</span> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

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。