Spring Boot Admin

发博词

spring boot admin为spring boot应用提供了整合的视图,应用的详情视图提供了应用本身及运行时环境(OS和JVM)运维比较关心的数据,应用的运行时信息,log输出,metrics统计,environment和logging level实时调整,thread线程运行时状态,trace,audit和Hystrix。
同时提供了turbine扩展插件,用于整合展示整个集群的熔断器信息。
在Journal模块,可以提供整个集群所有节点的状态变化历程。

使用要点

架构原理

spring boot admin+discovery server架构的原理是,spring boot admin通过内置的zuul连接discovery server,通过zuul与具体的节点通信。

健康检查

Spring Boot Admin_第1张图片
首页展示每个Instance的基本信息,最重要的状态信息是通过spring boot admin 内置的zuul调用各个Instance的健康检查接口实时更新的。

这里配置时需要注意,我们的Instance在使用actuator的时候,生产环境中是需要给其设置一个context-path的,那么如何让spring boot admin知道这个配置呢,
查看ServiceInstanceConverter的默认实现DefaultServiceInstanceConverter的子类EurekaServiceInstanceConverter#getHealthUrl方法的具体实现可知:

@Override
    protected URI getHealthUrl(ServiceInstance instance) {
        Assert.isInstanceOf(EurekaServiceInstance.class, instance,
                "serviceInstance must be of type EurekaServiceInstance");

        InstanceInfo instanceInfo = ((EurekaServiceInstance) instance).getInstanceInfo();
        String healthUrl = instanceInfo.getSecureHealthCheckUrl();
        if (StringUtils.isEmpty(healthUrl)) {
            healthUrl = instanceInfo.getHealthCheckUrl();
        }
        return URI.create(healthUrl);
    }

我们只需要给要被观察的Instance设置eureka.instance.secure-health-check-url或者eureka.instance.health-check-url即可

eureka: 
  instance:
    hostname: localhost
    server-hostname: localhost
    metadata-map:
      cluster: MAIN
      management.context-path: ${management.context-path}
    secure-health-check-url: http://localhost:8080/actuator/health
    health-check-url: http://localhost:8080/actuator/health

应用信息

Spring Boot Admin_第2张图片
Spring Boot Admin_第3张图片
前面提到,应用的运行时信息,也就是actuator开放出来那些接口提供的信息,spring boot admin是通过zuul去调用的,与health接口调用时情况类似,如果被观察的Instance设置了management.context-path,那么如何让spring boot admin知道呢,答案是通过eureka.instance.metadata-map传递此信息。

eureka: 
  instance:
    hostname: localhost
    server-hostname: localhost
    metadata-map:
      cluster: MAIN
      management.context-path: ${management.context-path}

注意:
如果只设置这个地方,health那个接口是没法起作用的,具体参看EurekaServiceInstanceConverter#getHealthUrl方法的实现。

应用信息#日志

Spring Boot Admin_第4张图片

这里的日志读取的实际上是这个应用的logfile指定的文件,所以被观察的应用必须要指定logging.file的值。
其余的信息也是类似的。

Turbine

Spring Boot Admin_第5张图片

在使用turbine时,spring boot admin默认在集群中找serviceid为turbine的Instance,如果找不到就会报错,通过spring.boot.admin.turbine.location可以修改这个配置。
如果我们的turbine server注册到discovery server的时候serviceid不是turbine,那么久可以通过这个配置调整。

spring.boot.admin.turbine.clusters可以配置turbine的cluster的标识。

Journal

Spring Boot Admin_第6张图片

Basic认证

Instance通过metadata-map将自己的用户名和密码传递给spring boot admin。在BasicAuthHttpHeaderProvider中可以查看具体的实现细节。
配置如下:

eureka:
  instance:
    metadata-map:
      user.name: ${security.user.name}
      user.password: ${security.user.password}

你可能感兴趣的:(Spring,Cloud,Spring,Boot)