SpringBoot Admin之應用監(jiān)控與告警配置方式
更新時間：2025年04月15日 09:45:48 作者：程序媛學姐
這篇文章主要介紹了SpringBoot Admin之應用監(jiān)控與告警配置方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教
引言
在微服務架構和分布式系統(tǒng)的廣泛應用背景下，有效監(jiān)控應用運行狀態(tài)并及時發(fā)現(xiàn)潛在問題變得尤為重要。Spring Boot Admin 是一個開源的監(jiān)控解決方案，專為 Spring Boot 應用設計，它提供了直觀的 Web UI 界面，使開發(fā)者和運維人員能夠實時監(jiān)控應用指標、查看日志、管理 Bean、檢查環(huán)境配置等。本文將深入探討 Spring Boot Admin 的核心功能、配置方法以及如何實現(xiàn)有效的應用監(jiān)控和告警系統(tǒng)，幫助團隊構建更加健壯和可靠的應用生態(tài)。
一、Spring Boot Admin 基礎架構
Spring Boot Admin 由兩部分組成：服務端和客戶端。服務端提供 Web UI 界面，收集和展示客戶端信息；客戶端則將應用信息推送到服務端或允許服務端拉取信息。這種架構使得 Spring Boot Admin 能夠集中監(jiān)控多個 Spring Boot 應用。
要開始使用 Spring Boot Admin，首先需要創(chuàng)建一個服務端應用：
<dependency>
<groupId>de.codecentric</groupId>
<artifactId>spring-boot-admin-starter-server</artifactId>
<version>2.7.0</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>在應用程序入口類上添加 @EnableAdminServer 注解：
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);
}
}接下來，配置需要監(jiān)控的客戶端應用：
<dependency>
<groupId>de.codecentric</groupId>
<artifactId>spring-boot-admin-starter-client</artifactId>
<version>2.7.0</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>在客戶端的 application.properties 文件中配置 Admin Server 地址和 Actuator 端點：
# Admin Server 地址
spring.boot.admin.client.url=http://localhost:8080
spring.boot.admin.client.instance.name=${spring.application.name}
# 暴露 Actuator 端點
management.endpoints.web.exposure.include=*
management.endpoint.health.show-details=always通過以上配置，客戶端應用會自動注冊到 Admin Server，并開始上報監(jiān)控數(shù)據(jù)。
二、監(jiān)控指標與可視化
Spring Boot Admin 基于 Spring Boot Actuator 提供的端點，展示了豐富的應用監(jiān)控指標，包括：
2.1 健康狀態(tài)監(jiān)控
健康狀態(tài)是最基本的監(jiān)控指標，展示應用及其依賴組件（數(shù)據(jù)庫、緩存、消息隊列等）的狀態(tài)：
import org.springframework.boot.actuate.health.Health;
import org.springframework.boot.actuate.health.HealthIndicator;
import org.springframework.stereotype.Component;
@Component
public class CustomHealthIndicator implements HealthIndicator {
@Override
public Health health() {
int errorCode = checkService(); // 自定義健康檢查邏輯
if (errorCode != 0) {
return Health.down()
.withDetail("Error Code", errorCode)
.build();
}
return Health.up().build();
}
private int checkService() {
// 實現(xiàn)具體的服務檢查邏輯
return 0; // 0 表示正常
}
}2.2 性能指標監(jiān)控
Spring Boot Admin 展示了 JVM 內(nèi)存使用、線程狀態(tài)、GC 活動等關鍵性能指標：
# 配置 Micrometer 收集更詳細的性能指標 management.metrics.export.simple.enabled=true management.metrics.enable.all=true
自定義業(yè)務指標可以通過 Micrometer 注冊：
import io.micrometer.core.instrument.Counter;
import io.micrometer.core.instrument.MeterRegistry;
import org.springframework.stereotype.Service;
@Service
public class OrderService {
private final Counter orderCounter;
public OrderService(MeterRegistry registry) {
this.orderCounter = Counter.builder("app.orders.created")
.description("Number of orders created")
.register(registry);
}
public void createOrder() {
// 業(yè)務邏輯
orderCounter.increment();
}
}2.3 日志查看
Spring Boot Admin 允許直接在 Web 界面查看應用日志，配置方式如下：
# 配置日志文件路徑
logging.file.name=logs/application.log
# 啟用 logfile 端點
management.endpoint.logfile.enabled=true
management.endpoint.logfile.external-file=${logging.file.name}三、告警配置
Spring Boot Admin 支持多種告警方式，當應用狀態(tài)變化時（例如從 UP 變?yōu)?DOWN）觸發(fā)通知：
3.1 郵件告警
配置郵件告警需要添加依賴：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>在 Admin Server 的配置文件中添加郵件配置：
# 郵件服務器配置 spring.mail.host=smtp.example.com spring.mail.port=25 spring.mail.username=admin spring.mail.password=secret spring.mail.properties.mail.smtp.auth=true spring.mail.properties.mail.smtp.starttls.enable=true # 告警配置 spring.boot.admin.notify.mail.to=admin@example.com spring.boot.admin.notify.mail.from=spring-boot-admin@example.com spring.boot.admin.notify.mail.template=classpath:/email-templates/status-changed.html spring.boot.admin.notify.mail.ignore-changes=UNKNOWN:UP,DOWN:UNKNOWN
3.2 釘釘/企業(yè)微信告警
對于企業(yè)環(huán)境，可以配置釘釘或企業(yè)微信告警：
import de.codecentric.boot.admin.server.config.AdminServerNotifierAutoConfiguration;
import de.codecentric.boot.admin.server.domain.entities.Instance;
import de.codecentric.boot.admin.server.domain.entities.InstanceRepository;
import de.codecentric.boot.admin.server.domain.events.InstanceEvent;
import de.codecentric.boot.admin.server.notify.AbstractStatusChangeNotifier;
import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.stereotype.Component;
import org.springframework.web.client.RestTemplate;
import reactor.core.publisher.Mono;
@Component
public class DingTalkNotifier extends AbstractStatusChangeNotifier {
private final String webhookUrl = "https://oapi.dingtalk.com/robot/send?access_token=xxx";
private final RestTemplate restTemplate = new RestTemplate();
public DingTalkNotifier(InstanceRepository repository) {
super(repository);
}
@Override
protected Mono<Void> doNotify(InstanceEvent event, Instance instance) {
return Mono.fromRunnable(() -> {
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);
String message = String.format("""
{
"msgtype": "text",
"text": {
"content": "應用狀態(tài)變更: %s 實例 %s 狀態(tài)從 %s 變?yōu)?%s"
}
}
""",
instance.getRegistration().getName(),
instance.getId(),
getLastStatus(event.getInstance()),
instance.getStatusInfo().getStatus());
HttpEntity<String> request = new HttpEntity<>(message, headers);
restTemplate.postForEntity(webhookUrl, request, String.class);
});
}
}3.3 自定義告警規(guī)則
Spring Boot Admin 允許通過自定義 Notifier 實現(xiàn)復雜的告警規(guī)則：
import de.codecentric.boot.admin.server.domain.entities.Instance;
import de.codecentric.boot.admin.server.domain.events.InstanceEvent;
import de.codecentric.boot.admin.server.notify.AbstractStatusChangeNotifier;
import org.springframework.stereotype.Component;
import reactor.core.publisher.Mono;
@Component
public class CustomNotifier extends AbstractStatusChangeNotifier {
public CustomNotifier(InstanceRepository repository) {
super(repository);
}
@Override
protected boolean shouldNotify(InstanceEvent event, Instance instance) {
// 自定義告警觸發(fā)條件
if (instance.getStatusInfo().isDown()) {
// 檢查是否是生產(chǎn)環(huán)境
String env = instance.getRegistration().getMetadata().get("environment");
return "production".equals(env);
}
return false;
}
@Override
protected Mono<Void> doNotify(InstanceEvent event, Instance instance) {
return Mono.fromRunnable(() -> {
// 實現(xiàn)告警邏輯，如調(diào)用外部告警系統(tǒng)API
});
}
}四、安全配置
在生產(chǎn)環(huán)境中，應該為 Spring Boot Admin 添加安全保護。最常用的方式是集成 Spring Security：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-security</artifactId>
</dependency>配置基本認證：
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
import org.springframework.security.web.authentication.SavedRequestAwareAuthenticationSuccessHandler;
import org.springframework.security.web.csrf.CookieCsrfTokenRepository;
@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Override
protected void configure(HttpSecurity http) throws Exception {
SavedRequestAwareAuthenticationSuccessHandler successHandler = new SavedRequestAwareAuthenticationSuccessHandler();
successHandler.setTargetUrlParameter("redirectTo");
successHandler.setDefaultTargetUrl("/");
http.authorizeRequests()
.antMatchers("/assets/**").permitAll()
.antMatchers("/login").permitAll()
.anyRequest().authenticated()
.and()
.formLogin().loginPage("/login").successHandler(successHandler)
.and()
.logout().logoutUrl("/logout")
.and()
.httpBasic()
.and()
.csrf().csrfTokenRepository(CookieCsrfTokenRepository.withHttpOnlyFalse());
}
}客戶端注冊到安全保護的 Admin Server 需要提供憑證：
spring.boot.admin.client.username=admin spring.boot.admin.client.password=admin
五、實戰(zhàn)應用與最佳實踐
5.1 集成服務發(fā)現(xiàn)
在微服務環(huán)境中，可以集成 Eureka、Consul 等服務發(fā)現(xiàn)機制自動注冊應用：
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>@Configuration
public class DiscoveryConfig {
@Bean
public EurekaDiscoveryClient discoveryClient(EurekaClient eurekaClient) {
return new EurekaDiscoveryClient(eurekaClient);
}
}5.2 分層告警策略
建立分層告警策略，根據(jù)問題嚴重程度選擇不同的通知方式：
- 輕微問題：僅記錄日志或發(fā)送郵件
- 中等問題：發(fā)送企業(yè)即時通訊通知（釘釘/企業(yè)微信）
- 嚴重問題：短信和電話告警，確保立即處理
5.3 自定義儀表盤
通過 Grafana 與 Prometheus 集成，創(chuàng)建更強大的監(jiān)控儀表盤：
# Prometheus 配置 management.metrics.export.prometheus.enabled=true management.endpoint.prometheus.enabled=true
總結
Spring Boot Admin 為 Spring Boot 應用提供了強大而簡潔的監(jiān)控解決方案，通過直觀的界面展示應用的健康狀態(tài)、性能指標和配置信息。合理配置告警機制，可以及時發(fā)現(xiàn)并響應潛在問題，提高系統(tǒng)的可靠性和可用性。在實際應用中，應結合安全配置、服務發(fā)現(xiàn)、分層告警策略等最佳實踐，構建完善的應用監(jiān)控體系。
隨著微服務和分布式系統(tǒng)的復雜度不斷提高，Spring Boot Admin 作為輕量級監(jiān)控工具，能夠幫助開發(fā)者和運維人員更好地理解應用行為、優(yōu)化性能，以及快速定位和解決問題，是現(xiàn)代 Spring Boot 應用不可或缺的監(jiān)控利器。
以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。
相關文章
在java項目的實際開發(fā)和應用中，常常需要用到將對象轉為String這一基本功能。本文就詳細的介紹幾種方法，感興趣的可以了解一下2021-08-08
MD5的全稱是message-digest algorithm 5 信息-摘要算法。這篇文章主要為大家詳細介紹了Java中MD5二次加密的應用，感興趣的小伙伴可以了解一下2023-02-02
Spring?Boot實現(xiàn)WebSocket實時通信
本文主要介紹了Spring?Boot實現(xiàn)WebSocket實時通信,包含實現(xiàn)實時消息傳遞和群發(fā)消息等功能,具有一定的參考價值,感興趣的可以了解一下2024-05-05
中綴表達式是一個通用的算術或邏輯公式表示方法。，中綴表達式不容易被計算機解析，但仍被許多程序語言使用，因為它符合人們的普遍用法。本文介紹了實現(xiàn)中綴表達式的方法，需要的可以參考一下2022-07-07
在本篇里我們給大家總結了關于springmvc常用5種注解相關知識點以及實例代碼，需要的朋友們參考下。2019-07-07
SpringBoot使用Redis對用戶IP進行接口限流的項目實踐
本文主要介紹了SpringBoot使用Redis對用戶IP進行接口限流，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2023-07-07
MyBatis中獲取Mysql數(shù)據(jù)庫插入記錄的主鍵值的實現(xiàn)
本文主要介紹了MyBatis中獲取Mysql數(shù)據(jù)庫插入記錄的主鍵值的實現(xiàn),包含了三種實現(xiàn)方式,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2024-06-06
Java虛擬機把描述類的數(shù)據(jù)從Class文件加載到內(nèi)存，并對數(shù)據(jù)進行校驗、轉換解析和初始化，最終形成可以被虛擬機直接使用的Java類型，這個過程被稱作虛擬機的類加載機制。本文將詳解Java的類加載機制，需要的可以參考一下2022-05-05
這篇文章主要為大家介紹了SpringBoot項目jar和war打包部署方式詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2022-09-09
Spring + Spring Boot + MyBatis + MongoDB的整合教程
這篇文章主要給大家介紹了關于Spring + Spring Boot + MyBatis + MongoDB的整合教程，文中通過圖文以及示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面來一起看看吧。2017-12-12