Spring Boot Admin：管理与监控面板 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

好嘞，各位观众老爷们，欢迎来到“Spring Boot Admin：管理与监控面板”专场！我是你们的老朋友，人称“代码界段子手”的程序猿小明。今天咱不聊高深的算法，不谈复杂的架构，就来聊聊 Spring Boot 项目的“贴身管家”——Spring Boot Admin。

想象一下，你辛辛苦苦写的 Spring Boot 应用，就像你含辛茹苦养大的孩子，你总得知道它吃得好不好，睡得香不香，有没有偷偷摸摸玩游戏吧？Spring Boot Admin 就是你的“家长监控器”，让你对应用的运行状态了如指掌，及时发现并解决问题，防患于未然。

一、为什么要用 Spring Boot Admin？（痛点分析）

在没有 Spring Boot Admin 之前，我们是怎么监控和管理 Spring Boot 应用的呢？

土法炼钢型： 登录服务器，敲命令，看日志，手动重启… 这效率，简直就是石器时代！而且，服务器多了，眼睛都看花了，容易漏掉重要信息。
Prometheus + Grafana 型： 功能强大，但配置复杂，学习曲线陡峭，杀鸡焉用牛刀？对于简单的 Spring Boot 应用，有点过于重型。
各种云平台监控： 依赖云平台，成本较高，而且有些功能可能不满足你的个性化需求。

所以，我们需要一个轻量级、易于使用、功能够用的监控管理工具，而 Spring Boot Admin 正是满足这些需求的完美选择。

二、Spring Boot Admin 是什么？（概念扫盲）

简单来说，Spring Boot Admin 是一个用于管理和监控 Spring Boot 应用程序的 UI 控制台。它基于 Spring Boot Actuator，可以收集应用程序的各种指标数据，例如：

JVM 内存使用情况： 看看内存有没有泄漏，会不会发生 OOM (Out of Memory)。
CPU 使用率： 看看应用是不是在疯狂地占用 CPU 资源。
请求处理时间： 看看接口响应速度是否正常。
健康状态： 应用是否正常运行。
日志级别： 可以动态修改日志级别，方便调试。
线程信息： 看看有没有死锁或者线程阻塞。
环境变量： 查看应用的配置信息。
缓存信息： 监控缓存的使用情况。

有了这些数据，你就可以对应用程序的运行状况进行实时监控，及时发现问题，并采取相应的措施。就像医生给病人做体检一样，让你对应用程序的健康状况了如指掌。

三、Spring Boot Admin 的架构设计（深入剖析）

Spring Boot Admin 的架构非常简单，主要由两部分组成：

Admin Server： 管理服务器，负责收集和展示应用程序的监控数据。它是一个独立的 Spring Boot 应用程序，需要单独部署。
Admin Client： 客户端，嵌入到需要监控的 Spring Boot 应用程序中。它负责将应用程序的监控数据发送给 Admin Server。

它们之间的通信方式通常是 HTTP 或者 WebSocket。Admin Client 定期将监控数据发送给 Admin Server，Admin Server 将这些数据存储起来，并通过 UI 界面展示出来。

可以用下图来表示：

+--------------------+     +--------------------+
|  Spring Boot App   | --> |  Spring Boot Admin  |
|  (Admin Client)    |     |    (Admin Server)   |
+--------------------+     +--------------------+
        |                                ^
        | HTTP/WebSocket                |
        +--------------------------------+
            监控数据

四、Spring Boot Admin 的快速入门（手把手教学）

接下来，我们来一步步搭建一个 Spring Boot Admin 实例，让你的 Spring Boot 应用乖乖地接受“体检”。

1. 搭建 Admin Server

创建 Spring Boot 项目： 使用 Spring Initializr 创建一个 Spring Boot 项目，添加以下依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>de.codecentric</groupId>
        <artifactId>spring-boot-admin-starter-server</artifactId>
        <version>2.7.9</version>  <!--  请替换为最新版本  -->
    </dependency>
</dependencies>

添加 @EnableAdminServer 注解： 在你的 Spring Boot 应用主类上添加 @EnableAdminServer 注解，开启 Admin Server 功能。

import de.codecentric.boot.admin.server.config.EnableAdminServer;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
@EnableAdminServer
public class AdminServerApplication {

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

配置 application.yml： 配置 Admin Server 的端口号和其他一些基本信息。
```
server:
  port: 8080
spring:
  application:
    name: spring-boot-admin-server
```
启动 Admin Server： 运行你的 Spring Boot 应用，Admin Server 就启动起来了。在浏览器中访问 http://localhost:8080，你就可以看到 Admin Server 的 UI 界面了。

2. 搭建 Admin Client

创建 Spring Boot 项目： 使用 Spring Initializr 创建一个 Spring Boot 项目，添加以下依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
    <dependency>
        <groupId>de.codecentric</groupId>
        <artifactId>spring-boot-admin-starter-client</artifactId>
        <version>2.7.9</version>  <!--  请替换为最新版本  -->
    </dependency>
</dependencies>

配置 application.yml： 配置 Admin Client 的信息，包括 Admin Server 的地址。
```
spring:
  application:
    name: spring-boot-admin-client
management:
  endpoints:
    web:
      exposure:
        include: '*'  #  暴露所有 Actuator 端点
eureka:
  client:
    enabled: false # 禁用 Eureka 客户端
spring.boot.admin.client.url: http://localhost:8080 # Admin Server 地址
```
注意：
- management.endpoints.web.exposure.include: '*' 这一行非常重要，它允许 Admin Server 访问你的应用程序的 Actuator 端点，从而获取监控数据。
- 如果你的应用注册到了 Eureka 或其他服务发现中心，你需要确保 Admin Client 能够正确地找到 Admin Server。如果没有服务发现，可以禁用 Eureka 客户端。
启动 Admin Client： 运行你的 Spring Boot 应用，Admin Client 就启动起来了。
查看 Admin Server UI： 刷新 Admin Server 的 UI 界面，你应该可以看到你的 Admin Client 已经注册上来了。

恭喜你！你已经成功搭建了一个 Spring Boot Admin 实例，可以开始监控你的 Spring Boot 应用了！🎉

五、Spring Boot Admin 的高级用法（进阶修炼）

仅仅会搭建和使用 Spring Boot Admin 还不够，我们还需要了解它的高级用法，才能更好地利用它来管理和监控我们的应用程序。

1. 安全配置

默认情况下，Admin Server 的 UI 界面是没有任何安全保护的，任何人都可以访问。这显然是不安全的，我们需要进行安全配置。

HTTP Basic Authentication： 这是最简单的安全配置方式，只需要在 application.yml 中添加以下配置即可：
```
spring:
  security:
    user:
      name: admin
      password: password
```
这样，访问 Admin Server 的 UI 界面就需要输入用户名和密码了。

Spring Security： 如果你需要更复杂的安全配置，可以使用 Spring Security。你需要添加 Spring Security 的依赖，并配置相应的安全策略。

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

然后，你需要创建一个 Spring Security 配置类，并配置你的安全策略。

import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests()
                .antMatchers("/assets/**").permitAll()
                .antMatchers("/login").permitAll()
                .anyRequest().authenticated()
                .and()
                .formLogin()
                .loginPage("/login")
                .and()
                .logout().logoutSuccessUrl("/login");
    }
}

注意： Spring Security 的配置比较复杂，需要根据你的实际需求进行配置。

2. 通知配置

Spring Boot Admin 可以配置各种通知，例如：

邮件通知： 当应用程序的状态发生变化时，发送邮件通知。
Slack 通知： 当应用程序的状态发生变化时，发送 Slack 通知。
Webhook 通知： 当应用程序的状态发生变化时，发送 Webhook 通知。

你可以根据你的实际需求配置不同的通知方式。

邮件通知配置示例

首先，添加 spring-boot-starter-mail 依赖到 Admin Server 项目中：

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

然后在 application.yml 中配置邮件服务器信息：

spring:
  mail:
    host: smtp.example.com  # 你的 SMTP 服务器地址
    port: 587                # SMTP 端口
    username: [email protected] # 你的邮箱地址
    password: your_password      # 你的邮箱密码
    properties:
      mail:
        smtp:
          auth: true
          starttls:
            enable: true

最后，配置 Admin Server 的通知：

spring:
  boot:
    admin:
      notifier:
        mail:
          enabled: true
          from: [email protected]
          to: [email protected]
          subject: Spring Boot Admin Notification
          template: classpath:mail-template.html # 自定义邮件模板（可选）

你也可以自定义邮件模板，创建一个 mail-template.html 文件放在 resources 目录下。

3. 自定义 UI

Spring Boot Admin 的 UI 界面是可定制的。你可以修改 UI 的样式，添加自定义的监控指标，或者创建自定义的视图。

修改 UI 样式： 你可以通过覆盖 Admin Server 的静态资源文件来修改 UI 的样式。你可以修改 CSS 文件，JavaScript 文件，或者图片文件。
添加自定义的监控指标： 你可以通过实现 Endpoint 接口来添加自定义的监控指标。你需要创建一个类，实现 Endpoint 接口，并在类上添加 @Endpoint 注解。
创建自定义的视图： 你可以通过创建 Thymeleaf 模板来创建自定义的视图。你需要创建一个 HTML 文件，并将其放在 templates 目录下。

六、Spring Boot Admin 的最佳实践（经验分享）

在使用 Spring Boot Admin 的过程中，有一些最佳实践可以帮助你更好地利用它来管理和监控你的应用程序。

监控关键指标： 关注关键的监控指标，例如 JVM 内存使用情况，CPU 使用率，请求处理时间，错误率等。这些指标可以帮助你及时发现问题，并采取相应的措施。
设置告警阈值： 为关键的监控指标设置告警阈值，当指标超过阈值时，发送告警通知。这样可以让你及时了解应用程序的运行状况，并避免潜在的问题。
定期检查日志： 定期检查应用程序的日志，可以帮助你发现一些隐藏的问题。
及时更新版本： 及时更新 Spring Boot Admin 和 Spring Boot 的版本，可以修复一些已知的 Bug，并获得新的功能。

七、Spring Boot Admin 的替代方案（扩展视野）

虽然 Spring Boot Admin 是一个非常优秀的管理和监控工具，但它并不是唯一的选择。还有一些其他的替代方案，例如：

Prometheus + Grafana： 功能强大，但配置复杂，学习曲线陡峭。
Micrometer： 一个用于监控应用程序的 Java 库，可以与各种监控系统集成。
各种云平台监控： 依赖云平台，成本较高，而且有些功能可能不满足你的个性化需求。

你可以根据你的实际需求选择合适的监控工具。

八、总结（画龙点睛）

Spring Boot Admin 是一个轻量级、易于使用、功能够用的 Spring Boot 应用管理和监控工具。它可以让你对应用程序的运行状态了如指掌，及时发现并解决问题，防患于未然。

虽然 Spring Boot Admin 并不是万能的，但它对于简单的 Spring Boot 应用来说，已经足够使用了。如果你正在使用 Spring Boot，不妨尝试一下 Spring Boot Admin，相信它会给你带来惊喜！

最后，送给大家一句代码界的鸡汤：Bug 就像青春痘，总会冒出来的，关键是要及时发现并解决它！😉

希望这篇文章能够帮助你更好地理解和使用 Spring Boot Admin。感谢大家的观看，我们下期再见！

发表回复 取消回复

发表回复取消回复