《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.barTRACE日志被输出了两次。

首先com.foo.Bar关联的Logger执行了一次,直接输出到控制台。接下来这个Logger的父节点,也就是Root Logger执行了另一次输出,这是因为日志在com.foo.Bar已经被输出,所以也会被父自动输出到控制台。这就是多余性,有的时候多余性的确是非常便捷的功能(前面的例子,我们增加了一个Logger,但是没有设置Appender,但是却正常工作了),有的时候却不是很方便,因此这个功能在Logger中是可以通过additivity的属性进行关闭的(设置成false)。

译者注:

首先Additivity的确不知道该翻译成什么更合适,感觉什么“附加性”“额外性”都不是很合适,最后觉得“多余性”更贴切些,如果有好的建议望指正。

其次这个多余性的特点,个人认为主要是让我们使用Log4j2的时候不用为每一个Logger指定Appender方便配置;当然如果想单独指定AppenderLog4j2也是支持的。而且可以设置开关。

<?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,这个Loggeradditivity设置为false,那么这个日志不会再继续向父Logger进行传递,忽略其他Loggeradditivity的设置。

原创文章,转载请注明: 转载自并发编程网 – ifeve.com本文链接地址: 《Log4j 2 官方文档》多余性(Additivity)

  • Trackback 关闭
  • 评论 (4)
    • tornadojava
    • 2016/12/27 10:30上午

    自动重加载配置(Automatic Reconfiguration)

    当通过一个文件加载配置的时候,Log4j可以自动识别配置文件发生变化,并根据变化重新加载。

    如果 configuration 的属性monitorInterval 被设置了一个非0的值,那么Log4j2会周期性的检查配置文件。

    接下来的例子展示了每隔30秒进行一次检测的例子。(最小的时间间隔是5秒,不能小于5)。

    • tornadojava
    • 2016/12/27 10:31上午

    当通过一个文件加载配置的时候,Log4j可以自动识别配置文件发生变化,并根据变化重新加载。
    如果 configuration 的属性monitorInterval 被设置了一个非0的值,那么Log4j2会周期性的检查配置文件。
    接下来的例子展示了每隔30秒进行一次检测的例子。(最小的时间间隔是5秒,不能小于5)。

    • tornadojava
    • 2016/12/27 10:32上午

    当通过一个文件加载配置的时候,Log4j可以自动识别配置文件发生变化,并根据变化重新加载。
    如果 configuration 的属性monitorInterval 被设置了一个非0的值,那么Log4j2会周期性的检查配置文件。
    接下来的例子展示了每隔30秒进行一次检测的例子。(最小的时间间隔是5秒,不能小于5)。

    • tornadojava
    • 2016/12/27 10:32上午

return top