SpringBoot 中如何使用Admin

发布时间：2021-07-30 16:11:27 作者：Leah
来源：亿速云阅读：236

# SpringBoot 中如何使用Admin

## 前言

在现代企业级应用开发中，系统监控和管理是不可或缺的一环。Spring Boot Admin 是一个用于管理和监控 Spring Boot 应用程序的开源项目，它提供了直观的 UI 界面，可以集中查看多个应用的健康状态、日志、性能指标等信息。本文将详细介绍如何在 Spring Boot 项目中集成和使用 Spring Boot Admin。

---

## 一、Spring Boot Admin 简介

Spring Boot Admin 由 codecentric 公司开源，主要功能包括：

- **应用状态监控**：实时显示应用的健康状态（UP/DOWN）
- **详细指标展示**：JVM 内存、线程、HTTP 请求等指标可视化
- **日志级别管理**：动态修改运行时日志级别
- **通知告警**：支持邮件、Slack 等告警方式
- **JMX 管理**：通过 JMX 管理 Beans

架构分为两个角色：
1. **Admin Server**：监控中心服务端
2. **Admin Client**：被监控的客户端应用

---

## 二、环境准备

### 基础环境要求
- JDK 8+
- Maven 3.5+ 或 Gradle 6.x
- Spring Boot 2.3+

---

## 三、快速搭建 Admin Server

### 1. 创建 Spring Boot 项目
通过 [start.spring.io](https://start.spring.io/) 生成基础项目，添加依赖：

```xml
<dependency>
    <groupId>de.codecentric</groupId>
    <artifactId>spring-boot-admin-starter-server</artifactId>
    <version>2.7.0</version>
</dependency>

2. 启用 Admin Server

在主类上添加注解：

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

3. 基础配置

application.yml 示例：

server:
  port: 8080
spring:
  application:
    name: admin-server

启动后访问 http://localhost:8080 即可看到管理界面。

四、配置 Admin Client

1. 客户端添加依赖

<dependency>
    <groupId>de.codecentric</groupId>
    <artifactId>spring-boot-admin-starter-client</artifactId>
    <version>2.7.0</version>
</dependency>

2. 客户端配置

application.yml 关键配置：

spring:
  boot:
    admin:
      client:
        url: http://localhost:8080  # Admin Server地址
        instance:
          name: order-service      # 实例名称
          service-url: http://${spring.application.name}:${server.port}

3. 暴露监控端点

Spring Boot Actuator 是必须的：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

配置暴露的端点：

management:
  endpoints:
    web:
      exposure:
        include: "*"
  endpoint:
    health:
      show-details: ALWAYS

五、核心功能详解

1. 应用状态监控

Admin 首页展示所有注册应用的实时状态： - 绿色：UP（健康） - 红色：DOWN（异常） - 灰色：OFFLINE（离线）

2. 详细指标查看

点击具体应用可查看： - JVM 指标：堆内存、非堆内存使用情况 - 线程信息：活动线程数、线程状态统计 - HTTP 请求：最近请求的响应时间和状态码

3. 日志级别管理

动态调整日志级别（无需重启）： 1. 进入应用详情 -> “Loggers” 2. 搜索包名（如 org.springframework） 3. 修改日志级别为 DEBUG/INFO/WARN 等

4. 通知配置（邮件示例）

spring:
  boot:
    admin:
      notify:
        mail:
          to: admin@example.com
          from: alert@system.com

六、高级配置

1. 安全控制

添加 Spring Security 依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
</dependency>

配置安全规则：

@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests()
            .antMatchers("/actuator/**").permitAll()
            .anyRequest().authenticated()
            .and().httpBasic();
    }
}

2. 集群部署

当 Admin Server 需要高可用时： - 使用 Spring Cloud 的服务发现（Eureka/Nacos） - 共享同一个数据库存储监控数据

3. 自定义监控指标

通过实现 InfoContributor 接口：

@Component
public class CustomInfoContributor implements InfoContributor {
    @Override
    public void contribute(Info.Builder builder) {
        builder.withDetail("custom.metric", getBusinessData());
    }
}

七、常见问题解决

1. 客户端注册失败

检查要点： - Admin Server URL 是否正确 - 客户端 actuator 端点是否暴露 - 网络连通性（防火墙/端口）

2. 监控数据不更新

可能原因： - 客户端未持续发送心跳（默认30秒） - 服务端缓存未刷新（尝试手动刷新页面）

3. 性能影响

建议： - 适当调大心跳间隔（默认30秒可改为60秒） - 关闭不必要的监控端点

八、最佳实践建议

生产环境务必启用安全认证
合理设置通知阈值（避免告警风暴）
区分环境（开发/测试/生产使用不同的Admin Server）
结合Grafana实现更强大的可视化

结语

Spring Boot Admin 为微服务架构提供了开箱即用的监控解决方案。通过本文的指导，您应该已经掌握了从基础搭建到高级配置的全流程。实际项目中，建议根据业务需求进一步定制化开发，例如集成企业微信告警、增加自定义健康检查指标等。

官方文档参考：https://codecentric.github.io/spring-boot-admin/ “`

这篇文章包含了： 1. 完整的技术实现流程 2. 配置示例代码片段 3. 常见问题解决方案 4. 实际应用建议 5. 必要的安全注意事项 6. 扩展阅读指引

可根据实际项目需求调整版本号和安全配置细节。