SpringBoot的监控(Actuator)功能用法详解_Java

官方文档：spring boot actuator: production-ready features

一、引入依赖

        <dependency>
            <groupid>org.springframework.boot</groupid>
            <artifactid>spring-boot-starter-actuator</artifactid>
        </dependency>

二、application.yml文件中开启监控

management:
  endpoints:
    enabled-by-default: true #暴露所有端点信息
    web:
      exposure:
        include: "*"  #以web方式暴露

三、具体使用

1. 查看可以监控哪些信息：

localhost:8080/actuator/

2. 根据1中查出来的结果，可以监控具体的信息，比如：

http://localhost:8080/actuator/health 【查看系统健康状态】
localhost:8080/actuator/beans 【查看系统中所有的bean组件】
localhost:8080/actuator/conditions 【查看系统中激活的组件，如下图】

localhost:8080/actuator/configprops 【查看系统中配置的属性，如下图】

localhost:8080/actuator/env 【查看系统环境变量】

localhost:8080/actuator/metrics/ 【查看系统可以监控哪些指标信息，即系统运行时指标】

根据上面查出来的指标，再具体查看每个指标的详细信息，比如如下图查看系统cpu利用率指标

localhost:8080/actuator/metrics/system.cpu.usage

四、具体细节使用

比如我现在直接想查看系统是否健康，可以直接发送

localhost:8080/actuator/health

这个请求，如下图是默认返回的信息，只显示一个汇总后的结果告诉我们当前服务是什么状态

但是我想的服务配置了很多东西，比如数据库，redis, mq等组件，我想知道它们每一个的健康状态，可以在配置文件中针对每个监控端点进行更详细的配置，如下：

如上配置好了以后，重新启动项目，再次查看 /actuator/health 端点，返回如下信息：

五、端点开启与禁用

1. 直接使用如下方式是默认开启所有监控端点，但是某些包含敏感信息的端点我们不想开启，而只想开启某些监控端点，该怎么办呢？

management:
  endpoints:
    enabled-by-default: true #暴露所有端点信息
    web:
      exposure:
        include: "*"  #以web方式暴露

把上面的配置改成如下方式，即单独针对每一个监控端点的开启与禁用进行控制

management:
  endpoints:
    enabled-by-default: false#关闭所有端点监控功能
    web:
      exposure:
        include: "*"  #以web方式暴露
  endpoint:
    health:
      show-details: always
      enabled: true
      
    info:
      enabled: true
    
    metrics:
      enabled: true

重启项目，再次查看监控端点信息，如下(只能看到我们想让你看到的监控信息)：

同样的，在jconsole里面，也是只能看到这些信息，如下图：

在dos命令行输入 jconsole就可以直接打开jconsole控制台

六、定制endpoint

说明：这里的定制端点是在springboot已有的端点中，添加我们自己定制的一些信息，并没有新增监控端点（新增监控端点，看第7节）

1. 定制 /actuator/health

比如在访问 http://localhost:8080/actuator/health 时，默认显示系统判断的那些组件的健康状态，如果我们自己想添加一个端点(组件)的健康状态，按照如下做法：

2. 定制 /actuator/info

直接使用 http://localhost:8080/actuator/info时，输入的信息为空，那么我们如果想在页面展示一些项目的基本信息，比如项目名称，项目的版本等信息该如何做呢，有如下三种办法：

（1）直接在配置文件中写死

如下图：

info:
  appname: boot-admin
  appversion: 1.0.0

（2）从pom文件中读取信息

采用（1）中的方法的缺点是我不想把项目的名称或者版本号写死，我想动态获取（比如从maven中动态获取当前项目的项目名称和版本，因为项目名称或者版本可能会变动）。那么此时页可以直接在配置文件（application.yml）中动态获取maven配置文件（pom.xml）中的一些基本信息，如下：

重启项目，访问 http://localhost:8080/actuator/info，结果如下图：

（3）代码实现

第二种方式可以获取项目的一些基本信息，并且不是写死的，而是从pom文件中自动获取的，但是某些信息只能通过发送请求时，在代码里面进行逻辑处理完成之后才能获取，所以就引入了第三种方式，即通过代码实现获取一些项目相关的信息，代码实现如下：

package com.shg.admin.acutuator.info;

import org.springframework.boot.actuate.info.info;
import org.springframework.boot.actuate.info.infocontributor;
import org.springframework.stereotype.component;

import java.util.collections;

@component
public class appinfoinfocontributor implements infocontributor {


    @override
    public void contribute(info.builder builder) {

        builder.withdetail("msg","你好")
                .withdetail("hello","shg")
                .withdetails(collections.singletonmap("world","666"));
    }
}

重启项目，访问 http://localhost:8080/actuator/info，结果如下图：