java日志框架详解

1. 常用日志框架

对于一个应用程序来说日志记录是必不可少的一部分。线上问题追踪&＃xff0c;基于日志的业务逻辑统计分析等都离不日志。Java领域存在多种日志框架&＃xff0c;目前常用的日志框架包括Log4j&＃xff0c;Log4j 2&＃xff0c;Commons Logging&＃xff0c;Slf4j&＃xff0c;Logback&＃xff0c;Jul等。

1.1 Java常用日志框架类别

• Slf4j&＃xff1a; Simple Logging Facade for Java&＃xff0c;缩写Slf4j。类似于Commons Logging&＃xff0c;是一套简易Java日志门面&＃xff0c;本身并无日志的实现。
• Logback&＃xff1a; 一套日志组件的实现(slf4j阵营)。
• Commons Logging&＃xff1a; Apache基金会所属的项目&＃xff0c;是一套Java日志接口&＃xff0c;之前叫Jakarta Commons Logging&＃xff0c;后更名为Commons Logging。
• JUL&＃xff1a; Java Util Logging&＃xff0c;自Java1.4以来的官方日志实现。
• Log4j&＃xff1a; Apache Log4j是一个基于Java的日志记录工具。它是由Ceki Gülcü首创的&＃xff0c;现在则是Apache软件基金会的一个项目。 Log4j是几种Java日志框架之一。
• Log4j2 &＃xff1a; Apache Log4j 2是apache开发的一款Log4j的升级产品。
  看了上面的介绍是否会觉得比较混乱&＃xff0c;这些日志框架之间有什么异同&＃xff0c;都是由谁在维护? 下文会逐一介绍。

1.2 Java常用日志框架历史

• 1996年早期&＃xff0c;欧洲安全电子市场项目组决定编写它自己的程序跟踪API(Tracing API)。经过不断的完善&＃xff0c;这个API终于成为一个十分受欢迎的Java日志软件包&＃xff0c;即Log4j。后来Log4j成为Apache基金会项目中的一员。
• 期间Log4j近乎成了Java社区的日志标准。据说Apache基金会还曾经建议sun引入Log4j到java的标准库中&＃xff0c;但Sun拒绝了。
• 2002年Java1.4发布&＃xff0c;Sun推出了自己的日志库JUL(Java Util Logging),其实现基本模仿了Log4j的实现。在JUL出来以前&＃xff0c;log4j就已经成为一项成熟的技术&＃xff0c;使得log4j在选择上占据了一定的优势。
• 接着&＃xff0c;Apache推出了Jakarta Commons Logging&＃xff0c;JCL只是定义了一套日志接口(其内部也提供一个Simple Log的简单实现)&＃xff0c;支持运行时动态加载日志组件的实现&＃xff0c;也就是说&＃xff0c;在你应用代码里&＃xff0c;只需调用Commons Logging的接口&＃xff0c;底层实现可以是log4j&＃xff0c;也可以是Java Util Logging。
• 后来(2006年)&＃xff0c;Ceki Gülcü不适应Apache的工作方式&＃xff0c;离开了Apache。然后先后创建了slf4j(日志门面接口&＃xff0c;类似于Commons Logging)和Logback(Slf4j的实现)两个项目&＃xff0c;并回瑞典创建了QOS公司&＃xff0c;QOS官网上是这样描述Logback的&＃xff1a;The Generic&＃xff0c;Reliable Fast&Flexible Logging Framework(一个通用&＃xff0c;可靠&＃xff0c;快速且灵活的日志框架)。
• 现今&＃xff0c;Java日志领域被划分为两大阵营&＃xff1a;Commons Logging阵营和SLF4J阵营。
  Commons Logging在Apache大树的笼罩下&＃xff0c;有很大的用户基数。但有证据表明&＃xff0c;形式正在发生变化。2013年底有人分析了GitHub上30000个项目&＃xff0c;统计出了最流行的100个Libraries&＃xff0c;可以看出slf4j的发展趋势更好。
  
• Apache眼看有被Logback反超的势头&＃xff0c;于2012-07重写了log4j 1.x&＃xff0c;成立了新的项目Log4j 2。Log4j 2具有logback的所有特性。

1.3 两大日志接口阵营

• 由Apache公司研发的Jakarta Commons Logging &＃xff0c;简称 Commons Logging 接口或者JCL。
• 由从Apache跳槽的Ceki Gülcü 研发的Simple Logging Facade for Java&＃xff0c;简称 slf4j接口。

1.3.1 基于Commons Logging 接口实现的常用日志框架

• JUL
• Log4j

1.3.2 基于SLF4J接口实现的常用日志框架

• Logback
• Log4j
• JUL
• 其他如下图所示&＃xff1a;

2. 日志框架的使用

2.1 SLF4J接口及其具体实现的使用

2.1.1 首先添加slf4j-api-1.7.26.jar到classpath&＃xff0c;maven项目可以用maven坐标&＃xff0c;非maven项目可以直接下载。
比如使用maven时&＃xff1a;

org.slf4jslf4j-api1.7.16



就会自动加载该jar包到项目中。不用去网上下载。如下图所示。

2.2.2 其次是添加具体实现。

• slf4j-log4j12-1.7.26.jar
  绑定log4j version 1.2&＃xff0c;一个广泛使用的日志框架。可以手动下载也可以使用maven下载。推荐使用maven。方便。

org.slf4jslf4j-log4j121.7.26



在pom.xml文件中添加该依赖之后&＃xff0c;会自动下载三个jar包&＃xff0c;一个是slf4j-log4j12-1.7.26.jar&＃xff0c;另外两个是slf4j-api-1.7.26.jar&＃xff0c;还有一个就是具体实现的log4j-1.2.17.jar。只要添加这个依赖&＃xff0c;就会下载相关的jar包&＃xff0c;不用重复添加slf4j-api-1.7.26.jar的依赖了。

• slf4j-jdk14-1.7.26.jar
  绑定java.util.logging。可以手动下载也可以使用maven下载。推荐使用maven。方便。

org.slf4jslf4j-jdk141.7.26



由上图可以看到。会自动加载slf4j-api-1.7.26.jar以及slf4j-jdk4-1.7.26.jar到项目中。具体实现是由JVM来实现的。故没有额外的具体实现的jar包。

• logback-classic-1.2.3.jar (不使用maven的话&＃xff0c;还需要添加一个 logback-core-1.2.3.jar)
  Logback类是SLF4J 接口的直接实现。因此&＃xff0c;将SLF4J与logback结合使用会严格限制零内存和计算开销。

ch.qos.logbacklogback-classic1.2.3



如上图所示&＃xff0c;该依赖会自动下载slf4j-api-1.7.25.jar、logback-classic-1.2.3.jar 以及 logback-core-1.2.3.jar。

• slf4j-jcl-1.7.26.jar
  绑定Jakarta Commons Logging。此绑定将委派所有SLF4J日志记录到JCL。
  
  如上图所示&＃xff0c;该依赖会自动下载slf4j-jcl-1.7.26.jar、slf4j-jcl-1.7.26.jar 以及 commons-logging-1.1.1.jar。
• slf4j-nop-1.7.26.jar
  绑定NOP&＃xff0c;静默丢弃所有日志记录。
• slf4j-simple-1.7.26.jar
  绑定一个简单的实现&＃xff0c;将所有事件输出到System.err。仅打印I​​NFO级别以上的消息。此绑定在小应用程序的上下文中可能很有用。

要切换基于SLF4J实现的日志框架&＃xff0c;只需替换类路径上的slf4j绑定。例如&＃xff0c;要从java.util.logging切换到log4j&＃xff0c;只需将slf4j-jdk14-1.7.26.jar替换为slf4j-log4j12-1.7.26.jar即可。
后面3种官网没有给maven依赖&＃xff0c;只能下载相关jar包&＃xff0c;并配置classpath。

在项目中如果用slf4j-api作为日志门面&＃xff0c;有多个日志实现组件同时存在&＃xff0c;例如同时存在Logback&＃xff0c;slf4j-log4j12&＃xff0c;slf4j-jdk14&＃xff0c;slf4j-jcl四种实现&＃xff0c;则在项目实际运行中&＃xff0c;Slf4j的绑定选择绑定方式将有Jvm确定&＃xff0c;并且是随机的&＃xff0c;这样会和预期不符&＃xff0c;实际使用过程中需要避免这种情况。

2.2 JCL接口及其具体实现的使用

因本人没用过JCL&＃xff0c;具体使用细节请参考这篇博客。 https://blog.csdn.net/backbug/article/details/78655664

3. 日志框架之间的兼容

在实际环境中我们经常会遇到不同的组件使用的日志框架不同的情况&＃xff0c;例如Spring Framework使用的是日志组件是log4j&＃xff0c;XSocket依赖的则是Java Util Logging。当我们在同一项目中使用不同的组件时应该如果解决不同组件依赖的日志组件不一致的情况呢&＃xff1f;现在我们需要统一日志方案&＃xff0c;统一使用SLF4J&＃xff0c;把他们的日志输出重定向到SLF4J&＃xff0c;然后 SLF4J 又会根据绑定器把日志交给具体的日志实现工具。因此我们可以先将log4j输出重定向到slf4j&＃xff0c;再把slf4j结果输出到与其绑定的jul上面。Slf4j带有几个桥接模块&＃xff0c;可以重定向log4j&＃xff0c;JCL和java.util.logging中的API到Slf4j。


上图给出了三种桥接方式已经对应的jar包。
没有将logback的输出重定向到slf4j的jar包&＃xff1f;
可能因为logback是Native实现吧。

4. 使用Slf4j桥接注意事项

在使用Slf4j桥接时要注意避免形成死循环&＃xff0c;在项目依赖的jar包中不要存在以下情况。

5. 总结

推荐在项目中使用SLF4J&＃43;logback的方式实现日志框架。

• Slf4j实现机制决定Slf4j限制较少&＃xff0c;使用范围更广。由于Slf4j在编译期间&＃xff0c;静态绑定本地的LOG库使得通用性要比Commons
  logging要好。
• Logback拥有更好的性能。Logback声称&＃xff1a;某些关键操作&＃xff0c;比如判定是否记录一条日志语句的操作&＃xff0c;其性能得到了显著的提高。这个操作在Logback中需要3纳秒&＃xff0c;而在Log4J中则需要30纳秒。LogBack创建记录器&＃xff08;logger&＃xff09;的速度也更快&＃xff1a;13毫秒&＃xff0c;而在Log4J中需要23毫秒。更重要的是&＃xff0c;它获取已存在的记录器只需94纳秒&＃xff0c;而Log4J需要2234纳秒&＃xff0c;时间减少到了1/23。跟JUL相比的性能提高也是显著的。
• Commons Logging开销更高 在使Commons Logging时为了减少构建日志信息的开销&＃xff0c;通常的做法是&＃xff1a;
  if(log.isDebugEnabled()){ log.debug(“User name&＃xff1a; " &＃43; user.getName() &＃43;
  " buy goods id &＃xff1a;” &＃43; good.getId()); } 在Slf4j阵营&＃xff0c;你只需这么做&＃xff1a; log.debug(“User
  name&＃xff1a;{} ,buy goods id &＃xff1a;{}”, user.getName(),good.getId());
  也就是说&＃xff0c;slf4j把构建日志的开销放在了它确认需要显示这条日志之后&＃xff0c;减少内存和cup的开销&＃xff0c;使用占位符号&＃xff0c;代码也更为简洁
• Logback文档免费。Logback的所有文档是全面免费提供的&＃xff0c;不象Log4J那样只提供部分免费文档而需要用户去购买付费文档。

我们在项目中加入以下依赖即可。

ch.qos.logbacklogback-classic1.2.3



添加完依赖后&＃xff0c;还需要编写logback的配置文件添加配置文件logback.xml才可以run。


System.out${pattern}${LOG_DIR}/sql_info.log${LOG_DIR}/sql_info_%d{yyyy-MM-dd}.log.%i.gz20MB10${pattern}INFOACCEPTDENY${LOG_DIR}/sql_error.log${LOG_DIR}/sql_error_%d{yyyy-MM-dd}.log.%i.gz20MB10${pattern}ERRORACCEPTDENY${LOG_DIR}/info.log${LOG_DIR}/info.%d{yyyy-MM-dd}.log[%date{yyyy-MM-dd HH:mm:ss}] [%-5level] [%thread] [%logger:%line]--%mdc{client} %msg%nINFOACCEPTDENY%d{yyyyMMdd:HH:mm:ss.SSS}%thread%-5level%F{32}%M%L%msg${LOG_DIR}/test.htmlinfo


参考链接&＃xff1a;
https://www.cnblogs.com/chenhongliang/p/5312517.html
https://www.slf4j.org/manual.html
https://www.jianshu.com/p/b3dedb8fb61e