Spring Boot - Admin Server

使用 Spring Boot Actuator Endpoint 监控您的应用有些困难。因为，如果您有 n 个应用，每个应用都有独立的 actuator endpoints，从而使监控变得困难。Spring Boot Admin Server 是一个用于管理和监控您的 Microservice 应用的应用程序。

为了处理这种情况，CodeCentric 团队提供了一个 Spring Boot Admin UI，用于在一个地方管理和监控所有 Spring Boot 应用的 Actuator endpoints。

要构建 Spring Boot Admin Server，需要在构建配置文件中添加以下依赖。

Maven 用户可以在 pom.xml 文件中添加以下依赖 −

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

Gradle 用户可以在 build.gradle 文件中添加以下依赖 −

compile group: 'de.codecentric', name: 'spring-boot-admin-starter-server', version: '3.5.0'

示例 - 创建 Spring Admin Server

首先，从 Spring Initializer 页面下载 Spring Boot 项目，并选择 Spring Admin Server 和 Admin Server UI 依赖。请观察下面的截图 −

在主 Spring Boot application class 文件中添加 @EnableAdminServer 注解。@EnableAdminServer 注解用于将你的应用配置为 Admin Server，以监控所有其他 microservices。

AdminserverApplication

package com.example.adminserver;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

import de.codecentric.boot.admin.server.config.EnableAdminServer;

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

现在，在 application.properties 文件中定义 server.port 和 application name，如下所示 −

server.port=9090
spring.application.name=adminserver

对于 YAML 用户，请使用以下属性在 application.yml 文件中定义端口号和 application name。

server:
   port: 9090
spring:
   application:
      name: adminserver

build 配置文件如下所示。

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
   <modelVersion>4.0.0</modelVersion>
   <parent>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      <version>3.5.6</version>
      <relativePath/> <!-- lookup parent from repository -->
   </parent>
   <groupId>com.example</groupId>
   <artifactId>adminserver</artifactId>
   <version>0.0.1-SNAPSHOT</version>
   <name>adminserver</name>
   <description>Demo project for Spring Boot</description>
   <url/>
   <licenses>
      <license/>
   </licenses>
   <developers>
      <developer/>
   </developers>
   <scm>
      <connection/>
      <developerConnection/>
      <tag/>
      <url/>
   </scm>
   <properties>
      <java.version>21</java.version>
      <spring-boot-admin.version>3.5.0</spring-boot-admin.version>
   </properties>
   <dependencies>
      <dependency>
         <groupId>de.codecentric</groupId>
         <artifactId>spring-boot-admin-starter-server</artifactId>
      </dependency>
      <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-test</artifactId>
         <scope>test</scope>
      </dependency>
   </dependencies>
   <dependencyManagement>
      <dependencies>
         <dependency>
            <groupId>de.codecentric</groupId>
            <artifactId>spring-boot-admin-dependencies</artifactId>
            <version>${spring-boot-admin.version}</version>
            <type>pom</type>
            <scope>import</scope>
         </dependency>
      </dependencies>
   </dependencyManagement>
   <build>
      <plugins>
         <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
         </plugin>
      </plugins>
   </build>
</project>

对于 Gradle 用户的 build.gradle 文件

buildscript {
   ext {
      springBootVersion = '3.5.6'
   }
   repositories {
      mavenCentral()
   }
   dependencies {
      classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
   }
}

apply plugin: 'java'
apply plugin: 'eclipse'
apply plugin: 'org.springframework.boot'

group = 'com.'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = 21
repositories {   
   mavenCentral()
}
dependencies {
   compile('org.springframework.boot:spring-boot-starter')
   compile group: 'de.codecentric', name: 'spring-boot-admin-server', version: '3.5.0'
   testCompile('org.springframework.boot:spring-boot-starter-test')
}

输出

你可以使用以下 Maven 或 Gradle 命令创建可执行 JAR 文件，并运行 Spring Boot 应用 −

对于 Maven，使用以下命令 −

mvn clean install

“BUILD SUCCESS” 后，你可以在 target 目录下找到 JAR 文件。

对于 Gradle，使用以下命令 −

gradle clean build

“BUILD SUCCESSFUL” 后，你可以在 build/libs 目录下找到 JAR 文件。

现在，使用以下命令运行 JAR 文件 −

java jar <JARFILE> 

现在，应用已在 Tomcat 端口 9090 上启动，如下所示 −

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/

 :: Spring Boot ::                (v3.5.6)

2025-09-29T16:36:36.114+05:30  INFO 37600 --- [adminserver] [           main] c.e.adminserver.AdminserverApplication   : Starting AdminserverApplication using Java 21.0.6 with PID 37600 (D:\Projects\adminserver\target\classes started by mahes in D:\Projects\adminserver)
2025-09-29T16:36:36.121+05:30  INFO 37600 --- [adminserver] [           main] c.e.adminserver.AdminserverApplication   : No active profile set, falling back to 1 default profile: "default"
2025-09-29T16:36:37.911+05:30  WARN 37600 --- [adminserver] [           main] ion$DefaultTemplateResolverConfiguration : Cannot find template location: classpath:/templates/ (please add some templates, check your Thymeleaf configuration, or set spring.thymeleaf.check-template-location=false)
2025-09-29T16:36:38.140+05:30  INFO 37600 --- [adminserver] [           main] o.s.b.a.e.web.EndpointLinksResolver      : Exposing 1 endpoint beneath base path '/actuator'
2025-09-29T16:36:38.901+05:30  INFO 37600 --- [adminserver] [           main] o.s.b.web.embedded.netty.NettyWebServer  : Netty started on port 9090 (http)
2025-09-29T16:36:38.917+05:30  INFO 37600 --- [adminserver] [           main] c.e.adminserver.AdminserverApplication   : Started AdminserverApplication in 3.315 seconds (process running for 3.748)

现在，从你的 web browser 中访问以下 URL，即可看到 Admin Server UI。

http://localhost:9090/