SpringBoot日志配置

SpringBoot日志配置

规范：项目开发不应该编写System.out.println()的语句，而应该日志记录信息。

简介

1、Spring使用commons-logging作为内部日志，但底层日志实现是开放的。可对接其他日志框架。
spring5及以后commons-logging被spring自动导入
2、支持jul, log4j2, logback。SpringBoot提供了默认的控制台输出配置，也可以配置输出为文件。
3、logback是默认使用的
4、虽然日志框架很多，但我们可以使用SpringBoot的默认配置。

SpringBoot默认日志配置

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

日志格式

默认输出格式

时间和日期：毫秒级精度

日志级别：ERROR、WARN、INFO、DEBUG、TRACE

进程ID

—:消息分割符

线程名:使用[]包含

Logger名：通常是产生日志的类别

消息:日志记录的内容

默认值可参照spring-boot包additional-spring-configuration-metadata.json文件。

注意：logback没有FATAL级别，对应的是ERROR，在控制台使用jps能够查看所有进程。

日志使用

方式一

@RestController
public class HelloController {
    Logger logger = LoggerFactory.getLogger(HelloController.class);
    //Logger logger = LoggerFactory.getLogger(getClass())
    @GetMapping("/hello")
    public String hello(){
        logger.info("test log");
        return "hello";
    }
}
1
2
3
4
5
6
7
8
9
10

方式二

@Slf4j
@RestController
public class HelloController {
    @GetMapping("/hello")
    public String hello(){
        log.info("need lombok dependency");
        return "hello";
    }
}
1
2
3
4
5
6
7
8
9

日志级别

由低到高：ALL、TRACE、DEBUG、INFO、WARN、ERROR、FATAL、OFF
只会打印指定级别及以上级别的日志。

不指定级别的所有类，都使用root指定的级别作为默认级别，SpringBoot日志默认级别是INFO。

测试

@Slf4j
@RestController
public class HelloController {
    @GetMapping("/hello")
    public String hello(){
        log.trace("trace 日志.....");
        log.debug("debug 日志.....");
        log.info("info 日志.....");
        log.warn("warn 日志.....");
        log.error("error 日志.....");
        return "hello";
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13

由于SpringBoot默认的日志级别是INFO,所以只有INFO级别及更高级别的日志信息才会被输出到日志中，而TRACE、DEBUG级别的日志信息将被忽略。

日志配置

1、在application.properties/yml中配置logging.level.=指定日志级别，logger-name可以是某一个类
2、level可取值范围：TRACE、DEBUG、INFO、WARN、ERROR、FATAL、OFF,定义在LogLevel中
3、root的logger-name叫root,可以配置logging.level.root=warn,代表所有未指定日志级别都使用root的warn级别

日志输出参数

@Slf4j
@RestController
public class HelloController {
    @GetMapping("/hello")
    public String hello(String a, String b){
        log.info("info 日志.....参数a:{} b:{}",a, b);
        return "hello";
    }
}
1
2
3
4
5
6
7
8
9

日志分组

将相关的logger分组在一起，统一配置。如：Tomcat相关的日志统一设置。

SpringBoot预定义两个开箱即用的组

文件输出

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

#指定日志文件的路径，日志文件默认名叫spring.log
#logging.file.path=
#指定日志文件的名称
#1、只写名字、就生成当前项目相同位置的demo.log
#logging.file.name=demo.log
#2、写名字+路径:生成到指定位置的指定文件
logging.file.name=D://demo.log
1
2
3
4
5
6
7

当path配置项和name配置项同时存在的时候，以name为准。

文件归档与滚动切割

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

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

logging.logback.rollingpolicy.file-name-pattern=$(LOG_FILE).%d(yyyy-MM-dd).%i.gz)
1

自定义配置

通常我们配置application.properties就够平常使用，当然也可以自定义。如：

建议在日志配置文件中使用-spring变量，而不是xxx.xml,如果不加-springspring不能完全控制。

切换日志组合

使用maven的就近原则。

<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starterartifactId>
<exclusions>
    <exclusion>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-loggingartifactId>
    exclusion>
exclusions>
dependency>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-log4j2artifactId>
dependency>
1
2
3
4
5
6
7
8
9
10
11
12
13
14

最佳应用场景

1、导入热更新（Hot Reload）和第三方框架后，由于Spring Boot底层已经管理好了日志，因此需要排除这些框架的日志包。
2、修改application.properties配置文件，调整日志的所有行为。如果不够，可以编写日志框架，自己的配置文件放在类路径下就行，比如logback-spring.xml, log4j2-spring.xml
3、如果需要对接专业日志系统，只需要把logback记录的日志灌倒kafka中间件，这和SpringBoot没关系，都是日志框架自己的配置，修改配置文件即可
4、业务中使用slf4j-api记录日志。不再需要System.out.pritln()