/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中增加一个配置,来关闭安全认证校验。
management.security.enabled=false
|
不然在访问 /loggers 端点的时候,会报如下错误:
-
{ "timestamp": 1485873161065, "status": 401, "error": "Unauthorized", "message": "Full authentication is required to access this resource.", "path": "/loggers/com.example.demo" }
测试验证
在完成了上面的构建之后,我们启动示例应用,并访问/test端点,我们可以在控制台中看到如下输出:
2018-06-05 16:34:57.123 INFO 16372 --- [nio-8000-exec-1] ication$$EnhancerBySpringCGLIB$$d2a0b1e2 : Logger Level :INFO 2018-06-05 16:34:57.124 ERROR 16372 --- [nio-8000-exec-1] ication$$EnhancerBySpringCGLIB$$d2a0b1e2 : Logger Level :ERROR |
由于默认的日志级别为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
日志内容被打印了出来:
2017-01-31 22:37:35.252 DEBUG 16372 --- [nio-8000-exec-5] ication$$EnhancerBySpringCGLIB$$d2a0b1e2 : Logger Level :DEBUG 2017-01-31 22:37:35.252 INFO 16372 --- [nio-8000-exec-5] ication$$EnhancerBySpringCGLIB$$d2a0b1e2 : Logger Level :INFO 2017-01-31 22:37:35.252 ERROR 16372 --- [nio-8000-exec-5] ication$$EnhancerBySpringCGLIB$$d2a0b1e2 : Logger Level :ERROR |
可以看到,到这里为止,我们并没有重启过Spring Boot应用,而只是简单的通过调用/loggers
端点就能控制日志级别的更新。除了POST请求之外,我们也可以通过GET请求来查看当前的日志级别设置,比如:发送GET请求到/loggers/com.example.demo
端点,我们将获得对于com.example.demo包的日志级别设置:
{ "configuredLevel": "DEBUG", "effectiveLevel": "DEBUG" } |
我们也可以不限定条件,直接通过GET请求访问/loggers
来获取所有的日志级别设置,这里就不列举具体返回。
查看日志级别:
使用GET
请求: