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

Bulut0907

已于 2023-10-23 09:24:23 修改

阅读量591

点赞数

分类专栏： # SpringBoot 文章标签： spring boot 日志配置流程日志分组文件归档与滚动切割切换使用log4j2

于 2023-10-23 09:23:04 首次发布

本文链接：https://blog.csdn.net/yy8623977/article/details/133982095

版权

SpringBoot 专栏收录该内容

34 篇文章 2 订阅

订阅专栏

#1024程序员节｜参与投稿，赢限定勋章和专属大奖#

1. 简介

Spring5及以后Spring自己实现了commons-logging，来作为内部的日志。日志的jar包是org.springframework:spring-jcl:6.0.10。查看org.apache.commons.logging.LogAdapter

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;
......省略部分......

只要导入了哪些日志包，就会使用哪些日志实现框架。所以底层的日志是开放的，可对接其他日志框架

支持 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. 在类中记录日志

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，超过大小切割成另外一个文件

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

配置项	描述
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 实践

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