如何为SpringBoot应用设置健康检查_Serverless 应用引擎(SAE)-阿里云帮助中心

对于Spring Boot的应用，除了使用HTTP或TCP端口检测来进行应用健康检查之外，您也可以使用Actuator组件实现定制化健康检查。本文介绍如何通过Actuator组件为Spring Boot应用设置健康检查。

背景信息

Actuator组件是Spring Boot提供的用来对应用系统进行自省和监控的功能模块，借助于Actuator，您可以很方便地查看并统计应用系统的某些监控指标。您也可以通过Actuator组件自定义您的健康检查程序。更多信息，请参见 Spring Boot Actuator官方文档。

操作步骤

在Maven中添加所需依赖。

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

设置 application.properties 配置文件，显示健康检查详细信息。

management.endpoints.web.base-path= /           # Actuator 2.0之前默认基础访问路径是"/"（则健康检查为“/health”）,2.0及之后默认访问路径是"/actuator" （则健康检查为“/actuator/health”）。
management.endpoint.health.show-details=always  # 显示健康检查详细信息，默认为never，即不显示。

您可以通过Actuator组件提供的自动配置的健康指示器或者自定义检查程序对应用进行检查。
- 通过自动配置的健康检查器。
  
  Actuator有些自动配置加载的健康检查指示器（HealthIndicator），例如若应用中使用了Redis、MongoDB，那么RedisHealthIndicator以及MongoHealthIndicator就会被作为健康检查的一部分。更多关于自动加载的配置信息，请参见自动配置加载。
  
  您也可以禁用所有自动配置的健康指示器，或者禁用某个指示器的健康检查。
```
management.health.defaults.enable=false   # 禁用所有默认健康检查指示器。  
management.health.mongo.enable=false      # 禁用MongoDB健康检查指示器。
```
- ```
@Component
public class CustomHealthIndicator extends AbstractHealthIndicator {
    @Override
    protected void doHealthCheck(Health.Builder builder) throws Exception {
       # 实现您业务中特定的检查内容。
       if (checkSomething()) {  
           builder.up().withDetail("Item", "xxx").withDetail("error", "null");
       } else {
           builder.down().withDetail("Item", "xxx").withDetail("error", "xxxErrorCode");
}
```
- ```
curl 127.0.0.21:8080/health/custom  # custom为健康检查指示器类名前缀，请以您定义的类名为准。
```
```
{"status":"UP","details":{"custom":{"status":"UP","details":{"Item","xxx","error","null"}}}}
```