Actuator是什么？

先从官网摘几句文绉绉的解释：

SpringBoot可以帮助你再将应用程序推向生产环境时对其进行监视和管理。

你可以选择使用http断点或JMX来管理和监视应用程序。

审计【auditing】、健康【health】和指标收集【metrics gathering】可以自动应用到你的应用程序中。

总结一下就是：Actuator就是用来监控你的应用程序的。

快速开始

引入依赖

<!--Actuator-->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<!--Spring MVC 自动化配置-->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

一般来说这两个依赖都是相互配合的。

yml与自动配置

下面是一段yml的配置：

server:
  port: 8081
management:
  endpoints:
    web:
      base-path: /actuator # Actuator 提供的 API 接口的根目录
      exposure:
        include: '*'  # 需要开放的端点
        exclude: # 需要排除的端点

management.endpoints.web对应的配置类是：org.springframework.boot.actuate.autoconfigure.endpoint.web.WebEndpointProperties。

相关的自动配置在org.springframework.boot.actuate.autoconfigure.endpoint.web.WebEndpointAutoConfiguration中完成，感兴趣的同学可以查看一下源码。

basePath是Actuator提供的API接口的根目录，默认配置就是/actuator。

Exposure.include表示需要开放的端点，默认只打开health和info两个断点，设置*可以开放所有端点。

Exposure.include表示排除的端点，设置*为排除所有的端点。【关注尚硅谷，轻松学IT】

主程序类

@SpringBootApplication
public class SpringBootActuatorApplication {
    public static void main(String[] args) {
        SpringApplication.run(SpringBootActuatorApplication.class, args);
    }
}

测试

访问http://localhost:8081/actuator/health，得到应用的健康信息如下：

{
  status: "UP"  // 开启
}

Endpoints

由于我们设置开放了所有的Endpoints，启动程序时，我们能够看到控制台输出：

[  restartedMain] o.s.b.a.e.web.EndpointLinksResolver      : Exposing 13 endpoint(s) beneath base path '/actuator'

说的很清楚，总共暴露了内置的13个端点， java培训这些端点，SpringBoot文档已经交代地非常详细啦。

其实内置的端点不止13个，官方文档说：每个端点可以被enabled or disabled和exposed over HTTP or JMX。只有当端点同时enabled和exposed的时候才可用，内置的端点也只有在自动配置生效的时候才可用。

大多数的应用程序会选择HTTP暴露端点，我们可以通过/actuator/health访问ID为health的端点。

官方列举的所有端点列表

JMX和web共有的

如果你的是web应用 (Spring MVC, Spring WebFlux, or Jersey)，你可以使用下面这些额外的端点:

启动端点

如果你希望启动某个端点，你可以按照management.endpoint.<id>.enabled的配置启动，以shutdown端点为例：

management:
  endpoint:
    shutdown:
      enabled: true

如果你只希望启动某个端点，你可以向下面这样：

management:
  endpoints:
    enabled-by-default: false # 不启用默认配置
  endpoint:
    info:
      enabled: true

这个示例，只会启用info端点。

暴露端点

端点可能会包含铭感信息，考虑暴露的时候应当慎重考虑。

web程序默认暴露的端点有且仅有两个：health和info。

JMX程序默认暴露所有的端点。

我们可以使用include和exclude属性来控制端点是否需要暴露。下面是两个例子

一、不让JMX暴露所有端点，只让它暴露health和info两个端点。

management:
  endpoints:
    jmx:
      exposure:
        include: "health,info"

二、暴露web除env和beans之外的所有端点。

management:
  endpoints:
    web:
      exposure:
        include: "*"
        exclude: "env,beans"
management.endpoints.web.exposure.include=*  
management.endpoints.web.exposure.exclude=env,beans

配置端点

端点将会自动缓存对不带任何参数的读取操作的响应。你可以使用cache.time-to-live属性配置。

以下示例将Bean端点的缓存的生存时间设置为10秒。

management:
  endpoint:
    beans:
      cache:
        time-to-live: "10s"

发现页面

默认你可以访问/actuator页面获得所有的端点信息：

{
  _links: {
    self: {
      href: "http://localhost:8081/actuator",
      templated: false
    },
    health: {
      href: "http://localhost:8081/actuator/health",
      templated: false
    },
    health-path: {
      href: "http://localhost:8081/actuator/health/{*path}",
      templated: true
    },
    info: {
      href: "http://localhost:8081/actuator/info",
      templated: false
    }
  }
}

跨域支持

默认情况下，CORS支持是禁用的，并且仅在设置了management.endpoints.web.cors.allowed-origins属性后才启用。以下配置允许来自example.com域的GET和POST调用：

management:
  endpoints:
    web:
      cors:
        allowed-origins: "https://example.com"
        allowed-methods: "GET,POST"

完整的选项可以查看：CorsEndpointProperties

实现一个定义的端点

我们直接来看一个例子吧：

@Component  // 让Spring容器管理
@Endpoint(id = "myEndPoint") //web和jmx公用， @WebEndpoint表示指定web
public class MyEndpoint {
    Runtime runtime = Runtime.getRuntime();
    @ReadOperation // 读操作
    public Map<String, Object> getData() {
        Map<String, Object> map = new HashMap<>();
        map.put("available-processors", runtime.availableProcessors());
        map.put("free-memory", runtime.freeMemory());
        map.put("max-memory", runtime.maxMemory());
        map.put("total-memory", runtime.totalMemory());
        return map;
    }
}

@Component表明让这个bean给Spring容器管理。

@Endpoint标注这是个端点，类似的还有@WebEndpoint标注的是特指web程序。

id = "myEndPoint"限制访问端点的路径：/actuator/myEndPoint。

@ReadOperation规定HTTP请求的方法为GET，@ReadOperation为POST，@DeleteOperation为DELETE。

接下来我们测试一下，再测试之前，不要忘了yml中启动设置：

server:
  port: 8081
management:
  endpoints:
    web:
      exposure:
        include: '*' # 需要开放的端点。默认值只打开 health 和 info 两个端点。通过设置 * 
    enabled-by-default: false
  endpoint:
    myEndPoint:
      enabled: true

我们暂时关闭其他所有的端点，只关注myEndPoint端点，【关注尚硅谷，轻松学IT】接着启动程序，访问：http://localhost:8081/actuator/myEndPoint，获得json信息。

{
    max-memory: 3787980800,
    free-memory: 235775968,
    available-processors: 4,
    total-memory: 298844160
}

实际上如果是用于SpringMVC或Spring WebFlux，我们可以使用@RestControllerEndpoint或@ControllerEndpoint注解，定义一个更符合我们平时web开发模式的端点，你可以看一下 java培训下面这个例子。

@Component
@RestControllerEndpoint(id = "web")
public class MyWebEndPoint {
    @GetMapping("/")
    public Map<String, Object> getData() {
  // ...
        return map;
    }
}

Health端点

端点这么多，我们挑几个学习一下，health作为默认开放的端点之一，还是需要好好了解一下的。

设置何时显示信息

你可以使用得到的健康信息去检查你的应用程序，暴露的health信息依赖于下面两个属性配置：

management.endpoint.health.show-details
management.endpoint.health.show-components

这两个属性可以设置的值如下：

health端点通过健康指示器HealthIndicator获取不同的资源的健康信息，且Autuator内置了多个HealthIndicator的实现，太多啦太多啦，如果需要可以看看官网 Auto-configured HealthIndicators。

另外，如果你想启用或者禁用指定的指示器，你可以配置management.health.key.enabled，key需要被替换，官网表格上有。

如果你想设置全部的，你可以配置management.health.defaults.enabled

设置顺序

你可以通过以下设置显示顺序：

management:
  endpoint:
    health:
      status:
        order: "fatal,down,out-of-service,unknown,up"

设置响应码

响应码反应了总体健康状态。默认情况下，OUT_OF_SERVICE和DOWN的映射为503，其他状态为200。你可以按照下面的方式设置映射：

management:
  endpoint:
    health:
      status:
        http-mapping:
          down: 503
          fatal: 503
          out-of-service: 503

自定义健康信息

纵使，Actuator已经提供了许多内置实现，总会满足不了我们的需求，那如何去自定义呢？

注册实现HealthIndicator接口的Spring Bean。

提供health()方法的实现并返回健康响应，包括状态和其他需要显示的详细信息。

以下代码展示了一个案例：

import org.springframework.boot.actuate.health.Health;
import org.springframework.boot.actuate.health.HealthIndicator;
import org.springframework.stereotype.Component;
import java.util.Random;
@Component
public class MyHealthIndicator implements HealthIndicator {
    @Override
    public Health health() {
        // perform some specific health check
        boolean check = check();
        if (!check) {
            return Health.down().withDetail("Error Code", 0).build();
        }
        return Health.up().build();
    }
    private boolean check() {
        return new Random().nextBoolean();
    }
}

id就是bena的名称去掉HealthIndicator后缀，这里id就是my。

看看相关的yml怎么配置？

management:
  endpoints:
    web:
      exposure:
        include: '*' # 需要开放的端点。默认值只打开 health 和 info 两个端点。通过设置 * ，可以开放所有端点。
    enabled-by-default: false
  endpoint:
    health:
      enabled: true
      show-details: always # 何时显示完整的健康信息
      show-components: always
      status:
        http-mapping: # 设置不同健康状态对应的响应状态码
          DOWN: 503
        order: FATAL, DOWN, OUT_OF_SERVICE, UP, UNKNOWN # 状态排序

测试一下，访问：/actuator/health，可以尝试多点几次，会出现UP和DOWN的情况，得到以下信息：

{
  status: "DOWN",
  components: {
    diskSpace: {
      status: "UP",
      details: {
        total: 267117391872,
        free: 130840469504,
        threshold: 10485760,
        exists: true
      }
    },
    my: {
      status: "DOWN",
      details: {
        Error Code: 0
      }
    },
    ping: {
      status: "UP"
    }
  }
}

my对应的就是我们自定义的MyHealthIndicator，里面详细的信息有：状态status，信息details。

diskSpace对应DiskSpaceHealthIndicator，ping对应的是PingHealthIndicator。

其他的端点，感兴趣的小伙伴可以去到官网一一测试，总之，通过这些Actuator提供的端点，我们很容易就能够监控管理我们的应用程序。

来源互联网后端架构

ITPub博客

SpringBoot利用Actuator来监控应用的方法