Spring Boot 1.5.X版本引入的一个新的控制端点:
/loggers
,该端点将为我们提供动态修改Spring Boot应用日志级别的强大功能。该功能的使用非常简单,它依然延续了Spring Boot自动化配置的实现,所以只需要在引入了spring-boot-starter-actuator依赖的条件下就会自动开启该端点的功能。
- 构建一个基础的Spring Boot应用。
- 在
pom.xml
- 引入如下依赖(如果是STS,则选中file点击-------选中new ---------点击spring starter project)。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>spring-boot-sample-log-dyna</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>
<name>spring-boot-sample-log-dyna</name>
<description>Demo project for Spring Boot</description>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.12.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
在应用主类中添加一个接口用来测试日志级别的变化,比如下面的实现:
package com.example.demo;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
@RestController
@SpringBootApplication
public class DemoApplication {
private Logger logger = LoggerFactory.getLogger(getClass());
@RequestMapping(value = "/test", method = RequestMethod.GET)
public String testLogLevel() {
logger.debug("Logger Level :DEBUG");
logger.info("Logger Level :INFO");
logger.error("Logger Level :ERROR");
return "";
}
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
为了后续的试验顺利,在application.properties中增加一个配置,来关闭安全认证校验。
|
不然在访问
/loggers
端点的时候,会报如下错误:
|
测试验证
在完成了上面的构建之后,我们启动示例应用,并访问/test端点,我们可以在控制台中看到如下输出:
|
由于默认的日志级别为INFO,所以并没有输出DEBUG级别的内容。
下面我们可以尝试通过/logger端点来将日志级别调整为DEBUG,比如,发送POST请求到/loggers/com.example.demo端点,
以PostMan工具为例:
或者使用curl命令,如下所示:
curl -H "Content-Type: application/json" -X POST --data "{\"configuredLevel\": \"DEBUG\"}" http://localhost:8080/loggers/com.example.demo
注:要将contentType设置为application/json,数据必须是合法的json格式。否则会出现Http 415错误,Unsupported Media Type。
重新访问/test
端点,我们将在控制台中看到如下输出,在/test
端点中定义的DEBUG
日志内容被打印了出来:
|
可以看到,到这里为止,我们并没有重启过Spring Boot应用,而只是简单的通过调用/loggers
端点就能控制日志级别的更新。除了POST请求之外,我们也可以通过GET请求来查看当前的日志级别设置,比如:发送GET请求到/loggers/com.example.demo
端点,我们将获得对于com.example.demo包的日志级别设置:
|
我们也可以不限定条件,直接通过GET请求访问/loggers
来获取所有的日志级别设置,这里就不列举具体返回。
查看日志级别:
使用GET
请求:http://ip:port/loggers