《Log4j 2 官方文档》多余性(Additivity)
如果我们希望输出com.foo.Bar
的TRACE等级的日志,而不像影响其他日志的输出。简单的改变日志等级是不能达到我们想要的目的;但是修改也很简单,只要我们添加一个新的Logger定义就可以达到目标。
<Logger name="com.foo.Bar" level="TRACE"/>
<Root level="ERROR">
<AppenderRef ref="STDOUT">
</Root>
这个配置达到了我们想要的目标,所有com.foo.Bar
的日志都会被输出,而其他组件的日志仅仅会输出ERROR
等级的日志。
在上面的例子,所有com.foo.Bar
的日志都会被输出到控制台。这是因为为com.foo.Bar
配置的Logger
没有设定任何的Appender
。
请看如下的配置
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<Logger name="com.foo.Bar" level="trace">
<AppenderRef ref="Console"/>
</Logger>
<Root level="error">
<AppenderRef ref="Console"/>
</Root>
</Loggers>
</Configuration>
将会输出
17:13:01.540 [main] TRACE com.foo.Bar - entry
17:13:01.540 [main] TRACE com.foo.Bar - entry
17:13:01.540 [main] ERROR com.foo.Bar - Did it again!
17:13:01.540 [main] TRACE com.foo.Bar - exit (false)
17:13:01.540 [main] TRACE com.foo.Bar - exit (false)
17:13:01.540 [main] ERROR MyApp - Didn't do it.
注意com.foo.bar
的TRACE
日志被输出了两次。
首先com.foo.Bar
关联的Logger
执行了一次,直接输出到控制台。接下来这个Logger
的父节点,也就是Root Logge
r执行了另一次输出,这是因为日志在com.foo.Bar
已经被输出,所以也会被父自动输出到控制台。这就是多余性,有的时候多余性的确是非常便捷的功能(前面的例子,我们增加了一个Logger
,但是没有设置Appender
,但是却正常工作了),有的时候却不是很方便,因此这个功能在Logger
中是可以通过additivity
的属性进行关闭的(设置成false)。
译者注:
首先Additivity的确不知道该翻译成什么更合适,感觉什么“附加性”“额外性”都不是很合适,最后觉得“多余性”更贴切些,如果有好的建议望指正。
其次这个多余性的特点,个人认为主要是让我们使用
Log4j2
的时候不用为每一个Logger指定Appender
方便配置;当然如果想单独指定Appender
,Log4j2
也是支持的。而且可以设置开关。
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<Logger name="com.foo.Bar" level="trace" additivity="false">
<AppenderRef ref="Console"/>
</Logger>
<Root level="error">
<AppenderRef ref="Console"/>
</Root>
</Loggers>
</Configuration>
上面配置的输出(译者的输出):
16:41:37.116 [main] TRACE com.foo.Bar - Enter
16:41:37.118 [main] ERROR com.foo.Bar - Did it again!
16:41:37.119 [main] TRACE com.foo.Bar - Exit with(false)
16:41:37.119 [main] ERROR com.foo.MyApp - Didn't do it.
一旦一个日志输出到一个Logger
,这个Logger
的additivity
设置为false
,那么这个日志不会再继续向父Logger
进行传递,忽略其他Logger
的additivity
的设置。
原创文章,转载请注明: 转载自并发编程网 – ifeve.com本文链接地址: 《Log4j 2 官方文档》多余性(Additivity)
自动重加载配置(Automatic Reconfiguration)
当通过一个文件加载配置的时候,Log4j可以自动识别配置文件发生变化,并根据变化重新加载。
如果 configuration 的属性monitorInterval 被设置了一个非0的值,那么Log4j2会周期性的检查配置文件。
接下来的例子展示了每隔30秒进行一次检测的例子。(最小的时间间隔是5秒,不能小于5)。
…
当通过一个文件加载配置的时候,Log4j可以自动识别配置文件发生变化,并根据变化重新加载。
如果 configuration 的属性monitorInterval 被设置了一个非0的值,那么Log4j2会周期性的检查配置文件。
接下来的例子展示了每隔30秒进行一次检测的例子。(最小的时间间隔是5秒,不能小于5)。
…
当通过一个文件加载配置的时候,Log4j可以自动识别配置文件发生变化,并根据变化重新加载。
如果 configuration 的属性monitorInterval 被设置了一个非0的值,那么Log4j2会周期性的检查配置文件。
接下来的例子展示了每隔30秒进行一次检测的例子。(最小的时间间隔是5秒,不能小于5)。
…
…