Spring Boot（十）Logback和Log4j2集成与日志发展史

逃离我推掉我的手 2023-10-18 10:39 26阅读 0赞

## 一、简介 ##

Java知名的日志有很多，比如：JUL、Log4j、JCL、SLF4J、Logback、Log4j2，那么这些日志框架之间有着怎样的关系？诞生的原因又是解决什么问题？下面一起来看。

### 1.1 JUL ###

Java有自己的日志框架JUL（Java Util Logging）在java.util.logging下，因为对开发者不友好，使用成本太高和日志级别分类不清晰的问题，所有很少有开发者用。

### 1.2 Log4j ###

因为JUL的缺陷问题，这就给了Log4j机会，所有Log4j一经推出就迅速风靡全球。

### 1.3 JCL ###

JCL是Jakarta Commons-Logging的缩写，Jakarta在这里指的是一个组织，而不是印度的首都雅加达，Jakarta，一个早期的Apache开源项目，用于管理各个Java子项目，诸如Tomcat, Ant, Maven, Struts, JMeter, Velocity, JMeter, Commons等。2011年12月，在所有子项目都被迁移为独立项目后，Jakarta名称就不再使用了。

JCL诞生的初衷是因为Java自身的一些包用了JUL，而Log4j用户使用的有很多，那么JCL就是提供一套API来实现不同Logger之间的切换。

### 1.4 SLF4J ###

SLF4J（Simple Logging Facade For Java）简单日志门面，和JCL功能类似，但JCL有一个致命的缺点就是算法复杂，出现问题难以排除，而SLF4J的诞生就是为了解决JCL的缺点。

值得一提的是SLF4J的作者就是Log4j的作者。

### 1.5 Logback ###

Logback是Log4j的作者的另一个开源日志组件，与Log4j相比，Logback重新了内核，使它的性能提升了很多，大约是Log4j的10倍，同时占用更小的内存，并且完整的实现了SLF4J API是你可以很方便的切换日志框架。

### 1.6 Log4j2 ###

Log4j2有着和Logback相同的功能，但又有自己单用的功能，比如：插件式结构、配置文件优化、异步日志等。

Log4j2是Log4j的升级，它比其前身Log4j 1.x提供了重大改进，并提供了Logback中可用的许多改进，同时修复了Logback架构中的一些固有问题。

从GitHub的更新日志来看，Logback已经有半年没有更新了，而作为知名组织的Apache下的Log4j2的更新却是非常活跃的，Log4j 1.x 于2015年8月停止维护更新了。

**GitHub地址**

Logback：[https://github.com/qos-ch/logback][https_github.com_qos-ch_logback]

log4j2：[https://github.com/apache/logging-log4j2][https_github.com_apache_logging-log4j2]

本文分别来看Logback和Log4j2在Spring Boot中的实现。

## 二、Logback使用 ##

开发环境

*  JDK 8
 *  Spring Boot 2.0.4 RELEASE
 *  Maven
 *  Windows 10
 *  IDEA 2018.2

### 2.1 Logback的使用 ###

Spring Boot默认集成了Logback，可以开箱即用，非常方便。因为spring-boot-starter-logging是Logback的日志实现，而Spring Boot启动项spring-boot-starter又依赖了spring-boot-starter-logging，所以Spring Boot就默认集成了Logback，包依赖如下图：

![300][]

日志是默认控制台输出的，我们程序启动的时候就使用Logback，如下图所示：

![springboot-log2.png][]

日志组成解读：

*  日期和时间：毫秒精度，易于排序
 *  日志级别：trace、debug、info、warn、error（日志级别依次从低到高）
 *  进程ID
 *  `---`分隔符
 *  线程名称：括在方括号中(可以截断控制台输出)
 *  记录器名称：这通常是源类名(通常缩写)
 *  日志具体信息

### 2.2 输入文件 ###

如果需要输出日志到文件，只需要在application.properties配置文件设置：logging.file或logging.path，示例如下：

logging.level.root=info
    logging.file=D:\\log\\my.log

可以通过设置日志的级别，忽略更低级别的日志输出。

**注意：** logging.file和logging.path设置一个属性即可，如果两个都设置，则以logging.file为主，logging.path无效。

日志文件容量设置：使用“logging.file.max-history”属性为日志最大容量设置，默认10M超过则分割为多个文件。

### 2.3 自定义日志配置 ###

日志服务在ApplicationContext创建前就初始化了，所以通过设置属性和传统的配置XML文件，可以对日志进行管理和控制。

只需要在src/main/resources下，创建好约定名称的XML文件，即可完成对日志系统的设置，不同的日志系统有不同的约定名称，如下列表：

<table> 
 <thead> 
  <tr> 
   <th>日志</th> 
   <th>名称</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>logback</td> 
   <td>logback-spring.xml, logback-spring.groovy, logback.xml, 或者 logback.groovy</td> 
  </tr> 
  <tr> 
   <td>log4j2</td> 
   <td>log4j2-spring.xml 或者 log4j2.xml</td> 
  </tr> 
 </tbody> 
</table>

Spring Boot官方建议使用“-spring”的命名规则，进行日志配置，如：logback-spring.xml而不是logback.xml。

当然你也可以自定义日志名称，只需要在application.properties配置即可，代码如下：

> logging.config=classpath:logging-config.xml

来看一个logback-spring.xml示例文件：

<?xml version="1.0" encoding="UTF-8"?>
    <configuration>
    
        
        <springProperty scope="context" name="LOG_HOME" source="logging.path" defaultValue="/data/logs/spring-boot-logback"/>
    
        
        <springProperty scope="context" name="LOG_ROOT_LEVEL" source="logging.level.root" defaultValue="DEBUG"/>
    
        
        <springProperty scope="context" name="STDOUT" source="log.stdout" defaultValue="STDOUT"/>
    
        
        <property name="LOG_PREFIX" value="spring-boot-logback" />
    
        
        <property name="LOG_CHARSET" value="UTF-8" />
    
        
        <property name="LOG_DIR" value="${LOG_HOME}/%d{yyyyMMdd}" />
    
        
        <property name="LOG_MSG" value="- | [%X{requestUUID}] | [%d{yyyyMMdd HH:mm:ss.SSS}] | [%level] | [${HOSTNAME}] | [%thread] | [%logger{36}] | --> %msg|%n "/>
    
        
        <property name="MAX_FILE_SIZE" value="50MB" />
    
        
        <property name="MAX_HISTORY" value="10"/>
    
        
        <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
            
            <layout class="ch.qos.logback.classic.PatternLayout">
                <pattern>${LOG_MSG}</pattern>
            </layout>
        </appender>
    
        
        <appender name="0" class="ch.qos.logback.core.rolling.RollingFileAppender">
        </appender>
    
        
        <appender name="FILE_ALL" class="ch.qos.logback.core.rolling.RollingFileAppender">
            
            <File>${LOG_HOME}/all_${LOG_PREFIX}.log</File>
    
            
            <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
    
                
                <FileNamePattern>${LOG_DIR}/all_${LOG_PREFIX}%i.log</FileNamePattern>
    
                
                <MaxHistory>${MAX_HISTORY}</MaxHistory>
    
                
                <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                    <maxFileSize>${MAX_FILE_SIZE}</maxFileSize>
                </timeBasedFileNamingAndTriggeringPolicy>
    
            </rollingPolicy>
    
            
            <layout class="ch.qos.logback.classic.PatternLayout">
                <pattern>${LOG_MSG}</pattern>
            </layout>
        </appender>
    
        
        <appender name="FILE_ERROR" class="ch.qos.logback.core.rolling.RollingFileAppender">
            
            <filter class="ch.qos.logback.classic.filter.LevelFilter">
                <level>ERROR</level>
                <OnMismatch>DENY</OnMismatch>
                <OnMatch>ACCEPT</OnMatch>
            </filter>
            
            <File>${LOG_HOME}/err_${LOG_PREFIX}.log</File>
    
            
            <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
    
                
                <FileNamePattern>${LOG_DIR}/err_${LOG_PREFIX}%i.log</FileNamePattern>
    
                
                <MaxHistory>${MAX_HISTORY}</MaxHistory>
    
                
                <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                    <maxFileSize>${MAX_FILE_SIZE}</maxFileSize>
                </timeBasedFileNamingAndTriggeringPolicy>
            </rollingPolicy>
    
            
            <layout class="ch.qos.logback.classic.PatternLayout">
                <Pattern>${LOG_MSG}</Pattern>
            </layout>
        </appender>
    
        
    
        <logger name="org.springframework"     level="ERROR" />
        <logger name="org.apache.commons"      level="ERROR" />
        <logger name="org.apache.zookeeper"    level="ERROR"  />
        <logger name="com.alibaba.dubbo.monitor" level="ERROR"/>
        <logger name="com.alibaba.dubbo.remoting" level="ERROR" />
    
        
        <root level="${LOG_ROOT_LEVEL}">
    
            
            <appender-ref ref="${STDOUT}"/>
    
            
            <appender-ref ref="FILE_ALL"/>
    
            
            <appender-ref ref="FILE_ERROR"/>
        </root>
    
    </configuration>

### 2.4 代码中使用日志 ###

在代码中使用日志，只需要使用如下代码：

private Logger logger = LoggerFactory.getLogger(this.getClass());
    //...
    logger.debug("this is debug");
    logger.info("this is info");

## 三、Log4j2集成 ##

### 3.1 配置依赖组件 ###

Spring Boot添加Log4j2依赖的同时，需要排除Logback依赖，配置pom.xml代码如下：

<dependencies>
    		<dependency>
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-starter-web</artifactId>
    			<exclusions>
    				<exclusion>
    					<groupId>org.springframework.boot</groupId>
    					<artifactId>spring-boot-starter-logging</artifactId>
    				</exclusion>
    			</exclusions>
    		</dependency>
    		
    		<dependency> 
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-starter-log4j2</artifactId>
    		</dependency>
    </dependencies>

### 3.2 自定义日志配置 ###

添加log4j2-spring.xml文件在src/main/resources文件下，配置文件代码如下：

<?xml version="1.0" encoding="UTF-8"?>
    <configuration>
    	<Appenders>
    		<Console name="CONSOLE" target="SYSTEM_OUT">
    			<PatternLayout charset="UTF-8" pattern="[%-5p] %d %c - %m%n" />
    		</Console>
    
    		<File name="File" fileName="D:\\mylog.log">
    			<PatternLayout pattern="%m%n" />
    		</File>
    	</Appenders>
    
    	<Loggers>
    		<root level="info">
    			<AppenderRef ref="CONSOLE" />
    			<AppenderRef ref="File" />
    		</root>
    	</Loggers>
    </configuration>

输入日志到控制台和D盘mylog.log文件中。

到此为止，已经完成了log4j2的集成，运行项目，查看日志。

示例源码：[https://github.com/vipstone/springboot-example/tree/master/springboot-logging][https_github.com_vipstone_springboot-example_tree_master_springboot-logging]

**参考资料**

JAVA日志的前世今生：[https://www.cnblogs.com/xiexj/p/9417128.html][https_www.cnblogs.com_xiexj_p_9417128.html]

[https_github.com_qos-ch_logback]: https://github.com/qos-ch/logback
[https_github.com_apache_logging-log4j2]: https://github.com/apache/logging-log4j2
[300]: http://icdn.apigo.cn/blog/sb-logging-path.png?imageView2/0/w/500/h/300
[springboot-log2.png]: http://icdn.apigo.cn/blog/springboot-log2.png
[https_github.com_vipstone_springboot-example_tree_master_springboot-logging]: https://github.com/vipstone/springboot-example/tree/master/springboot-logging
[https_www.cnblogs.com_xiexj_p_9417128.html]: https://www.cnblogs.com/xiexj/p/9417128.html