loggers端點(diǎn)

本文我們就來看看Spring Boot 1.5.x中引入的一個新的控制端點(diǎn)：/loggers，該端點(diǎn)將為我們提供動態(tài)修改Spring Boot應(yīng)用日志級別的強(qiáng)大功能。該功能的使用非常簡單，它依然延續(xù)了Spring Boot自動化配置的實(shí)現(xiàn)，所以只需要在引入了spring-boot-starter-actuator依賴的條件下就會自動開啟該端點(diǎn)的功能（更多關(guān)于spring-boot-starter-actuator模塊的詳細(xì)介紹可見：《Spring Boot Actuator監(jiān)控端點(diǎn)小結(jié)》open in new window一文）。

下面，我們不妨通過一個實(shí)際示例來看看如何使用該功能：

• 構(gòu)建一個基礎(chǔ)的Spring Boot應(yīng)用
• 在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>

• 在應(yīng)用主類中添加一個接口用來測試日志級別的變化，比如下面的實(shí)現(xiàn)：

  @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);
  	}
    
  }

• 為了后續(xù)的試驗(yàn)順利，在application.properties中增加一個配置，來關(guān)閉安全認(rèn)證校驗(yàn)。

management.security.enabled=false

不然在訪問/loggers端點(diǎn)的時候，會報(bào)如下錯誤：

{
  "timestamp": 1485873161065,
  "status": 401,
  "error": "Unauthorized",
  "message": "Full authentication is required to access this resource.",
  "path": "/loggers/com.didispace"
}

測試驗(yàn)證

在完成了上面的構(gòu)建之后，我們啟動示例應(yīng)用，并訪問/test端點(diǎn)，我們可以在控制臺中看到如下輸出：

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

由于默認(rèn)的日志級別為INFO，所以并沒有輸出DEBUG級別的內(nèi)容。下面我們可以嘗試通過/logger端點(diǎn)來將日志級別調(diào)整為DEBUG，比如，發(fā)送POST請求到/loggers/com.didispace端點(diǎn)，其中請求體Body內(nèi)容為：

{
    "configuredLevel": "DEBUG"
}

重新訪問/test端點(diǎn)，我們將在控制臺中看到如下輸出，在/test端點(diǎn)中定義的DEBUG日志內(nèi)容被打印了出來：

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應(yīng)用，而只是簡單的通過調(diào)用/loggers端點(diǎn)就能控制日志級別的更新。除了POST請求之外，我們也可以通過GET請求來查看當(dāng)前的日志級別設(shè)置，比如：發(fā)送GET請求到/loggers/com.didispace端點(diǎn)，我們將獲得對于com.didispace包的日志級別設(shè)置：

{
  "configuredLevel": "DEBUG",
  "effectiveLevel": "DEBUG"
}

我們也可以不限定條件，直接通過GET請求訪問/loggers來獲取所有的日志級別設(shè)置，這里就不列舉具體返回，讀者可以自行嘗試。

#代碼示例

本文的相關(guān)例子可以查看下面?zhèn)}庫中的chapter4-2-6目錄：

• Github：https://github.com/dyc87112/SpringBoot-Learningopen in new window
• Gitee：https://gitee.com/didispace/SpringBoot-Learning