Spring Boot Admin 的使用详解
|
一、前言 Spring Boot Admin 用于监控基于 Spring Boot 的应用。官方文档在这里（v1.3.4）：《Spring Boot Admin Reference Guide》 实践的过程中，感觉这个 User Guide 结构上还是说的不太明白。所以我就大概写一遍我的实践过程与理解。 阅读此文前提条件是：
二、在 Spring Boot 项目中配置 这种配置中，Spring Boot Admin 作为 Server，其他 Spring Boot 应用作为 Client，Client 把自身的信息“注册”到 Server，我们就能在 Server 上看到“注册”的 Spring Boot 应用的状态信息了。 2.1、Server 端 新建一个项目 2.1.1、添加依赖 pom.xml <dependency> <groupId>de.codecentric</groupId> <artifactId>spring-boot-admin-server</artifactId> <version>1.3.4</version> </dependency> <dependency> <groupId>de.codecentric</groupId> <artifactId>spring-boot-admin-server-ui</artifactId> <version>1.3.4</version> </dependency> 2.1.2、开启监控 添加 @EnableAdminServer 注解开启监控
@Configuration
@EnableAutoConfiguration
@EnableAdminServer
public class SpringBootAdminApplication {
public static void main(String[] args) {
SpringApplication.run(SpringBootAdminApplication.class,args);
}
}
这里未指定 Server 运行的端口，默认是 8080，如果要指定，则需要在 application.properties 文件中设置： server.port=8080 2.2、Client 端 2.2.1、添加依赖 pom.xml <dependency> <groupId>de.codecentric</groupId> <artifactId>spring-boot-admin-starter-client</artifactId> <version>1.3.4</version> </dependency> 这里的 spring-boot-admin-starter-client 会自动依赖 jolokia-core，jolokia是用于 JMX-bean 管理的。 2.2.2、触发自动配置、指明 Server 注册地址 application.properties spring.boot.admin.url=http://localhost:8080 上面 3.1.2 中 Server 端我们使用默认的 8080 端口，所以这里声明 Server 的地址为：http://localhost:8080 2.3、开始管理 至此，启动 Server 端和 Client 端，在浏览器输入 Server 的地址：http://localhost:8080 就能看到“注册”进来的 Spring Boot 应用信息了。 2.4、显示应用版本 为了在 Spring Boot Admin 的应用管理列表显示被管理应用的版本号，你需要设置 info.version，例如使用 maven filtering： info.version=@project.version@ 这里设置显示的版本号为 Maven pom.xml 中的构建版本号。 2.5、JMX-bean管理 JMX-bean 管理需要使用第三方的 jolokia ，因为 spring-boot-admin-starter-client 会自动依赖 jolokia-core，所以这里不需要显示依赖了，第三节的基于 Eureka 注册发现的配置中，就需要显示地依赖： pom.xml <dependency> <groupId>org.jolokia</groupId> <artifactId>jolokia-core</artifactId> </dependency> 2.6、Loglevel 管理 当前日志级别管理仅限 Logback，通过 JMX 实现，所以需要依赖 jolokia 。同时，还需要配置 Logback 的 JMXConfigurator： <configuration> <include resource="org/springframework/boot/logging/logback/base.xml"/> <jmxConfigurator/> </configuration> 这个 logback.xml 放在与 application.properties 同级的目录就可以了，如果不配置 Logback，那么 Spring Boot Admin 就无法管理应用的日志级别。 2.7、Server 端监控自己 以上的配置，基本就可以很好工作了。 但是有一个问题，我们没有监控作为 Server 端的 Spring Boot Admin 自身。如果要监控到 Server 自己，把 Server 端也当作是 Client 一样来配置就可以实现了：把 2.2.1、2.2.2、2.4、2.6 的步骤在 Server 端也配置一遍。 三、在 Spring Cloud 项目的 Eureka 中配置 这里示例的 Spring Cloud 项目是使用 Eureka 来做注册/发现的，官方 Github 示例里有基于 Consul 和 Zookeper 的配置。 配置好之后，Spring Boot Admin 就可以管理所有注册到 Eureka Server 的应用了，包括 Spring Boot Admin 自己（因为自己也会注册到 Eureka Server）。 3.1、一个简单的 Eureka Server 关于 Eureka Server 这里不做详细介绍，只列一下配置经过： pom.xml <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-eureka-server</artifactId> </dependency> Eureka Server 启动类
@SpringBootApplication
@EnableEurekaServer
public class EurekaServerApplication {
public static void main(String[] args) {
SpringApplication.run(EurekaServerApplication.class,args);
}
}
application.properties spring.application.name=eureka-server server.port=8761 在 application.properties 同级目录下新建 bootstrap.properties 文件： bootstrap.properties
eureka.instance.hostname=localhost
eureka.client.registerWithEureka=false
eureka.client.fetchRegistry=false
eureka.client.serviceUrl.defaultZone=http://${eureka.instance.hostname}:${server.port}/eureka/
此文件作用与 application.properties 几乎样，只是但是作用在 application context 启动时期。原话是：like application.properties but for the bootstrap phase of an application context 。 以上配置表明，我们的 Eureka Server 运行在 8761 端口。服务注册地址是：http://localhost:8761/eureka/ 3.2、Server 端 官方示例：spring-boot-admin-sample-eureka 3.2.1、添加 spring-cloud-starter-eureka 依赖 pom.xml <dependency> <groupId>de.codecentric</groupId> <artifactId>spring-boot-admin-server</artifactId> <version>1.3.4</version> </dependency> <dependency> <groupId>de.codecentric</groupId> <artifactId>spring-boot-admin-server-ui</artifactId> <version>1.3.4</version> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-eureka</artifactId> </dependency> 3.2.2、添加 @EnableDiscoveryClient 开启发现
@Configuration
@EnableAutoConfiguration
@EnableDiscoveryClient
@EnableAdminServer
public class SpringBootAdminApplication {
public static void main(String[] args) {
SpringApplication.run(SpringBootAdminApplication.class,args);
}
}
3.2.3、指明去哪注册 application.properties eureka.instance.client.serviceUrl.defaultZone: http://localhost:8761/eureka/ 也就是我们在 3.1 中配置的 Eureka Server 服务地址。 这个配置我测试时并不成功，改为 eureka.client.serviceUrl.defaultZone: http://localhost:8761/eureka/ 才可以，不知为何。 3.2.4、官方未说明的 3.2.1 ~ 3.2.3 的配置，会把 Server 注册到 Eureka Server，也就是说 Spring Boot Admin 也可以管理自身，但现在的 Server 配置还不全面（比如自身还缺的配置有：版本信息、 JMX 管理和 Loglevel 管理）。加上以下配置： application.properties info.version=@project.version@ pom.xml <dependency> <groupId>org.jolokia</groupId> <artifactId>jolokia-core</artifactId> </dependency> logback.xml <configuration> <include resource="org/springframework/boot/logging/logback/base.xml"/> <jmxConfigurator/> </configuration> 3.3、Client 端 Client 端的配置主要是把自己注册到 Eureka Server 中就可以被 Spring Boot Admin 管理了，免去了手工配置 Spring Boot Admin 服务地址的操作（即 2.2.2 节操作）。 3.3.1、依赖 pom.xml <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-eureka</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency> 注意要添加 spring-boot-starter-actuator 依赖，因为获取应用信息是通过 actuator 中的相关 endpoints 获取的。 之所以 Server 端不需要添加此依赖，是因为 spring-boot-admin-server 依赖于 spring-boot-admin-starter-client ，而 spring-boot-admin-starter-client 依赖于 spring-boot-starter-actuator 。 （编辑：安卓应用网） 【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容! |