目录
1 Admin Server
1.1 pom.xml
1.2 application.properties
1.3 启动类
2 Admin Client
2.1 pom.xml
2.2 application.properties
3 运行及结果
虽然Spring Boot Actuator提供了对单个Spring Boot项目的监控,但是它是通过访问URL的方式来进行查看的,对于一个包含十几个乃至数十个微服务的微服务架构项目来说,每个微服务都需要调用不同的URL来查看监控信息,操作起来非常麻烦。而且监控的信息是json格式的,不方便运营人员查看。
而Spring Boot Admin是一个管理和监控Spring Boot应用程序的开源软件,它是在Spring Boot Actuator的基础上提供简洁的可视化WEB UI。在Spring Boot Admin体系中,每个应用都是一个客户端,通过HTTP或者使用Eureka注册到Admin Server中进行展示,而Spring Boot Admin UI则使用VueJs将数据展示在前端。Spring Boot Admin主要提供了如下数据展示功能:
- 展示客户端的健康状况
- 展示应用的一些详细信息,例如JVM运行状况、内存使用情况、数据库使用情况以及缓存情况等
- 展示项目构建信息
- 查看项目运行日志
- 查看Spring Boot配置信息
- 查看JVM和环境信息
- 支持Spring Cloud的postable /env- 和/refresh-endpoint
- 容易的日志级别管理
- 可以方便的与JMX-beans进行交互
- 查看线程堆栈
- 查看HTTP追踪信息
- 查看auditevents、http-endpoints、定时任务、数据库迁移
- 下载headump
- 邮件报警
- 等等…
笔者使用的Java版本是jdk-8u201,IDE使用的是IntelliJ IDEA 2019.3 x64,Spring Boot的版本是2.1.7.RELEASE,Spring Cloud的版本是Greenwich.SR2,Spring Boot Admin的版本是2.1.6。同时本文所使用的项目代码沿用笔者之前写过的文章《Spring Cloud链路跟踪:Sleuth+Zipkin》中的项目代码,并在此基础上进行继续开发。
1 Admin Server
创建一个Spring Boot项目,命名为admin-server。
1.1 pom.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78 1<?xml version="1.0" encoding="UTF-8"?>
2<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
3 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
4 <modelVersion>4.0.0</modelVersion>
5 <parent>
6 <groupId>org.springframework.boot</groupId>
7 <artifactId>spring-boot-starter-parent</artifactId>
8 <version>2.1.7.RELEASE</version>
9 <relativePath/> <!-- lookup parent from repository -->
10 </parent>
11 <groupId>com.hys</groupId>
12 <artifactId>admin-server</artifactId>
13 <version>0.0.1-SNAPSHOT</version>
14 <name>admin-server</name>
15 <description>Demo project for Spring Boot</description>
16
17 <properties>
18 <java.version>1.8</java.version>
19 <spring-boot-admin.version>2.1.6</spring-boot-admin.version>
20 <spring-cloud.version>Greenwich.SR2</spring-cloud.version>
21 </properties>
22
23 <dependencies>
24 <dependency>
25 <groupId>org.springframework.boot</groupId>
26 <artifactId>spring-boot-starter-web</artifactId>
27 </dependency>
28 <dependency>
29 <groupId>de.codecentric</groupId>
30 <artifactId>spring-boot-admin-starter-server</artifactId>
31 </dependency>
32 <dependency>
33 <groupId>org.springframework.cloud</groupId>
34 <artifactId>spring-cloud-starter</artifactId>
35 </dependency>
36 <dependency>
37 <groupId>org.springframework.cloud</groupId>
38 <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
39 </dependency>
40
41 <dependency>
42 <groupId>org.springframework.boot</groupId>
43 <artifactId>spring-boot-starter-test</artifactId>
44 <scope>test</scope>
45 </dependency>
46 </dependencies>
47
48 <dependencyManagement>
49 <dependencies>
50 <dependency>
51 <groupId>org.springframework.cloud</groupId>
52 <artifactId>spring-cloud-dependencies</artifactId>
53 <version>${spring-cloud.version}</version>
54 <type>pom</type>
55 <scope>import</scope>
56 </dependency>
57 <dependency>
58 <groupId>de.codecentric</groupId>
59 <artifactId>spring-boot-admin-dependencies</artifactId>
60 <version>${spring-boot-admin.version}</version>
61 <type>pom</type>
62 <scope>import</scope>
63 </dependency>
64 </dependencies>
65 </dependencyManagement>
66
67 <build>
68 <plugins>
69 <plugin>
70 <groupId>org.springframework.boot</groupId>
71 <artifactId>spring-boot-maven-plugin</artifactId>
72 </plugin>
73 </plugins>
74 </build>
75
76</project>
77
78
1.2 application.properties
1
2
3
4
5 1spring.application.name=admin-server
2eureka.client.service-url.defaultZone=http://peer1:1111/eureka/,http://peer2:1112/eureka/,http://peer3:1113/eureka/
3management.endpoints.web.exposure.include=*
4
5
其中最后一行配置是为了暴露所有的监控端点。
1.3 启动类
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15 1import de.codecentric.boot.admin.server.config.EnableAdminServer;
2import org.springframework.boot.SpringApplication;
3import org.springframework.boot.autoconfigure.SpringBootApplication;
4
5@EnableAdminServer
6@SpringBootApplication
7public class AdminServerApplication {
8
9 public static void main(String[] args) {
10 SpringApplication.run(AdminServerApplication.class, args);
11 }
12
13}
14
15
在启动类上加上@EnableAdminServer注解,表示开启 AdminServer。
2 Admin Client
这里改造之前写过的hello-service及feign-consumer项目代码,以此来支持Spring Boot Admin Client。
2.1 pom.xml
以下以hello-service的pom文件为例,feign-consumer项目代码的改造也类似,只是添加了Spring Boot Admin Client依赖而已:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85 1<?xml version="1.0" encoding="UTF-8"?>
2<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
3 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
4 <modelVersion>4.0.0</modelVersion>
5 <parent>
6 <groupId>org.springframework.boot</groupId>
7 <artifactId>spring-boot-starter-parent</artifactId>
8 <version>2.1.7.RELEASE</version>
9 <relativePath/> <!-- lookup parent from repository -->
10 </parent>
11 <groupId>com.hys</groupId>
12 <artifactId>hello-service</artifactId>
13 <version>0.0.1-SNAPSHOT</version>
14 <name>hello-service</name>
15 <description>Demo project for Spring Cloud</description>
16
17 <properties>
18 <java.version>1.8</java.version>
19 <spring-boot-admin.version>2.1.6</spring-boot-admin.version>
20 <spring-cloud.version>Greenwich.SR2</spring-cloud.version>
21 </properties>
22
23 <dependencies>
24 <dependency>
25 <groupId>org.springframework.boot</groupId>
26 <artifactId>spring-boot-starter-web</artifactId>
27 </dependency>
28 <dependency>
29 <groupId>org.springframework.cloud</groupId>
30 <artifactId>spring-cloud-starter-sleuth</artifactId>
31 </dependency>
32 <dependency>
33 <groupId>org.springframework.cloud</groupId>
34 <artifactId>spring-cloud-starter-zipkin</artifactId>
35 </dependency>
36 <dependency>
37 <groupId>org.springframework.cloud</groupId>
38 <artifactId>spring-cloud-starter</artifactId>
39 </dependency>
40 <dependency>
41 <groupId>org.springframework.cloud</groupId>
42 <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
43 </dependency>
44 <dependency>
45 <groupId>de.codecentric</groupId>
46 <artifactId>spring-boot-admin-starter-client</artifactId>
47 </dependency>
48 <dependency>
49 <groupId>org.springframework.boot</groupId>
50 <artifactId>spring-boot-starter-test</artifactId>
51 <scope>test</scope>
52 </dependency>
53 </dependencies>
54
55 <dependencyManagement>
56 <dependencies>
57 <dependency>
58 <groupId>org.springframework.cloud</groupId>
59 <artifactId>spring-cloud-dependencies</artifactId>
60 <version>${spring-cloud.version}</version>
61 <type>pom</type>
62 <scope>import</scope>
63 </dependency>
64 <dependency>
65 <groupId>de.codecentric</groupId>
66 <artifactId>spring-boot-admin-dependencies</artifactId>
67 <version>${spring-boot-admin.version}</version>
68 <type>pom</type>
69 <scope>import</scope>
70 </dependency>
71 </dependencies>
72 </dependencyManagement>
73
74 <build>
75 <plugins>
76 <plugin>
77 <groupId>org.springframework.boot</groupId>
78 <artifactId>spring-boot-maven-plugin</artifactId>
79 </plugin>
80 </plugins>
81 </build>
82
83</project>
84
85
2.2 application.properties
配置文件继续沿用之前的代码,并且加上以下的配置:
1
2 1management.endpoints.web.exposure.include=*
2
和AdminServer端一样,暴露所有端口信息。
3 运行及结果
依次启动eureka-server、admin-server、hello-service和feign-consumer,启动成功后访问http://localhost:8080/,以此来查看Spring Boot Admin的UI监控界面,如下所示:
也能看到一些日志信息以及详细的运行数据: