springboot admin 如何使用

### Spring Boot Admin 使用指南与配置示例 Spring Boot Admin 是一个功能强大的社区项目，用于监控和管理 Spring Boot 应用程序。通过集成 Spring Boot Actuator 提供的端点，它能够展示应用程序的健康状态、性能指标以及其他运行时信息[^2]。 #### 1. 创建 Spring Boot 项目 首先，创建一个新的 Spring Boot 项目，并确保引入了必要的依赖项。在 `pom.xml` 文件中添加以下依赖： ```xml <dependency> <groupId>de.codecentric</groupId> <artifactId>spring-boot-admin-starter-server</artifactId> <version>2.6.0</version> </dependency> ``` #### 2. 配置主类 接下来，在项目的主类中添加 `@EnableAdminServer` 注解以启用 Spring Boot Admin 功能。代码如下： ```java import de.codecentric.boot.admin.server.config.EnableAdminServer; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication @EnableAdminServer public class SpringBootAdminApplication { public static void main(String[] args) { SpringApplication.run(SpringBootAdminApplication.class, args); } } ``` 此注解会启动 Spring Boot Admin 的服务器端组件，负责接收客户端应用的注册并提供可视化界面[^1]。 #### 3. 配置客户端应用 为了让 Spring Boot Admin 能够监控其他 Spring Boot 应用程序，需要将这些应用配置为客户端。在客户端项目的 `pom.xml` 中添加以下依赖： ```xml <dependency> <groupId>de.codecentric</groupId> <artifactId>spring-boot-admin-starter-client</artifactId> <version>2.6.0</version> </dependency> ``` 同时，在客户端应用的 `application.properties` 或 `application.yml` 文件中指定 Spring Boot Admin 服务器的地址。例如： ```properties spring.boot.admin.client.url=http://localhost:9000 management.endpoints.web.exposure.include=* management.endpoint.health.show-details=ALWAYS ``` 上述配置确保客户端应用可以通过 HTTP 协议向 Spring Boot Admin 服务器注册，并公开所有 Actuator 端点以供监控[^2]。 #### 4. 启动与访问 完成以上步骤后，启动 Spring Boot Admin 服务器以及客户端应用。打开浏览器访问 `http://127.0.0.1:9000`，可以看到 Spring Boot Admin 的管理界面。在该界面上，`applications` 部分会显示已注册的客户端应用。点击具体的应用可以进入详细的监控页面，查看其健康状态、线程池使用情况、内存占用等信息[^3]。 #### 注意事项 - 如果使用的是 Spring Cloud 项目，还可以通过 Eureka 或 Consul 等服务注册中心自动发现客户端应用。 - 确保客户端应用的 Actuator 端点已正确配置并对外暴露，否则 Spring Boot Admin 将无法获取相关数据。 --- ### 示例代码 以下是完整的 Spring Boot Admin 服务器端和客户端配置示例： #### 服务器端主类 ```java import de.codecentric.boot.admin.server.config.EnableAdminServer; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication @EnableAdminServer public class SpringBootAdminApplication { public static void main(String[] args) { SpringApplication.run(SpringBootAdminApplication.class, args); } } ``` #### 客户端配置 (`application.properties`) ```properties spring.application.name=example-client spring.boot.admin.client.url=http://localhost:9000 management.endpoints.web.exposure.include=* management.endpoint.health.show-details=ALWAYS ``` ---