SpringBoot Actuator 可以用于监控 SpringBoot 应用，并查看应用内部的状态，可以通过 HTTP 或 JMX 方式。
默认的 Endpoint Link to heading
默认的 path 前缀为actuator，可以通过属性配置：
management.endpoints.web.base-path: /admin
通过/actuator可以查看所有的 endpoints:
$ http :8080/actuator
主要的endpoint有：
- /beans : Spring Context中的所有bean
- /env ： 所有属性信息
- /health ：系统的健康信息
- /httptrace ：http请求的trace信息
- /info ：系统info
- /loggers ：日志信息
- /metrics ：系统的度量，包括内存、cpu、http请求等
- /mappings ：所有@RequestMapping映射信息
- /threaddump ：线程dump信息
- /heapdump ：生成一个hprof文件
大部分的 endpoint的http访问是禁用的，可以通过属性management.endpoints.web.exposure.include和management.endpoints.web.exposure.exclude进行配置，支持通配符‘*’表示所有：
management:
endpoints:
web:
base-path: /actuator
exposure:
include: '*'
exclude: heapdump,threaddump
/info Link to heading
为/info提供数据有多种方式，第一种是静态的，在配置文件中定义以info为前缀的属性，如：
info:
contact:
email: myeamil@example.com
phone: +86-17100000000
另一种是动态的，即实现InfoContributor接口，实现contribute()方法即可，代码参考MyInfoContributor.java。
另外，Actuator 提供了一些预先定义的InfoContributor实现，比如BuildInfoContributor可以返回项目的 build 信息，如果要启用，需要在gradle 中添加配置：
springBoot {
buildInfo()
}
gradle 会在最后生成的 jar 包中生成build-info.properties文件，/info会读取该文件中的内容。
如果希望在/info中看到最新的 Git commit 信息，在 gradle 中添加 plugin：
plugins {
id "com.gorylenko.gradle-git-properties" version "2.0.0"
}
默认输出的是简要信息，可以通过配置management.info.git.mode=full输出更详细的 commit 信息。
/health Link to heading
/health主要显示当前系统以及外部依赖组件（如 database, MQ）的健康状态，包括：UP, DOWN, UNKNOWN, OUT-OF-SERVICE等，这是聚合状态，即所有组件是UP，最后的状态才是UP，只要有一个组件的状态是DOWN，最后的状态是DOWN。
management.endpoint.health.show-details：显示更详细的信息。
也可以实现HealthIndicator接口，扩展/health，代码示例见MyHealthIndicator.java。
/loggers Link to heading
/loggers用于查看基于 package 的日志配置信息。
/loggers/{package-name}：查看某个 package 的日志配置。
POST /loggers/{package-name}：用于修改 package 的日志配置，如：
$ http post :8080/actuator/loggers/org.nkcoder.admin configuredLevel=DEBUG
/env Link to heading
/env查看所有属性信息，包括环境变量、JVM 系统属性、Spring Cloud Config 属性，以及application.yml和application.properties中的属性。
/env/{property-name}：可以根据属性名查询属性值。
POST /env：可以用于设置属性。
DELETE /env：可以用于删除属性。
不过这些修改操作都是临时的，系统重启后会恢复原值。
/metrics Link to heading
返回包括内存、GC、请求等指标的值或统计信息。
/metrics：返回可以度量的指标的列表。
/metrics/{metric-name}：返回具体指标的详细信息。
其它 endpoint Link to heading
/conditions：查看AutoConfiguration下 bean 的加载信息，比如@ConditionOnMissingBean， @ConditionOnClass等。
/mappings：所有@RequestMapping的URL映射。
/httptrace: 可以查看系统的请求信息，需要HttpTraceRepository的实现bean，默认禁用，因为默认的实现是InMemoryHttpTraceRepository，会比较占用内存，如果要启用，可以定义一个InMemoryHttpTraceRepository的bean，或者自定义HttpTraceRepository的实现。
/threaddump：返回当前所有线程活动的快照信息。
/heapdump：会下载一个HPROF的 heap dump 文件。
自定义 Endpoint Link to heading
因为需要同时支持 HTTP 和 JMX MBeans，Actuator 使用的并不是@Controller或@RestController，而是@Endpoint，对应的操作注解为：
@ReadOperation, @WriteOperation, @DeleteOperation。
所以，定义一个 Endpoint，与定义一个 Controller 类似，只是替换成对应的注解即可，示例代码参考MyEndPoint.java。
@JmxEndpoint只是用于 JMX MBean，而@WebEndpoint只是用于 HTTP 请求。
安全控制 Link to heading
Actuator 并不关心安全问题，所以安全问题可以交给 Spring Security 来控制。
Actuator 的请求路径为/actuator（可配置），所以完全可以当作一般的 REST 节点来配置安全。
为了可以不用依赖于可配置的/actuator字符串，Actuator 还提供了EndpointRequest配置，如：
http.requestMatcher(EndpointRequest.toAnyEndpoint().excluding("health", "info"))
.authorizeRequests().anyRequest().hasRole("ADMIN")
.and().httpBasic();
http.requestMatcher(EndpointRequest.to("beans", "threaddump", "heapdump"))
.authorizeRequests().anyRequest().hasRole("ADMIN")
.and()
.httpBasic();
JMX Link to heading
默认情况下，除了/heapdump外，所有的 endpoint 都被暴露为 MBeans，可以通过 JMX 查看。
与 HTTP 类似，endpoint 的暴露可以通过属性配置：
management:
endpoints:
jmx:
exposure:
include: '*'
exclude: threaddump,heapdump
可以通过任意JMX客户端，如JConsole查看。
也可以自定义 MBean，只需要将对应的 bean 使用@ManagedResource，并将需要暴露的属性用@ManagedAttribute，需要暴露的方法使用@ManagedOperation注解即可。
MBean 状态的变化，需要 JMX 客户端通过 PULL 的方式主动拉取，Spring 也支持通过NotificationPublisher主动将变化 PUSH 给 JMX 客户端，只需要MBean实现NotificationPublisherAware接口，并发送 Notification。JMX 客户端需要 Subscribe。
@Component
@ManagedResource
public class MyCounterMbean implements NotificationPublisherAware {
private AtomicInteger counter;
private NotificationPublisher notificationPublisher;
public MyCounterMbean() {
this.counter = new AtomicInteger(0);
}
@ManagedAttribute
public int getCount() {
return counter.get();
}
@ManagedOperation
public int increment(int delta) {
int value = counter.addAndGet(delta);
if (value % 5 == 0) {
notificationPublisher.sendNotification(new Notification(
"my.counter",
this,
value,
"current value: " + value
));
}
return value;
}
@Override
public void setNotificationPublisher(NotificationPublisher notificationPublisher) {
this.notificationPublisher = notificationPublisher;
}
}
完整的示例代码见项目：github-springboot-actuator