如何动态配置Spring Boot 日志级别

项目使用了SpringBoot构建项目。下面对动态调整日志的级别进行记录。
从版本 1.5.1 之后就提供了基于 spring-boot-starter-actuator 的端点 /loggers。通过该端点可以实现查看系统的 package-path 的日志级别，以及针对特定的 package-path 配置运行中的应用的日志级别的功能。 

Actuator 依赖

pom 依赖

因为是基于 Web 的项目和利用 Actuator 提供的端点来进行配置，因此需要依赖：

    org.springframework.boot
    spring-boot-starter-web



    org.springframework.boot
    spring-boot-starter-actuator

安全配置

Actuator 提供的端点(Endpoints)，默认是需要安全认证才能够被访问的。因为里面涉及到一些敏感的信息。需要安全认证就需要配置 Spring-Security。为了方便首先配置不需要安全权限的。

management.security.enabled=false

•  

GET 请求访问

我们可以发送GET 请求到 http://localhost:8091/loggers 来获取支持的日志等级，以及系统（ROOT）默认的日志等和各个包路径（com.mall.goods.zhongkui等）对应的日志级别。

{
	levels: [
		"OFF",
		"FATAL",
		"ERROR",
		"WARN",
		"INFO",
		"DEBUG",
		"TRACE"
	],
	loggers: {
		ROOT: {
			configuredLevel: "INFO",
			effectiveLevel: "INFO"
		},
		com.mall.goods.zhongkui: {
			configuredLevel: "DEBUG",
			effectiveLevel: "DEBUG"
		},
		com.mall.goods.zhongkui.mallcpswomai.mapper: {
			configuredLevel: "DEBUG",
			effectiveLevel: "DEBUG"
		}
	}
}

配置日志级别

编写日志输出类

编写一个controller 输出各个级别的日志：

@Slf4j
@Controller
public class TestController {
     
    @GetMapping(value = "/testLog")
    public String testLog() {
        log.info("---------------------------");
        log.debug("debug debug");
        log.info("info info info");
        log.warn("warn warn warn");
        log.error("error error error ");
        log.info("---------------------------");
        return "ok";
    }
}

查看日志级别

启动应用访问 http://localhost:8091/ 得到：

[2018-07-30 18:05:42.868] [http-nio-8091-exec-2] INFO  com.mall.goods.zhongkui.mallcpswomai.web.OrderRelationController----------------------------
[2018-07-30 18:05:42.869] [http-nio-8091-exec-2] DEBUG com.mall.goods.zhongkui.mallcpswomai.web.OrderRelationController-debug debug
[2018-07-30 18:05:42.869] [http-nio-8091-exec-2] INFO  com.mall.goods.zhongkui.mallcpswomai.web.OrderRelationController-info info info
[2018-07-30 18:05:42.869] [http-nio-8091-exec-2] WARN  com.mall.goods.zhongkui.mallcpswomai.web.OrderRelationController-warn warn warn
[2018-07-30 18:05:42.869] [http-nio-8091-exec-2] ERROR com.mall.goods.zhongkui.mallcpswomai.web.OrderRelationController-error error error 
[2018-07-30 18:05:42.869] [http-nio-8091-exec-2] INFO  com.mall.goods.zhongkui.mallcpswomai.web.OrderRelationController----------------------------

Spring Boot 默认的 ROOT 日志级别是INFO。

配置特定包的日志级别

通过 /loggers 端点提供的 POST 请求，修改包路径com.mall.goods.zhongkui 的日志级别为INFO。 
* 发送POST 请求到  http://localhost:8091/com.mall.goods.zhongkui，其中请求 Body 的内容如下：

{
  "configuredLevel": "INFO"
}

• GET 访问 /loggers/com.mall.goods.zhongkui 查看当前的日志级别：

{
    configuredLevel: "INFO",
    effectiveLevel: "INFO"
}

• 再次访问 http://localhost:8091/ 得到：需要注意的是，通过 /loggers 配置的日志级别在应用重启时会恢复到系统的配置。如果想永久的配置日志的级别还是需要通过logging.level.package-path 来进行配置。

总结

Spring Boot 提供的日志级别动态配置功能，为我们的线上应用调试提供了很好的机制。在实际使用中需要结合 Spring-Security 提供的安全机制来保护Actuator 提供的各种系统级端点。

参考

1. Configure a Logger