Async Logger

Async Logger 是一个让日志记录操作异步化的 Minecraft 模组。

在原版中，日志记录器不是异步的。这意味着实际的日志记录操作（包括 I/O 操作）都发生在日志线程上。本模组将日志记录改为异步，以获得更好的性能。

当记录大量消息和/或启用调试日志记录时（Forge / NeoForge 默认开启），这一点尤其有用。

基准测试

| 项目 | 原版 | AsyncLogger |
|———————————-|———–|————-|
| 简单消息 (10k) | 6146.1ms | 141.2ms |
| 带占位符的消息 (10k) | 6413.2ms | 96.6ms |
| 带 Throwable 的消息 (1.5k) | 19572.4ms | 9.0ms |

你可以在配置中启用 testPerformance 来自己进行这些测试。启用此选项后，模组会在设置异步日志记录器之前和之后分别记录大量消息。你可以在日志中看到测试结果。

过滤

从 2.0.0 版本开始，AsyncLogger 支持日志过滤。过滤发生在专用的异步日志记录器线程上，确保调用方没有额外开销。

要使用，只需在配置中将 filtering.enabled 设置为 true，并编辑一个或多个过滤器。支持按日志记录器名称、级别和消息（匹配子字符串或正则表达式）进行过滤。

技术细节

• 使用了异步日志记录器，而非异步附加器。前者更新、更快，且分配率更低。
• 异步日志记录器需要 LMAX Disruptor，一个无锁的线程间通信库。当系统中不存在该库时，模组会将其加载到系统类加载器上。本模组根据 Apache-2.0 许可证重新分发 LMAX Disruptor。
• 配置文件允许轻松控制一些 log4j2 设置。
• System.out 和 System.err 可以重定向到日志记录器。