SpringBoot的日志系统(日志分组、文件输出、滚动归档)

@[toc](目录)

> SpringBoot3需要jdk17

# 1. 简介

1. Spring5及以后Spring自己实现了commons-logging，来作为内部的日志。日志的jar包是org.springframework:spring-jcl:6.0.10。查看org.apache.commons.logging.LogAdapter
```Java
package org.apache.commons.logging;
......省略部分......
final class LogAdapter {
    private static final boolean log4jSpiPresent = isPresent("org.apache.logging.log4j.spi.ExtendedLogger");
    private static final boolean log4jSlf4jProviderPresent = isPresent("org.apache.logging.slf4j.SLF4JProvider");
    private static final boolean slf4jSpiPresent = isPresent("org.slf4j.spi.LocationAwareLogger");
    private static final boolean slf4jApiPresent = isPresent("org.slf4j.Logger");
    private static final Function<String, Log> createLog;
......省略部分......
```
只要导入了哪些日志包，就会使用哪些日志实现框架。所以底层的日志是开放的，可对接其他日志框架

2. 支持 jul、log4j2、logback(默认)日志实现。SpringBoot 提供了默认的控制台输出配置，也可以配置输出为文件

# 2. SpringBoot日志默认配置流程
1、每个starter场景，都会导入一个核心场景spring-boot-starter
2、核心场景引入了日志的所用功能spring-boot-starter-logging
3、spring-boot-starter-logging默认使用了logback + slf4j 组合作为默认底层日志
4、日志是系统一启动就要用，xxxAutoConfiguration是系统启动好了以后放好的组件，后来用的
5、查看autoconfiguration的logging目录，可以看到日志是利用监听器机制配置好的
6、日志所有的配置都可以通过修改配置文件实现。是以logging开始的所有配置

# 3. 默认日志格式
```
......省略部分......
2023-07-13T05:06:01.866+08:00 INFO 3096 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path ''
2023-07-13T05:06:01.881+08:00 INFO 3096 --- [ main] c.h.s.SpringBoot3TestApplication : Started SpringBoot3TestApplication in 3.383 seconds (process running for 4.406)
```
默认输出格式：
- 时间和日期：毫秒级精度
- 日志级别：ERROR、WARN、INFO、DEBUG
- 进程ID
- ---：消息分割符
- 线程名：使用[]包含
- Logger名：通常是产生日志的类名
- 消息：日志记录的内容

默认值：参照：org.springframework.boot:spring-boot:3.1.1的META-INF的additional-spring-configuration-metadata.json文件
```
    {
      "name": "logging.pattern.console",
      "type": "java.lang.String",
      "description": "Appender pattern for output to the console. Supported only with the default Logback setup.",
      "sourceType": "org.springframework.boot.context.logging.LoggingApplicationListener",
      "defaultValue": "%clr(%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd'T'HH:mm:ss.SSSXXX}}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}"
    }
```

修改默认值如下：
```
# 显示示例: 2023-07-13 05:16:09.952 INFO [main] c.h.s.SpringBoot3TestApplication ===> Started SpringBoot3TestApplication in 2.305 seconds (process running for 3.107)
# logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level [%thread] %logger{15} ===> %msg%n

# 只修改控制台输出的日期格式
logging.pattern.dateformat=yyyy-MM-dd HH:mm:ss.SSS
```

# 4. 在类中记录日志
```Java
package com.hh.springboot3test.controller;

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@Slf4j
@RestController
public class ControllerTest {
// Logger log = LoggerFactory.getLogger(getClass());

@GetMapping("/hello")
public String hello() {

        // 2023-07-13 05:24:15.659 INFO 10212 --- [nio-8080-exec-2] c.h.s.controller.ControllerTest          : 进入hello方法了
        log.info("进入hello方法了");
        return "hello";
    }
}

```

# 5. 日志级别

由低到高：ALL、TRACE、DEBUG、INFO、WARN、ERROR、FATAL、OFF
- ALL：打印所有日志
- TRACE：追踪框架详细流程日志，一般不使用
- DEBUG：开发调试细节日志
- INFO：关键、感兴趣信息日志
- WARN：警告但不是错误的信息日志，比如：版本过时
- ERROR：业务错误日志，比如出现各种异常
- FATAL：致命错误日志，比如jvm系统崩溃
- OFF：关闭所有日志记录

定义在org.springframework.boot:spring-boot:3.1.1的org.springframework.boot.logging.LogLevel枚举类

application.properties文件配置日志级别
```
# 默认日志级别设置
# logging.level.root=info
# 设置一个包或类的日志级别
logging.level.com.hh.springboot3test.controller.ControllerTest=debug
```

# 6. 日志分组
将相关的logger分组在一起，统一配置。application.properties配置如下：

```
# 多个值用逗号分隔
logging.group.my-logging-group=com.hh.springboot3test.controller.ControllerTest
logging.level.my-logging-group=warn
```

SpringBoot预定义两个组
- web: 包含org.springframework.core.codec、org.springframework.http、org.springframework.web、org.springframework.boot.actuate.endpoint.web、org.springframework.boot.web.servlet.ServletContextInitializerBeans
- sql: 包含org.springframework.jdbc.core、org.hibernate.SQL、org.jooq.tools.LoggerListener

# 7. 文件输出
SpringBoot默认只把日志写在控制台，如果想额外记录到文件，可以在application.properties中添加logging.file.name或logging.file.path配置项

logging.file.name | logging.file.path | 示例 | 效果
------ | ------ | ------ | ------
未指定 | 未指定 | | 仅控制台输出
指定 | 未指定 | D:\\my.log | 写入指定文件。可以加路径，默认路径是项目根路径
未指定 | 指定 | D:\\ | 写入指定目录，文件名为spring.log
指定 | 指定 | | logging.file.path无效，以logging.file.name为准

# 8. 文件归档与滚动切割

> 生产环境可以配置按日志级别分类，进行文件归档和滚动切割

归档：每天的日志单独存到一个文档中
切割：每个文件10MB，超过大小切割成另外一个文件

1. 每天的日志应该独立分割出来存档。如果使用logback（SpringBoot默认整合），可以通过application.properties/yaml文件指定日志滚动规则
2. 如果是其他日志系统，需要自己在日志配置文件中进行配置（添加log4j2.xml或log4j2-spring.xml）
3. 默认支持的滚动规则设置如下：

配置项 | 描述
------ | ------
logging.logback.rollingpolicy.file-name-pattern | 日志存档的文件名格式（默认值：${LOG_FILE}.%d{yyyy-MM-dd}.%i.gz）。需要开启日志文件输出。`LOG_FILE`就是日志输出的路径和名称
logging.logback.rollingpolicy.clean-history-on-start | 应用启动时是否清除以前存档（默认值：false）
logging.logback.rollingpolicy.max-file-size | 存档前，每个日志文件的最大大小（默认值：10MB）
logging.logback.rollingpolicy.total-size-cap | 日志文件被删除之前，可以容纳的最大大小（默认值：0B，即容纳无限大小）。设置1GB则磁盘存储超过 1GB 日志后就会删除旧日志文件
logging.logback.rollingpolicy.max-history | 日志文件保存的最大天数(默认值：7)

# 9. 自定义配置

日志系统 | 自定义
------ | ------
Logback| logback-spring.xml、logback-spring.groovy、logback.xml、logback.groovy
Log4j2 | log4j2-spring.xml、log4j2.xml
JDK (Java Util Logging) | logging.properties

建议在日志配置文件中使用-spring变量（例如使用logback-spring.xml而不是logback.xml）。如果您使用标准配置文件，日志初始化时的日志spring不能获取

比如可以使用logback-spring.xml文件进行配置。会和SpringBoot的logback配置混合起作用

# 10. 切换使用log4j2

直接在pom.xml添加依赖就可以了。但是不能使用文件归档与滚动切割，需要在log4j2.xml中自己配置
```
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</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>
```

也可以使用log4j2-spring.xml文件进行配置。会和SpringBoot的log4j2配置混合起作用

# 11 实践

1. 导入任何第三方框架，先排除它的日志包，因为SpringBoot底层控制好了日志
2. 修改application.properties配置文件，就可以调整日志的所有行为。如果不够，可以编写日志框架自己的配置文件放在资源路径下就行，比如logback-spring.xml，log4j2-spring.xml
3. 如需对接专业日志系统，如把logback记录的日志灌倒kafka之类的中间件，这和SpringBoot没关系，都是日志框架自己的配置，修改配置文件即可