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. -->
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"?>
3. <!-- No need to set system property "log4j2.contextSelector" to any value
4. when using <asyncLogger> or <asyncRoot>. -->
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之日誌記錄器