log4j2与log4j1的不同点(不完整):
- 前者配置文件格式多样性。log4j2的配置文件可以是xml,也可以是json。
- 在不修改web.xml的前提下,前者配置文件的命名可以为log4j2.xml,log4j.json,login4j.jsn等,后者只能是log4j.xml。
- 前者可以不添加配置文件,则默认情况下只会输出error和fatal级别的日志在控制台。
- maven项目中,前者不再需要在web.xml中设置配置文件的路径。
log4j2与log4j1的相同点(不完整):
- 文件默认存放目录都是classpath。
具体详细的相同与不同点在链接中可查看
log4j2的配置
<configuration status="error">
<!-- 先定义所有的appender -->
<appenders>
<!-- 这个输出控制台的配置 -->
<Console name="Console" target="SYSTEM_OUT">
<!-- 控制台只输出level及以上级别的信息(onMatch),其他的直接拒绝(onMismatch) -->
<ThresholdFilter level="trace" onMatch="ACCEPT" onMismatch="DENY"/>
<!-- 这个都知道是输出日志的格式 -->
<PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/>
</Console>
<!-- 文件会打印出所有信息,这个log每次运行程序会自动清空,由append属性决定,这个也挺有用的,适合临时测试用 -->
<!-- append为TRUE表示消息增加到指定文件中,false表示消息覆盖指定的文件内容,默认值是true -->
<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>
<!-- 添加过滤器ThresholdFilter,可以有选择的输出某个级别以上的类别 onMatch="ACCEPT" onMismatch="DENY"意思是匹配就接受,否则直接拒绝 -->
<File name="ERROR" fileName="logs/error.log">
<ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY"/>
<PatternLayout pattern="%d{yyyy.MM.dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/>
</File>
<!-- 这个会打印出所有的信息,每次大小超过size,则这size大小的日志会自动存入按年份-月份建立的文件夹下面并进行压缩,作为存档 -->
<RollingFile name="RollingFile" fileName="logs/web.log"
filePattern="logs/$${date:yyyy-MM}/web-%d{MM-dd-yyyy}-%i.log.gz">
<PatternLayout pattern="%d{yyyy-MM-dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/>
<SizeBasedTriggeringPolicy size="2MB"/>
</RollingFile>
</appenders>
<!-- 然后定义logger,只有定义了logger并引入的appender,appender才会生效 -->
<loggers>
<!-- 建立一个默认的root的logger -->
<root level="trace">
<appender-ref ref="RollingFile"/>
<appender-ref ref="Console"/>
<appender-ref ref="ERROR" />
<appender-ref ref="log"/>
</root>
</loggers>
</configuration>
上面的配置中,以xml的方式配置了log4j2,文件名命名为log4j2.xml。
文件的根元素为configuration,元素中有一个属性status,该属性表示log4j本身的日志信息打印级别。如果设置为最低级别的trace,则会打印一些log4j加载插件、组装logger等调试信息。同时还有另一个属性monitorInterval,用来配置默认扫描文件的间隔时间,单位是秒,可以在不重启应用的情况下重新加载配置文件。
根元素下有两个子元素appenders和loggers。
appenders:输出源,配置控制台输出,文件输出等,包括子元素Console,File,RollingFile等。
Console:日志输出控制台。有两个属性:
name:输出源名称,唯一。
target:输出目标,一般为SYSTEM_OUT,表示控制台。
file:输出日志在指定文件。有两个属性:
name:输出源名称,唯一。
filename:输出的日志文件存放的路径。
RollingFile:输出日志在指定文件,如果文件大于指定size,则按照配置进行压缩存档。有三个属性,及一个额外的子标签size:
name:输出源名称,唯一。
fileName:日志存放文件名。
filePattern:指定压缩包位置,及压缩包中文件的命名形式,例如:filePattern="ogs/$${date:yyyy-MM}/web-%d{MM-dd-yyyy}-%i.log.gz"
SizeBasedTriggeringPolicy标签:有属性size,指定文件达到多大后进行压缩存档,例如:size="2MB"
TimeBasedTriggeringPolicy和SizeBasedTriggeringPolicy,前者表示更新日志文件的频率(单位为filePattern中最小的时间粒度,如%d{MM}则一个月更新一次,如%d{MM-dd}则一天更新一次),后者表示文件大小达到10mb更新一次。DefaultRolloverStrategy规定压缩包中最多多少个文件。
<Policies>
<TimeBasedTriggeringPolicy interval="1" />
<SizeBasedTriggeringPolicy size="10 MB" />
</Policies>
<DefaultRolloverStrategy max="20" />
每一种输出下有两个子元素PatternLayout和ThresholdFilter,前者用来配置输出格式,后者用来输出级别。
PatternLayout:
%d{HH:mm:ss.SSS} 表示输出到毫秒的时间。
%t 输出当前线程名称。
%-5level 输出日志级别,-5表示左对齐并且固定输出5个字符,如果不足在右边补0。
%logger 输出logger名称,因为Root Logger没有名称,所以没有输出。
%msg 日志文本。
%n 换行。
%F 输出所在的类文件名,如Client.java
%L 输出行号
%M 输出所在方法名
%l 输出语句所在的行数, 包括类名、方法名、文件名、行数
ThresholdFilter:其下有如下属性
level:级别。
onMatch:满足级别匹配的处理方式,ACCEPT为输出,DENY为拒绝
onMismatch:不满足级别匹配的处理方式。
loggers:配置日志记录器,该标签下,必须配置一个默认的日志记录器。
默认日志记录器:使用标签root,有一个属性level,表示输出的日志级别。里面可以配置一个或多个输出源。
其他日志记录器:使用标签Logger,有如下属性:
name:该日志记录器的name,唯一。
level:输出日志的级别。
additivity:布尔值,如果为false,则只会输出该日志记录器中配置的输出源,如果为true,则还会输出默认日志记录器中的输出源。