Spring Boot Admin 监控需搭建独立的 Admin Server(服务端)和 Admin Client(客户端),基于 Actuator 构建 C/S 架构;Server 端引入 starter-server 依赖并加 @EnableAdminServer 注解,Client 端引入 starter-client 和 actuator 并配置 server 地址与端点暴露,启动后 Server 可可视化展示健康、JVM、线程等信息。

Spring Boot 集成 Spring Boot Admin 监控面板,核心是搭建两个角色:独立的 Admin Server(服务端) 和被监控的 Admin Client(客户端)。它不是开箱即用的单模块功能,而是基于 Actuator 端点构建的 C/S 架构监控体系。只要客户端暴露了 Actuator 接口、服务端能连上并拉取数据,就能看到健康状态、JVM、线程、日志级别等可视化信息。
一、搭建 Admin Server 服务端
这是监控面板本身,需单独启动一个 Spring Boot 应用:
- 在
pom.xml中引入服务端依赖(注意版本与 Spring Boot 兼容,推荐 2.6.x+ 对应 Spring Boot 2.6/2.7,或 3.x 版本适配 Spring Boot 3.x):<dependency><br> <groupId>de.codecentric</groupId><br> <artifactId>spring-boot-admin-starter-server</artifactId><br> <version>2.7.10</version><br> </dependency><br> <dependency><br> <groupId>org.springframework.boot</groupId><br> <artifactId>spring-boot-starter-web</artifactId><br> </dependency>
- 启动类添加
@EnableAdminServer注解:@SpringBootApplication<br> @EnableAdminServer<br> public class AdminServerApplication {<br> public static void main(String[] args) {<br> SpringApplication.run(AdminServerApplication.class, args);<br> }<br> } - 配置基础信息(如
application.yml):server:<br> port: 8085<br> spring:<br> application:<br> name: admin-server
二、配置 Admin Client 客户端
这是你原本的业务应用,只需轻量集成,无需改造业务逻辑:
Java项目代码review工具。分析Git变更+完整调用链路上下文,推断业务需求,进行多维度评分和分类汇总,生成完整PRD文档。包含细粒度Java代码审查清单(Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 添加客户端依赖(同时确保已引入
spring-boot-starter-actuator):<dependency><br> <groupId>org.springframework.boot</groupId><br> <artifactId>spring-boot-starter-actuator</artifactId><br> </dependency><br> <dependency><br> <groupId>de.codecentric</groupId><br> <artifactId>spring-boot-admin-starter-client</artifactId><br> <version>2.7.10</version><br> </dependency>
- 在
application.yml中声明服务端地址和暴露端点:spring:<br> boot:<br> admin:<br> client:<br> url: http://localhost:8085<br> management:<br> endpoints:<br> web:<br> exposure:<br> include: "*" # Spring Boot 2.6+ 必须显式开放,否则 Server 拉不到数据<br> endpoint:<br> health:<br> show-details: always # 健康详情默认受限,建议放开 - 若使用 Spring Security,需放行 Actuator 端点(例如允许未鉴权访问
/actuator/**),否则 Admin Server 无法采集数据。
三、启动与验证流程
按顺序操作,才能看到效果:
- 先启动
Admin Server(端口 8085),浏览器访问http://localhost:8085,初始界面显示 “No applications registered” - 再启动你的业务应用(即 Admin Client),控制台会输出类似
Registering application ... at http://localhost:8085/instances的日志 - 刷新 Admin Server 页面,几秒后自动识别出客户端实例,点击即可查看健康状态、内存堆栈、线程列表、环境变量、日志级别调整等
- 如果没出现,检查客户端是否成功注册:curl
http://localhost:8085/instances应返回 JSON 数组;再检查客户端能否访问http://localhost:8081/actuator/health(假设客户端端口是 8081)
四、可选增强项
让监控更实用、更安全:
-
加登录认证:在 Server 端引入
spring-boot-starter-security,配置用户名密码,并保护 UI 路径(如/login,/actuator/**) - 支持服务发现:Client 不写死 server 地址,改用 Nacos/Eureka 注册中心自动发现 Admin Server,适合微服务集群
- 通知告警:配置邮件、Slack 或企业微信 Webhook,在服务下线或健康异常时推送提醒
- 持久化历史指标:默认只存实时快照;如需趋势分析,可接入 Prometheus + Grafana,或对接 Micrometer 收集到时序数据库

















