前言

1. 一般JavaWeb应用都需要被管理以及监控，比如：查看应用所占的内存，还有查看应用的运行状态等等，这样做的目的就是对应用进行实时监控，避免应用出现问题了都无从查起。
2. 我们都知道SpringBoot最牛的地方就是快速整合第三方技术，让我们能够快速开发，避免一些繁琐的配置。所有在SpringBoot中，也集成了监控功能的插件，就是SpringBoot Actuator。

SpringBoot Actuator简介

1. Actuator是SpringBoot项目中一个非常强大一个功能，有助于对应用程序进行监视和管理，通过restful api请求来监管、审计、收集应用的运行情况。
2. Actuator的核心是端点Endpoint，它用来监视应用程序及交互，spring-boot-actuator中已经内置了非常多的Endpoint（health、info、beans、metrics、httptrace、shutdown等等），同时也允许我们自己扩展自己的Endpoints。
3. 每个Endpoint都可以启用和禁用。要远程访问Endpoint，还必须通过JMX或HTTP进行暴露，大部分应用选择HTTP，Endpoint 的ID默认映射到一个带/actuator前缀的URL。例如，health端点默认映射到/actuator/health。

Endpoint端点介绍

Actuator的核心就是Endpoint，每一个Endpoint都代表着监控某一项数据。

端点	描述
auditevents	获取当前应用暴露的审计事件信息
beans	获取应用中所有的 Spring Beans 的完整关系列表
caches	获取公开可以用的缓存
conditions	获取自动配置条件信息，记录哪些自动配置条件通过和没通过的原因
configprops	获取所有配置属性，包括默认配置，显示一个所有 @ConfigurationProperties 的整理列版本
env	获取所有环境变量
flyway	获取已应用的所有Flyway数据库迁移信息，需要一个或多个 Flyway Bean
liquibase	获取已应用的所有Liquibase数据库迁移。需要一个或多个 Liquibase Bean
health	获取应用程序健康指标（运行状况信息）
httptrace	获取HTTP跟踪信息（默认情况下，最近100个HTTP请求-响应交换）。需要 HttpTraceRepository Bean
info	获取应用程序信息
integrationgraph	显示 Spring Integration 图。需要依赖 spring-integration-core
loggers	显示和修改应用程序中日志的配置
logfile	返回日志文件的内容（如果已设置logging.file.name或logging.file.path属性）
metrics	获取系统度量指标信息
mappings	显示所有@RequestMapping路径的整理列表
scheduledtasks	显示应用程序中的计划任务
sessions	允许从Spring Session支持的会话存储中检索和删除用户会话。需要使用Spring Session的基于Servlet的Web应用程序
shutdown	关闭应用，要求endpoints.shutdown.enabled设置为true，默认为 false
threaddump	获取系统线程转储信息
heapdump	返回hprof堆转储文件
jolokia	通过HTTP公开JMX bean（当Jolokia在类路径上时，不适用于WebFlux）。需要依赖 jolokia-core
prometheus	以Prometheus服务器可以抓取的格式公开指标。需要依赖 micrometer-registry-prometheus

SpringBoot Actuator使用及配置

1. 上面介绍了Actuator以及Endpoint，接下来就开始使用它，只需要引入下面启动器依赖就可以使用Actuator了。

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-web</artifactId>
   </dependency>
   <!-- actuator -->
   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-actuator</artifactId>
   </dependency>
   

2. 在SpringBoot2.X中，Actuator 默认只开放 health 和 info 两个端点。我们先不做任何配置，直接启动SpringBoot项目，然后在浏览器输入：http://localhost:8080/actuator查看默认开放的端点，如下图所示：
   

   在这里插入图片描述

3. 我们可以看到端点的访问地址都是以/actuator为前缀，这是SpringBoot默认设置的地址，我们可以在配置文件中修改，如下配置：

   management:
     endpoints:
       web:
         base-path: /myActuator
   

   在这里插入图片描述

4. 恢复默认的访问路径，然后在浏览器上访问http://localhost:8080/actuator/health，如果出现UP表示应用程序正常运行。
   

   在这里插入图片描述

5. 接下来暴露所有的端点Endpoint，如下配置：

       management:
         endpoints:
           web:
             base-path: /actuator #配置端点访问前缀
             exposure:
               include: '*' #暴露所有端点
   

   在这里插入图片描述

6. 当然也可以禁用所有端点，如下配置：

   management:
     endpoints:
       web:
         base-path: /actuator #配置端点访问前缀
         exposure:
           include: '*' #暴露所有端点
       enabled-by-default: false #禁用所有端点
   

   在这里插入图片描述

7. 关闭所有端点之后，可以指定暴露某个端点，如下配置：

   management:
     endpoints:
       web:
         base-path: /actuator #配置端点访问前缀
         exposure:
           include: '*' #暴露所有端点
       enabled-by-default: false #禁用所有端点
     endpoint:
       info:
         enabled: true #上面关闭所有端点之后，又暴露指定的端点，这里暴露info端点
   

8. 还可以指定不暴露某个端点，下面首先暴露所有端点，然后又指定不暴露：info，beans，env这三个端点。

   management:
     endpoints:
       web:
         base-path: /actuator #配置端点访问前缀
         exposure:
           include: '*'  #暴露所有端点
           exclude: info,beans,env #在暴露所有端点的前提下，可以排除某个端点(不暴露)
   

详细介绍Endpoint

上面介绍了Actuator的使用，以及端点Endpoint的配置(暴露与不暴露)，接下来再详细介绍常用的Endpoint。

health

1. health主要用来检测应用的运行状况，是使用最多的一个监控点。
2. 监控软件通常使用该接口实时监测应用运行状况，在系统出现故障时把报警信息推送给相关人员，如磁盘空间使用情况、数据库和缓存等的一些健康指标。
3. 默认情况下health端点是开放的，访问http://127.0.0.1:8080/actuator/health即可看到应用运行状态。
4. 如果应用程序正常时，默认访问会显示：{"status":"UP"}。如果需要更详细的信息，需要配置如下内容：

   management:
     endpoint:
       health:
         show-details: always
   

   在这里插入图片描述

info

查看应用信息是否在配置文件中配置。如我们在项目中配置是：

info:
  app:
    name: SpringBoot Actuator
    version: v1.0.0
    description: this is a SpringBoot Actuator Project

在这里插入图片描述

env

1. 通过 env 可以获取到所有关于当前 SpringBoot 应用程序的运行环境信息，如：操作系统信息（systemProperties）、环境变量信息、JDK 版本及 ClassPath 信息、当前启用的配置文件（activeProfiles）、propertySources、应用程序配置信息（applicationConfig）等。
2. 可以通过http://127.0.0.1:8080/actuator/env/{name}，name表示想要查看的信息，可以独立显示。
   在这里插入图片描述

beans

1. beans显示应用程序启动之后，SpringIOC容器注册了哪些Bean。

2. 主要展示了 bean 的别名、类型、是否单例、类的地址、依赖等信息。

   
   在这里插入图片描述

总结

1. 上面几种是比较常用的Endpoint，其他的Endpoint可以点击链接进行查看。附上官方说明文档：
   https://docs.spring.io/spring-boot/docs/2.2.1.RELEASE/reference/html/production-ready-features.html
2. 此篇博客也为下面一篇博客打基础。
   SpringBoot2.X监控和管理神器：SpringBoot Admin
3. 本篇博客源代码