Actuator 是四个可运行服务共同引入的观测基础。它提供运行端点,也为链路追踪相关自动装配提供入口。
一、统一依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
https://github.com/springvortex/spring-cloud-alibaba/blob/release/v1.0.0/service-consumer/pom.xml
Provider、Consumer、Gateway、Mail 都使用它。观测能力不是某个服务的专属功能,所有参与请求链路的服务都应该暴露一致的运行信息。
二、它关注应用,不关注业务
Actuator 更适合回答:
- 进程是否活着。
- 依赖是否异常。
- 请求链路是否开启导出。
- 运行时指标是否可采集。
业务层面的用户数、订单量,仍应由业务接口和数据库统计提供。
三、与链路追踪配合
项目中的 spring-boot-starter-zipkin 基于 Micrometer Tracing 和 Brave 导出链路。Actuator 管理模型让这类观测能力可以按
Starter 统一装配,不需要每个服务手写。
四、避坑点
- 生产环境要控制暴露端点和权限。
- 健康检查和业务可用性不是完全等价。
- 指标采集会增加少量开销,采样和暴露范围要规划。
- 内部管理端点不应随 Gateway 公开暴露。
五、经验总结
Actuator 是服务的体检入口。它让“服务注册上去了”和“服务真的能正常工作”之间有了更多判断依据。