后端可观测性指标监控监控大盘MCP 服务【免费下载链接】spring-boot-adminAdmin UI for administration of spring boot applications项目地址https://gitcode.com/gh_mirrors/sp/spring-boot-admin点击查看免费下载本文围绕 Spring Boot Admin 官方仓库中的Reactive Samplespring-boot-admin-sample-reactive展开系统讲解如何基于 Spring WebFlux 与 Netty 以全响应式、非阻塞的方式搭建 Admin Server涵盖最小化依赖、双 Profile 安全配置、自监控、构建部署以及响应式与 Servlet 两种架构的选型对比。读完本文你将能独立运行该示例、理解其底层实现原理并据此改造出自己的响应式监控管理端。示例概览为什么需要 Reactive Sample官方文档 20-sample-reactive.md 明确指出Reactive Sample 演示的是使用 Spring WebFlux响应式、非阻塞 Web 框架部署 Spring Boot Admin Server 的完整方案目标是让 Admin Server 运行在“完全响应式”的环境中且只依赖最少量的组件。维度说明位置spring-boot-admin-samples/spring-boot-admin-sample-reactive/Web 栈Spring WebFlux Reactor Netty核心特性响应式堆栈、非阻塞 I/O、WebFlux 版 Spring Security、Admin Client 自监控、基于 Profile 的安全配置、最小依赖、DevTools 开发支持与功能堆叠全面的 Servlet Sample 相比这个示例刻意保持“精简”正是为了让开发者能快速对照出响应式方案与传统方案的差异。前置条件Java 17 或更高版本项目基于现代 Spring Boot 构建参见各模块pom.xml的父工程配置Maven 3.6仓库根目录自带mvnw/mvnw.cmd包装器也可以直接使用系统 Maven。快速运行三种启动姿势1. 默认 Insecure 模式无认证cd spring-boot-admin-samples/spring-boot-admin-sample-reactive mvn spring-boot:run启动后访问http://localhost:8080即可。应用默认激活insecureProfile无需任何登录即可查看全部管理界面适合本地开发与功能演示。2. 开启 Secure 模式mvn spring-boot:run -Dspring-boot.run.profilessecure此时走secureProfile 的完整安全链路登录凭据由application.yml中的 Spring Security 用户配置决定示例本身未硬编码用户名密码正式使用请在配置中显式声明spring.security.user.name/password或接入自己的UserDetailsService。3. 修改端口SERVER_PORT9090 mvn spring-boot:runSERVER_PORT环境变量会覆盖server.port默认值解决 8080 被占用的问题。依赖设计如何做到“最小化”示例的 pom.xml 只声明了四类运行期依赖dependencies !-- Admin Server -- dependency groupIdde.codecentric/groupId artifactIdspring-boot-admin-starter-server/artifactId /dependency !-- Admin Client (for self-monitoring) -- dependency groupIdde.codecentric/groupId artifactIdspring-boot-admin-starter-client/artifactId /dependency !-- Security for WebFlux -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-security/artifactId /dependency !-- DevTools -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-devtools/artifactId optionaltrue/optional /dependency /dependencies另有一个spring-boot-starter-test以test作用域引入仅用于单元测试。关键点示例中没有显式声明任何 WebFlux 依赖。这是因为spring-boot-admin-starter-server已经内置了 Web 能力——查看 spring-boot-admin-server/pom.xml 可以发现其中直接引入了spring-boot-starter-webflux。当类路径上不存在 Servlet 容器时Spring Boot 会自动装配 WebFlux Reactor Netty 作为 Web 服务器这就是“零额外配置”跑起响应式 Admin Server 的原理。与 Servlet Sample 的 pom.xml 相比响应式示例少掉了spring-boot-starter-webmvc、spring-boot-starter-mail、spring-session-jdbc、自定义 UI 扩展等一系列依赖这正是“最小依赖”的直观体现。应用结构主类与核心 Bean 逐行解读主应用类源码位于 SpringBootAdminReactiveApplication.javaSpringBootApplication EnableAdminServer public class SpringBootAdminReactiveApplication { private final AdminServerProperties adminServer; public SpringBootAdminReactiveApplication(AdminServerProperties adminServer) { this.adminServer adminServer; } public static void main(String[] args) { SpringApplication.run(SpringBootAdminReactiveApplication.class, args); } Bean Profile(insecure) public SecurityWebFilterChain securityWebFilterChainPermitAll(ServerHttpSecurity http) { return http.authorizeExchange((authorizeExchange) - authorizeExchange.anyExchange().permitAll()) .csrf(ServerHttpSecurity.CsrfSpec::disable) .build(); } Bean Profile(secure) public SecurityWebFilterChain securityWebFilterChainSecure(ServerHttpSecurity http) { return http .authorizeExchange( (authorizeExchange) - authorizeExchange.pathMatchers(this.adminServer.path(/assets/**)) .permitAll() .pathMatchers(/actuator/health/**) .permitAll() .pathMatchers(this.adminServer.path(/login)) .permitAll() .anyExchange() .authenticated()) .formLogin((formLogin) - formLogin.loginPage(this.adminServer.path(/login)) .authenticationSuccessHandler(loginSuccessHandler(this.adminServer.path(/)))) .logout((logout) - logout.logoutUrl(this.adminServer.path(/logout)) .logoutSuccessHandler(logoutSuccessHandler(this.adminServer.path(/login?logout)))) .httpBasic(Customizer.withDefaults()) .csrf(ServerHttpSecurity.CsrfSpec::disable) .build(); } // The following two methods are only required when setting a custom base-path (see // basepath profile in application.yml) private ServerLogoutSuccessHandler logoutSuccessHandler(String uri) { RedirectServerLogoutSuccessHandler successHandler new RedirectServerLogoutSuccessHandler(); successHandler.setLogoutSuccessUrl(URI.create(uri)); return successHandler; } private ServerAuthenticationSuccessHandler loginSuccessHandler(String uri) { RedirectServerAuthenticationSuccessHandler successHandler new RedirectServerAuthenticationSuccessHandler(); successHandler.setLocation(URI.create(uri)); return successHandler; } Bean public Notifier notifier() { return (e) - Mono.empty(); } }要点拆解EnableAdminServer是激活开关从 EnableAdminServer.java 的源码可以看到它本质是一个Import(AdminServerMarkerConfiguration.class)的标记注解用于触发 Admin Server 的自动配置装配。构造器注入AdminServerProperties后续secureProfile 中所有adminServer.path(...)调用都依赖它保证安全规则始终贴合 Admin Server 的实际基础路径context-path。两个 Profile 同名 Bean 互斥激活insecure与secure都返回SecurityWebFilterChain但通过Profile保证同一时刻只有一个生效这是示例“Profile 化安全配置”的核心机制。no-op Notifiernotifier()返回(e) - Mono.empty()即收到任何实例事件都直接返回空 Mono、不做任何通知避免示例在无邮件等基础设施时报错同时演示了Notifier是一个接收事件、返回MonoVoid的函数式接口。两个 success handler 方法的注释说明仅当配置了自定义 base-path如basepathProfile时才必须提供用于把登录/登出后的重定向目标定位到 Admin Server 的实际路径前缀下。冒烟测试示例还附带了一个最小化测试 SpringBootAdminReactiveApplicationTest.java通过SpringBootTest加载整个上下文并执行contextLoads()用来验证响应式环境下的 Spring 容器与 Admin Server 自动配置能正常启动——这也可以作为你修改配置后快速回归的基准。安全配置WebFlux 版 Spring Security响应式示例与 Servlet 示例最大的差异在于安全 API 完全不同维度Servlet 示例Reactive 示例过滤器链类型SecurityFilterChainHttpSecuritySecurityWebFilterChainServerHttpSecurity授权 DSLauthorizeHttpRequestsauthorizeExchange登录/登出formLogin/logout同为formLogin/logout但 handler 为响应式实现insecure Profile默认Bean Profile(insecure) public SecurityWebFilterChain securityWebFilterChainPermitAll( ServerHttpSecurity http) { return http .authorizeExchange((authorizeExchange) - authorizeExchange.anyExchange().permitAll()) .csrf(ServerHttpSecurity.CsrfSpec::disable) .build(); }特点所有端点免认证、CSRF 关闭仅用于本地开发与测试。⚠️开发专用警告insecureProfile 严禁用于生产部署上线前必须启用安全配置。secure ProfileBean Profile(secure) public SecurityWebFilterChain securityWebFilterChainSecure( ServerHttpSecurity http) { return http .authorizeExchange((authorizeExchange) - authorizeExchange .pathMatchers(adminServer.path(/assets/**)) .permitAll() // 静态资源 .pathMatchers(/actuator/health/**) .permitAll() // 健康检查端点 .pathMatchers(adminServer.path(/login)) .permitAll() // 登录页 .anyExchange() .authenticated()) // 其余全部要求认证 .formLogin((formLogin) - formLogin .loginPage(adminServer.path(/login)) .authenticationSuccessHandler( loginSuccessHandler(adminServer.path(/)))) .logout((logout) - logout .logoutUrl(adminServer.path(/logout)) .logoutSuccessHandler( logoutSuccessHandler(adminServer.path(/login?logout)))) .httpBasic(Customizer.withDefaults()) .csrf(ServerHttpSecurity.CsrfSpec::disable) // 示例简化处理 .build(); }安全特性清单表单登录登录页指向adminServer.path(/login)与 Admin UI 内置登录页无缝衔接HTTP Basic通过httpBasic(Customizer.withDefaults())启用方便 API 客户端调用公开端点静态资源/assets/**、健康检查/actuator/health/**与登录页免认证自定义重定向登录成功后跳转 Admin 首页、登出后回到登录页均通过RedirectServerAuthenticationSuccessHandler/RedirectServerLogoutSuccessHandler实现基于路径的授权完全使用ServerHttpSecurityReactive 专用构建过滤链。 提示csrf(...)在此处被禁用是“示例简化”行为生产环境建议参照 安全文档 的 CSRF 章节重新启用并配置 Token 仓库。配置文件application.yml 全量解读示例的实际配置文件位于 spring-boot-admin-samples/spring-boot-admin-sample-reactive/src/main/resources/application.ymlinfo: scm-url: scm.url build-url: https://travis-ci.org/codecentric/spring-boot-admin logging: file: name: target/boot-admin-sample-reactive.log management: endpoints: web: exposure: include: * endpoint: health: show-details: ALWAYS spring: application: name: spring-boot-admin-sample-reactive boot: admin: client: url: http://localhost:8080 profiles: active: - insecure配置高亮自监控Self-Monitoringspring.boot.admin.client.url指向本应用地址http://localhost:8080Admin Client 启动后会把应用自身注册到 Admin Server实现“自己监控自己”全量暴露 Actuator 端点management.endpoints.web.exposure.include: *让 Admin UI 能展示全部端点数据健康详情始终可见show-details: ALWAYS便于在 UI 上直接看到各组件的健康明细默认激活insecurespring.profiles.active: insecure与主类中的Profile(insecure)Bean 一一对应日志落盘日志写入target/boot-admin-sample-reactive.log方便在自监控与调试时查阅。响应式架构优势为什么值得关注1. 非阻塞 I/O全链路响应式从实例查询到事件流再到 HTTP 调用都是非阻塞的// 实例查询是响应式的 FluxInstance instances instanceRepository.findAll(); // 事件流是响应式的 FluxInstanceEvent events eventStore.findAll(); // HTTP 调用是响应式的 MonoClientResponse response webClient .get() .uri(/actuator/health) .exchange();2. 更高效的资源利用线程模型基于 Netty Event Loop线程数量固定且远小于“每请求一线程”的 Servlet 模型内存占用无大量阻塞线程栈整体 footprint 更低伸缩性少量线程即可承载大量并发连接。3. 背压Backpressure支持响应式流天然支持背压慢消费者不会被快生产者压垮// 慢消费者不会压垮快生产者 eventStore.findAll() .limitRate(100) // 每次只处理 100 个事件 .subscribe(event - processEvent(event));4. 对微服务更友好韧性非阻塞调用避免线程池耗尽导致的级联故障延迟高负载下尾部延迟更优吞吐I/O 密集型操作吞吐更高。测试与验证样例访问 UI 与自监控验证启动应用默认 insecure 模式无需登录打开http://localhost:8080在应用列表中应能看到应用名spring-boot-admin-sample-reactive状态UP全部 Actuator 端点可用日志输出到target/boot-admin-sample-reactive.log可随时 tail 观察注册、健康检查等事件。验证响应式线程模型监控线程数量可以直观感受响应式的线程效率# 查看线程数应远低于 Servlet 模式 jcmd pid Thread.print | grep nioEventLoopGroup | wc -l预期仅约 48 个 Netty Event Loop 线程而同等负载下 Servlet 模式往往需要成百上千个线程。这一差异正是“少量线程承载高并发”这一响应式核心理念的直接证据。性能对比测试可以用 ApacheBench 做简单压测对比两种示例注意 Servlet 示例需另行配置端口# 响应式示例 ab -n 10000 -c 100 http://localhost:8080/actuator/health # Servlet 示例 ab -n 10000 -c 100 http://localhost:8081/actuator/health预期结论同等请求量下响应式示例能以更少的线程与内存资源完成更高的并发处理。需要注意压测结论受机器环境、JVM 参数影响应以自己环境的实测数据为准。构建与部署打包mvn clean package由于 pom.xml 中配置了finalName${project.artifactId}产物为target/spring-boot-admin-sample-reactive.jar且spring-boot-maven-plugin同时执行repackage与build-info两个 goal后者会生成 BuildInfo供 Actuatorinfo端点展示构建信息。运行java -jar target/spring-boot-admin-sample-reactive.jar携带 Secure Profile 运行java -jar target/spring-boot-admin-sample-reactive.jar \ --spring.profiles.activesecure生产环境参考配置spring: profiles: active: - secure # 启用安全 security: user: name: admin password: ${ADMIN_PASSWORD} server: port: 8443 ssl: enabled: true key-store: classpath:keystore.p12 key-store-password: ${KEYSTORE_PASSWORD} management: server: port: 8081 # 独立管理端口要点生产环境必须激活secure、通过环境变量注入凭据与密钥库口令、启用 TLS并可考虑将 Actuator 独立到管理端口management.server.port降低攻击面。对比Reactive vs Servlet维度Reactive 示例Servlet 示例Web 栈WebFluxNettySpring MVCTomcat线程模型Event Loop4~8 线程每请求一线程200 线程I/O 模型非阻塞阻塞内存更低更高伸缩性高可支撑大量并发连接中数百连接量级复杂度学习曲线更陡传统、易上手依赖最小化更多适用场景高并发、I/O 密集CPU 密集、传统应用选型建议何时用哪种✅ 选择 Reactive需要监控大量实例100高并发需求微服务架构云原生部署资源受限内存/CPU 紧张I/O 密集型负载。❌ 选择 Servlet传统单体应用团队不熟悉响应式编程重 CPU 密集型处理已有 Servlet 基础设施需要更简单的调试路径。常见问题排查ClassNotFoundExceptionWebFlux 相关类缺失java.lang.ClassNotFoundException: reactor.netty.http.server.HttpServer原因类路径上混入了 Servlet 依赖导致 Spring Boot 选择了 Servlet 容器而不是 WebFlux。解决移除显式引入的 Servlet 依赖!-- 如存在则移除 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-webmvc/artifactId /dependency端口冲突8080 被占用时改用环境变量换端口SERVER_PORT9090 mvn spring-boot:run安全配置未生效用 Actuator 验证当前激活的 Profilecurl http://localhost:8080/actuator/env | jq .activeProfiles确认secure是否如预期处于激活状态Profile 既可写在application.yml也可通过命令行--spring.profiles.activesecure覆盖。扩展思路把示例改造成你的响应式管理端自定义响应式 Notifier用 WebClient 把实例事件推送到任意 WebhookBean public Notifier customReactiveNotifier() { return (event) - { return webClient .post() .uri(https://webhook.site/...) .bodyValue(event) .retrieve() .bodyToMono(Void.class) .onErrorResume(e - { log.error(Notification failed, e); return Mono.empty(); }); }; }定制 Admin Server 的 WebClient如超时Bean public InstanceWebClientCustomizer customTimeout() { return (builder) - builder .clientConnector(new ReactorClientHttpConnector( HttpClient.create() .responseTimeout(Duration.ofSeconds(10)) )); }自定义响应式健康指示器Component public class CustomHealthIndicator implements ReactiveHealthIndicator { Override public MonoHealth health() { return Mono.just(Health.up() .withDetail(custom, Reactive health check) .build()); } }关键要点回顾✅响应式架构WebFlux Netty 非阻塞 I/O资源利用高效✅安全双 Profileinsecure开发免认证 /secure完整表单登录 Basic 路径授权✅最小依赖WebFlux 由spring-boot-admin-starter-server传递引入无冗余组件启动更快、部署更轻✅开箱即用自监控、全量 Actuator、日志落盘均已配置妥当。继续深入对比传统部署方式Servlet Sample了解服务发现集成Eureka Sample了解集群化部署Hazelcast Sample扩展 Admin Server 能力Customization Guide服务端配置详解Server Configuration客户端注册原理Client Registration安全加固实践05-security 文档目录赞分享后端可观测性指标监控监控大盘MCP 服务【免费下载链接】spring-boot-adminAdmin UI for administration of spring boot applications项目地址https://gitcode.com/gh_mirrors/sp/spring-boot-admin点击查看免费下载相关推荐AG-UI Spring WebFlux Boot Starter 实战一个依赖把 Agent 暴露成响应式 SSE 端点AG UI Spring WebFlux Boot Starter 实战一个依赖把 Agent 暴露成响应式 SSE 端点 本指南聚焦 AG UI 项目Ag人工智能AI AgentSpring WebFlux响应式编程深度探索Spring WebFlux响应式编程深度探索 本文深入探讨了Spring WebFlux响应式编程框架的核心架构与实现原理。首先介绍了响应式编程模型和Reac后端Web框架依赖注入从阻塞到响应式Spring Reactive 实战指南2025全场景案例从阻塞到响应式Spring Reactive 实战指南2025全场景案例 你还在为传统Spring应用的性能瓶颈发愁吗高并发场景下频繁的线程阻塞、资源浪创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考