Apache Log4j2 是 Log4j1 的升级版,与 Log4j1 相比,Log4j2 有着重大的改进;Log4j2 也提供了 Logback 特有的很多功能,同时修复了 Logback(另一款日志框架)框架存在的一些固有问题。
API 分离
Log4j2 的 API 和实现已经分开,有利于应用开发者清楚他们可以使用的类和方法。
性能改进
Log4j2 包含了基于 LMAX Disruptor(高性能线程间消息通信库)的下一代 Asynchronous Loggers。在多线程环境下,Asynchronous Loggers 的吞吐量是 Log4j1 和 Logback 的 18 倍,而延迟时间也要低一个数量级。
支持多个 API
Log4j2 不但有着优异的性能,而且还提供了 Log4j1.2、SLF4J、Common Logging 和 java.util.logging(JUL)的 API。
自动配置加载
跟 Logback 相同的是,Log4j2 能够在配置修改之后自动重新加载配置。跟 Logback 不同的是,自动加载配置的过程中,Log4j2 不会丢失日志事件。
高级过滤
跟 Logback 一样,Log4j2 可以基于上下文数据、标签、正则表达式和日志事件中的其它元素进行过滤。我们可以在所有事件被传到 Loggers 或者 Appenders 之前指定过滤器,以此来决定哪些事件可以继续进入下一步。而且,过滤器可以和 Loggers 关联。与 Logback 不同的是,你可以在任何场景中使用一个公共的过滤器。
插件架构
Log4j2 使用插件模式来配置组件。因此,你不必写代码创建或配置 Appender、Layout、Pattern Converter 等,当配置引用到它们时,Log4j2 会自动识别并使用这些插件。
属性支持
你可以在配置中引用属性,Lo4j2 会自动替换它们,或者 Log4j2 会将它们传递到底层的组件并解析它们。属性来源于配置文件、系统属性、环境变量、ThreadContext Map 和事件中的数据。用户也可以通过新增 Lookup 插件来提供自定义的属性提供者。
Java Lambda 支持
以前,若打印的日志消息过于消耗资源,你通常会在打印日志前,显示地检查一下请求的日志级别是否启用。运行在 Java8 上的代码,就可以受益于 Log4j2 的 lambda 支持。如果请求的日志级别没有启用,Log4j 将不会解析 lambda 表达式,同时也会减少打印日志的代码量。
JAVA 版本要求
Log4j 2.4 及以上的版本要求 Java7,Log4j 2.0-alpha1 要求 Java6.
下载与安装
官方下载地址:https://logging.apache.org/log4j/2.x/download.html,下载构建好的包 apache-log4j-2.8.2-bin.tar.gz,也可以下载源码来研究 apache-log4j-2.8.2-src.tar.gz,后续文章的分析中会用到源码。如果用的 IDE 支持自动下载源码的话,就不需要在这里下载源码了。
如果你使用的是 Maven 构建工具,加入以下依赖即可:
<dependency>
<groupId>org.apache.logging.log4j
<artifactId>log4j-api
<version>2.8.2
</dependency>
<dependency>
<groupId>org.apache.logging.log4j
<artifactId>log4j-core
<version>2.8.2
</dependency>
配置到工程中
为了使用 Log4j2,你需要确保 API 和 CORE 包均已添加到应用 classpath 路径下。示例:
log4j-api-2.8.2.jar
log4j-core-2.8.2.jar
变更说明
Log4j2 与以前的版本是不兼容的,当你打算升级已有项目到 log4j2 之前,请牢记以下几点:
(1)Log4j2.4 及以上版本需要 Java7,2.0-alpha1 至 2.3 需要 Java6。
(2)XML 配置已被简化,且与 Log4j1.x 不兼容。
(3)从 2.4 开始支持 log4j2.properties 文件,但与 Log4j1.x 不兼容。
(4)支持使用 JSON 和 YAML 进行配置,但这些格式需要额外的依赖。
(5)尽管 Log4j2 不直接支持 Log4j1,但在从 Log4j1 升级到 Log4j2 的过程中,使用提供的兼容包可以减少代码的修改。
欢迎来到这里!
我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。
注册 关于