loggers端點
本文我們就來看看Spring Boot 1.5.x中引入的一個新的控制端點：/loggers，該端點將為我們提供動態修改Spring Boot應用日志級別的強大功能。該功能的使用非常簡單，它依然延續了Spring Boot自動化配置的實現，所以只需要在引入了spring-boot-starter-actuator依賴的條件下就會自動開啟該端點的功能（更多關于spring-boot-starter-actuator模塊的詳細介紹可見：《Spring Boot Actuator監控端點小結》open in new window一文）。
下面，我們不妨通過一個實際示例來看看如何使用該功能：
- 構建一個基礎的Spring Boot應用
- 在
pom.xml引入如下依賴（如果使用Intellij中的Spring Initializr的話直接在提示框中選下web和actuator模塊即可）。
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.1.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<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>
</dependencies>
- 在應用主類中添加一個接口用來測試日志級別的變化，比如下面的實現：
@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.didispace"
}
測試驗證
在完成了上面的構建之后，我們啟動示例應用，并訪問/test端點，我們可以在控制臺中看到如下輸出：
2017-01-31 22:34:57.123 INFO 16372 --- [nio-8000-exec-1] ication$$EnhancerBySpringCGLIB$$d2a0b1e2 : Logger Level ：INFO
2017-01-31 22:34:57.124 ERROR 16372 --- [nio-8000-exec-1] ication$$EnhancerBySpringCGLIB$$d2a0b1e2 : Logger Level ：ERROR
由于默認的日志級別為INFO，所以并沒有輸出DEBUG級別的內容。下面我們可以嘗試通過/logger端點來將日志級別調整為DEBUG，比如，發送POST請求到/loggers/com.didispace端點，其中請求體Body內容為：
{
"configuredLevel": "DEBUG"
}
重新訪問/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.didispace端點，我們將獲得對于com.didispace包的日志級別設置：
{
"configuredLevel": "DEBUG",
"effectiveLevel": "DEBUG"
}
我們也可以不限定條件，直接通過GET請求訪問/loggers來獲取所有的日志級別設置，這里就不列舉具體返回，讀者可以自行嘗試。
#代碼示例
本文的相關例子可以查看下面倉庫中的chapter4-2-6目錄：
- Github：https://github.com/dyc87112/SpringBoot-Learningopen in new window
- Gitee：https://gitee.com/didispace/SpringBoot-Learning
