log4j2配置详解(节点和输出格式)

本文章主要详细介绍log4j2的配置!!

1.配置文件节点解析　　　　

　　　　(1).根节点Configuration有两个属性:status和monitorinterval,有两个子节点:Appenders和Loggers(表明可以定义多个Appender和Logger).
　　　　　　　status用来指定log4j本身的打印日志的级别.
　　　　　　　monitorinterval用于指定log4j自动重新配置的监测间隔时间，单位是s,最小是5s.

　　　　(2).Appenders节点，常见的有三种子节点:Console、RollingFile、File.
　　　　　　　Console节点用来定义输出到控制台的Appender.
　　　　　　　　name:指定Appender的名字.
　　　　　　　　target:SYSTEM_OUT 或 SYSTEM_ERR,一般只设置默认:SYSTEM_OUT.
　　　　　　　　PatternLayout:输出格式，不设置默认为:%m%n.
　　　　　　　File节点用来定义输出到指定位置的文件的Appender.
　　　　　　　　name:指定Appender的名字.
　　　　　　　　fileName:指定输出日志的目的文件带全路径的文件名.
　　　　　　　　PatternLayout:输出格式，不设置默认为:%m%n.
　　　　　　　RollingFile节点用来定义超过指定大小自动删除旧的创建新的的Appender.
　　　　　　　　name:指定Appender的名字.
　　　　　　　　fileName:指定输出日志的目的文件带全路径的文件名.
　　　　　　　　PatternLayout:输出格式，不设置默认为:%m%n.
　　　　　　　　filePattern:指定新建日志文件的名称格式.
　　　　　　　　Policies:指定滚动日志的策略，就是什么时候进行新建日志文件输出日志.
　　　　　　　   TimeBasedTriggeringPolicy:Policies子节点，基于时间的滚动策略，interval属性用来指定多久滚动一次，默认是1 hour。modulate=true用来调整时间：比如现在是早上3am，interval是4，那么第一次滚动是在4am，接着是8am，12am...而不是7am.
　　　　　　　　SizeBasedTriggeringPolicy:Policies子节点，基于指定文件大小的滚动策略，size属性用来定义每个日志文件的大小.
　　　　　　　　DefaultRolloverStrategy:用来指定同一个文件夹下最多有几个日志文件时开始删除最旧的，创建新的(通过max属性),默认是7个文件。

　　　　(3).Loggers节点，常见的有两种:Root和Logger.
　　　　　　　Root节点用来指定项目的根日志，如果没有单独指定Logger，那么就会默认使用该Root日志输出
　　　　　　　　　level:日志输出级别，共有8个级别，按照从低到高为：All < Trace < Debug < Info < Warn < Error < Fatal < OFF.
　　　　　　　　　AppenderRef：Root的子节点，用来指定该日志输出到哪个Appender.
　　　　　　　Logger节点用来单独指定日志的形式，比如要为指定包下的class指定不同的日志级别等。
　　　　　　　　　level:日志输出级别，共有8个级别，按照从低到高为：All < Trace < Debug < Info < Warn < Error < Fatal < OFF.
　　　　　　　　　name:用来指定该Logger所适用的类或者类所在的包全路径,继承自Root节点.
　　　　　　　　　AppenderRef：Logger的子节点，用来指定该日志输出到哪个Appender,如果没有指定，就会默认继承自Root.如果指定了，那么会在指定的这个Appender和Root的Appender中都会输出，此时我们可以设置Logger的additivity="false"只在自定义的Appender中进行输出。

　　　　(4).关于日志level.
　　　　　　共有8个级别，按照从低到高为：All < Trace < Debug < Info < Warn < Error < Fatal < OFF.
　　　　　　All:最低等级的，用于打开所有日志记录.
　　　　　　Trace:是追踪，就是程序推进以下，你就可以写个trace输出，所以trace应该会特别多，不过没关系，我们可以设置最低日志级别不让他输出.
　　　　　　Debug:指出细粒度信息事件对调试应用程序是非常有帮助的.
　　　　　　Info:消息在粗粒度级别上突出强调应用程序的运行过程.
　　　　　　Warn:输出警告及warn以下级别的日志.
　　　　　　Error:输出错误信息日志.
　　　　　　Fatal:输出每个严重的错误事件将会导致应用程序的退出的日志.
　　　　　　OFF:最高等级的，用于关闭所有日志记录.

2.输出格式详解:

%c列出logger名字空间的全称，如果加上{<层数>}表示列出从最内层算起的指定层数的名字空间log4j配置文件参数举例输出显示媒介假设当前logger名字空间是"a.b.c"%ca.b.c%c{2}b.c%20c（若名字空间长度小于20，则左边用空格填充）%-20c（若名字空间长度小于20，则右边用空格填充）%.30c（若名字空间长度超过30，截去多余字符）%20.30c（若名字空间长度小于20，则左边用空格填充；若名字空间长度超过30，截去多余字符）%-20.30c（若名字空间长度小于20，则右边用空格填充；若名字空间长度超过30，截去多余字符）%C列出调用logger的类的全名（包含包路径）假设当前类是"org.apache.xyz.SomeClass"%Corg.apache.xyz.SomeClass%C{1}SomeClass%d显示日志记录时间，{<日期格式>}使用ISO8601定义的日期格式%d{yyyy/MM/dd HH:mm:ss,SSS}2005/10/12 22:23:30,117%d{ABSOLUTE}22:23:30,117%d{DATE}12 Oct 2005 22:23:30,117%d{ISO8601}2005-10-12 22:23:30,117%F显示调用logger的源文件名%FMyClass.java%l输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数%lMyClass.main(MyClass.java:129)%L显示调用logger的代码行%L129%m显示输出消息%mThis is a message for debug.%M显示调用logger的方法名%Mmain%n当前平台下的换行符%nWindows平台下表示rn
UNIX平台下表示n%p显示该条日志的优先级%pINFO%r显示从程序启动时到记录该条日志时已经经过的毫秒数%r1215%t输出产生该日志事件的线程名%tMyClass%x按NDC（Nested Diagnostic Context，线程堆栈）顺序输出日志假设某程序调用顺序是MyApp调用com.foo.Bar%c %x - %m%nMyApp - Call com.foo.Bar.
com.foo.Bar - Log in Bar
MyApp - Return to MyApp.%X按MDC（Mapped Diagnostic Context，线程映射表）输出日志。通常用于多个客户端连接同一台服务器，方便服务器区分是那个客户端访问留下来的日志。%X{5}（记录代号为5的客户端的日志）%%显示一个百分号%%%

一个比较全的模版:

<?xml version="1.0" encoding="UTF-8"?> <!--Configuration后面的status，这个用于设置log4j2自身内部的信息输出，可以不设置--> <!--monitorInterval：Log4j能够自动检测修改配置 文件和重新配置本身，设置间隔秒数--> <configuration status="WARN" monitorInterval="30">    <!--先定义所有的appender-->     <appenders><!--输出到控制台-->         <console name="Console" target="SYSTEM_OUT">         <!--输出日志的格式-->             <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - %m%n"/>         </console><!--打印到文件中，这个log每次运行程序会自动清空，由append属性决定--><File name="log" fileName="log/test.log" append="false"><PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/> </File><!--文件滚动, 这个会打印出所有的info及以下级别的信息，每次大小超过size，则这size大小的日志会自动存入按年份-月份建立的文件夹下面并进行压缩，作为存档-->         <RollingFile name="RollingFileInfo" fileName="${sys:user.home}/logs/info.log"                      filePattern="${sys:user.home}/logs/$${date:yyyy-MM}/info-%d{yyyy-MM-dd}-%i.log">             <!--控制台只输出level及以上级别的信息（onMatch），其他的直接拒绝（onMismatch）-->                     <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>             <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - %m%n"/>             <Policies> <DefaultRolloverStrategy max="20"/>   <!--文件夹下最多的文件个数-->                 <TimeBasedTriggeringPolicy interval="2 hour"/><!--多长时间滚动一次-->                 <SizeBasedTriggeringPolicy size="100 MB"/><!-- 一个日志文件的最大大小 -->             </Policies>         </RollingFile>                      </appenders>     <!--然后定义logger，只有定义了logger并引入的appender，appender才会生效-->     <loggers>         <!--过滤掉spring和mybatis的一些无用的DEBUG信息-->        <logger name="org.springframework" level="INFO"></logger>         <logger name="org.mybatis" level="INFO"></logger>         <root level="all">             <appender-ref ref="Console"/>             <appender-ref ref="RollingFileInfo"/>             <appender-ref ref="RollingFileWarn"/>             <appender-ref ref="RollingFileError"/>         </root>     </loggers> </configuration>  

参考文章:  

http://www.cnblogs.com/hafiz/p/6170702.html

http://blog.csdn.net/u012729481/article/details/21094003