log4j2之日志记录器

标签：选项   actual   level   red   UNC   current   doc   相关   应用程序   

log4j2之日志记录器

   详见官网配置说明: https://logging.apache.org/log4j/2.x/manual/async.html

 1. 使所有记录器异步

Log4j-2.9及更高版本在类路径上需要disruptor-3.3.4.jar或更高版本。在Log4j-2.9之前，需要disruptor-3.0.0.jar或更高版本。

这是最简单的配置，并提供最佳性能。要使所有记录器异步，请将disruptor jar添加到类路径，并将系统属性log4j2.contextSelector设置 为org.apache.logging.log4j.core.async.AsyncLoggerContextSelector。

默认情况下，异步记录器不会将位置传递给I / O线程。如果您的某个布局或自定义过滤器需要位置信息，则需要在所有相关记录器的配置中设置“includeLocation = true”，包括根记录器。

不需要位置的配置可能如下所示：

     <!-- Don‘t forget to set system property

          -Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector

         to make all loggers asynchronous. --

           <?xml version="1.0" encoding="UTF-8"?> 

           <!-- Don‘t forget to set system property

1. -Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector
2. to make all loggers asynchronous. -->
3.  
4. <Configuration status="WARN">
5. <Appenders>
6. <!-- Async Loggers will auto-flush in batches, so switch off immediateFlush. -->
7. <RandomAccessFile name="RandomAccessFile" fileName="async.log" immediateFlush="false" append="false">
8. <PatternLayout>
9. <Pattern>%d %p %c{1.} [%t] %m %ex%n</Pattern>
10. </PatternLayout>
11. </RandomAccessFile>
12. </Appenders>
13. <Loggers>
14. <Root level="info" includeLocation="false">
15. <AppenderRef ref="RandomAccessFile"/>
16. </Root>
17. </Loggers>
18. </Configuration>

当使用AsyncLoggerContextSelector使所有记录器异步时，请确保在配置中使用普通的 <root>和<logger>元素。AsyncLoggerContextSelector将确保所有记录器都是异步的，使用的机制与配置<asyncRoot> 或<asyncLogger>时所发生的机制不同。后面的元素用于将异步与同步记录器混合。如果同时使用这两种机制，最终会有两个后台线程，应用程序将日志消息传递给线程A，线程A将消息传递给线程B，线程B最后将消息记录到磁盘。这是有效的，但中间会有一个不必要的步骤。

您可以使用一些系统属性来控制异步日志记录子系统的各个方面。其中一些可用于调整日志记录性能。

还可以通过创建名为log4j2.component.properties的文件并在应用程序的类路径中包含此文件来指定以下属性 。

请注意，系统属性在Log4j 2.10.0中重命名为更一致的样式。此处还记录了所有旧属性名称。

混合同步和异步记录器

Log4j-2.9及更高版本在类路径上需要disruptor-3.3.4.jar或更高版本。在Log4j-2.9之前，需要disruptor-3.0.0.jar或更高版本。无需将系统属性“Log4jContextSelector”设置为任何值。

可以在配置中组合同步和异步记录器。这为您提供了更大的灵活性，但代价是性能略有下降（与使所有记录器异步相比）。使用<asyncRoot>或<asyncLogger> 配置元素指定需要异步的记录器。配置只能包含一个根记录器（<root> 或<asyncRoot>元素），但是可以组合异步和非异步记录器。例如，包含<asyncLogger>元素的配置文件也可以包含<root>和 < 同步记录器的元素。

默认情况下，异步记录器不会将位置传递给I / O线程。如果您的某个布局或自定义过滤器需要位置信息，则需要在所有相关记录器的配置中设置“includeLocation = true”，包括根记录器。

混合异步记录器的配置可能如下所示：

1. <?xml version="1.0" encoding="UTF-8"?>
2.  
3. <!-- No need to set system property "log4j2.contextSelector" to any value
4. when using <asyncLogger> or <asyncRoot>. -->
5.  
6. <Configuration status="WARN">
7. <Appenders>
8. <!-- Async Loggers will auto-flush in batches, so switch off immediateFlush. -->
9. <RandomAccessFile name="RandomAccessFile" fileName="asyncWithLocation.log"
10. immediateFlush="false" append="false">
11. <PatternLayout>
12. <Pattern>%d %p %class{1.} [%t] %location %m %ex%n</Pattern>
13. </PatternLayout>
14. </RandomAccessFile>
15. </Appenders>
16. <Loggers>
17. <!-- pattern layout actually uses location, so we need to include it -->
18. <AsyncLogger name="com.foo.Bar" level="trace" includeLocation="true">
19. <AppenderRef ref="RandomAccessFile"/>
20. </AsyncLogger>
21. <Root level="info" includeLocation="true">
22. <AppenderRef ref="RandomAccessFile"/>
23. </Root>
24. </Loggers>
25. </Configuration>

您可以使用一些系统属性来控制异步日志记录子系统的各个方面。其中一些可用于调整日志记录性能。

还可以通过创建名为log4j2.component.properties的文件并在应用程序的类路径中包含此文件来指定以下属性 。

请注意，系统属性在Log4j 2.10中重命名为更一致的样式。此处还记录了所有旧属性名称。

log4j2之日志记录器

标签：选项   actual   level   red   UNC   current   doc   相关   应用程序   

原文地址：https://www.cnblogs.com/8341-jack/p/9830587.html