Question

Spring Boot Actuator 的关键特性是在应用程序里提供众多 Web 端点，通过它们了解应用程序运行时的内部状况。有了 Actuator，你可以知道 Bean 在 Spring 应用程序上下文里是如何组装在一起的，掌握应用程序可以获取的环境属性信息，获取运行时度量信息的快照……

Actuator 提供了 13 个端点，具体如表 7-1 所示。

表 7-1 Actuator 的端点

HTTP 方法	路径	描述
GET	/autoconfig	提供了一份自动配置报告，记录哪些自动配置条件通过了，哪些没通过
GET	/configprops	描述配置属性（包含默认值）如何注入 Bean
GET	/beans	描述应用程序上下文里全部的 Bean，以及它们的关系
GET	/dump	获取线程活动的快照
GET	/env	获取全部环境属性
GET	/env/{name}	根据名称获取特定的环境属性值
GET	/health	报告应用程序的健康指标，这些值由 HealthIndicator 的实现类提供
GET	/info	获取应用程序的定制信息，这些信息由 info 打头的属性提供
GET	/mappings	描述全部的 URI 路径，以及它们和控制器（包含 Actuator 端点）的映射关系
GET	/metrics	报告各种应用程序度量信息，比如内存用量和 HTTP 请求计数
GET	/metrics/{name}	报告指定名称的应用程序度量值
POST	/shutdown	关闭应用程序，要求 endpoints.shutdown.enabled 设置为 true
GET	/trace	提供基本的 HTTP 请求跟踪信息（时间戳、HTTP 头等）

要启用 Actuator 的端点，只需在项目中引入 Actuator 的起步依赖即可。在 Gradle 构建说明文件里，这个依赖是这样的：

compile 'org.springframework.boot:spring-boot-starter-actuator'

对于 Maven 项目，引入的依赖是这样的：

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

亦或你使用 Spring Boot CLI，可以使用如下 @Grab 注解：

@Grab('spring-boot-starter-actuator')

无论 Actuator 是如何添加的，在应用程序运行时自动配置都会生效。Actuator 会开启。

表 7-1 中的端点可以分为三大类：配置端点、度量端点和其他端点。让我们分别了解一下这些端点，从提供应用程序配置信息的端点看起。