在Spring Boot的众多Starter POMs中有一个特殊的模块，它不同于其他模块那样大多用于开发业务功能或是连接一些其他外部资源。它完全是一个用于暴露自身信息的模块，所以很明显，它的主要作用是用于监控与管理，它就是：spring-boot-starter-actuator。

spring-boot-starter-actuator模块的实现对于实施微服务的中小团队来说，可以有效地减少监控系统在采集应用指标时的开发量。当然，它也并不是万能的，有时候我们也需要对其做一些简单的扩展来帮助我们实现自身系统个性化的监控需求。下面，在本文中，我们将详解的介绍一些关于spring-boot-starter-actuator模块的内容，包括它的原生提供的端点以及一些常用的扩展和配置方式。

初识Actuator

下面，我们可以通过对快速入门中实现的Spring Boot应用增加spring-boot-starter-actuator模块功能，来对它有一个直观的认识。

在现有的Spring Boot应用中引入该模块非常简单，只需要在pom.xml的dependencies节点中，新增spring-boot-starter-actuator的依赖即可，具体如下：

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

通过增加该依赖之后，重新启动应用。此时，我们可以在控制台中看到如下图所示的输出：

上图显示了一批端点定义，这些端点并非我们自己在程序中创建，而是由spring-boot-starter-actuator模块根据应用依赖和配置自动创建出来的监控和管理端点。通过这些端点，我们可以实时的获取应用的各项监控指标，比如：访问/health端点，我们可以获得如下返回的应用健康信息：

{
 "status": "UP",
 "diskSpace": {
  "status": "UP",
  "total": 491270434816,
  "free": 383870214144,
  "threshold": 10485760
 }
}

原生端点

通过在快速入门示例中添加spring-boot-starter-actuator模块，我们已经对它有了一个初步的认识。接下来，我们详细介绍一下spring-boot-starter-actuator模块中已经实现的一些原生端点。如果根据端点的作用来说，我们可以原生端点分为三大类：

• 应用配置类：获取应用程序中加载的应用配置、环境变量、自动化配置报告等与Spring Boot应用密切相关的配置类信息。
  
• 度量指标类：获取应用程序运行过程中用于监控的度量指标，比如：内存信息、线程池信息、HTTP请求统计等。
  
• 操作控制类：提供了对应用的关闭等操作类功能。

下面我们来详细了解一下这三类端点都分别可以为我们提供怎么样的有用信息和强大功能，以及我们如何去扩展和配置它们。

应用配置类

由于Spring Boot为了改善传统Spring应用繁杂的配置内容，采用了包扫描和自动化配置的机制来加载原本集中于xml文件中的各项内容。虽然这样的做法，让我们的代码变得非常简洁，但是整个应用的实例创建和依赖关系等信息都被离散到了各个配置类的注解上，这使得我们分析整个应用中资源和实例的各种关系变得非常的困难。而这类端点就可以帮助我们轻松的获取一系列关于Spring 应用配置内容的详细报告，比如：自动化配置的报告、Bean创建的报告、环境属性的报告等。

• /autoconfig：该端点用来获取应用的自动化配置报告，其中包括所有自动化配置的候选项。同时还列出了每个候选项自动化配置的各个先决条件是否满足。所以，该端点可以帮助我们方便的找到一些自动化配置为什么没有生效的具体原因。该报告内容将自动化配置内容分为两部分：
• positiveMatches中返回的是条件匹配成功的自动化配置
  
• negativeMatches中返回的是条件匹配不成功的自动化配置

{
 "positiveMatches": { // 条件匹配成功的
  "EndpointWebMvcAutoConfiguration": [
   {
    "condition": "OnClassCondition",
    "message": "@ConditionalOnClass classes found: javax.servlet.Servlet,org.springframework.web.servlet.DispatcherServlet"
   },
   {
    "condition": "OnWebApplicationCondition",
    "message": "found web application StandardServletEnvironment"
   }
  ],
  ...
 },
 "negativeMatches": { // 条件不匹配成功的
  "HealthIndicatorAutoConfiguration.DataSourcesHealthIndicatorConfiguration": [
   {
    "condition": "OnClassCondition",
    "message": "required @ConditionalOnClass classes not found: org.springframework.jdbc.core.JdbcTemplate"
   }
  ],
  ...
 }
}

从如上示例中我们可以看到，每个自动化配置候选项中都有一系列的条件，比如上面没有成功匹配的HealthIndicatorAutoConfiguration.DataSourcesHealthIndicatorConfiguration配置，它的先决条件就是需要在工程中包含org.springframework.jdbc.core.JdbcTemplate类，由于我们没有引入相关的依赖，它就不会执行自动化配置内容。所以，当我们发现有一些期望的配置没有生效时，就可以通过该端点来查看没有生效的具体原因。

• /beans：该端点用来获取应用上下文中创建的所有Bean。

[
 {
  "context": "hello:dev:8881",
  "parent": null,
  "beans": [
   {
    "bean": "org.springframework.boot.autoconfigure.web.DispatcherServletAutoConfiguration$DispatcherServletConfiguration",
    "scope": "singleton",
    "type": "org.springframework.boot.autoconfigure.web.DispatcherServletAutoConfiguration$DispatcherServletConfiguration$$EnhancerBySpringCGLIB$$3440282b",
    "resource": "null",
    "dependencies": [
     "serverProperties",
     "spring.mvc.CONFIGURATION_PROPERTIES",
     "multipartConfigElement"
    ]
   },
   {
    "bean": "dispatcherServlet",
    "scope": "singleton",
    "type": "org.springframework.web.servlet.DispatcherServlet",
    "resource": "class path resource [org/springframework/boot/autoconfigure/web/DispatcherServletAutoConfiguration$DispatcherServletConfiguration.class]",
    "dependencies": []
   }
  ]
 }
]

如上示例中，我们可以看到在每个bean中都包含了下面这几个信息：

• bean：Bean的名称
  
• scope：Bean的作用域
  
• type：Bean的Java类型
  
• reource：class文件的具体路径
  
• dependencies：依赖的Bean名称
  

/configprops：该端点用来获取应用中配置的属性信息报告。从下面该端点返回示例的片段中，我们看到返回了关于该短信的配置信息，prefix属性代表了属性的配置前缀，properties代表了各个属性的名称和值。所以，我们可以通过该报告来看到各个属性的配置路径，比如我们要关闭该端点，就可以通过使用endpoints.configprops.enabled=false来完成设置。

{
 "configurationPropertiesReportEndpoint": {
  "prefix": "endpoints.configprops",
  "properties": {
   "id": "configprops",
   "sensitive": true,
   "enabled": true
  }
 },
 ...
}

/env：该端点与/configprops不同，它用来获取应用所有可用的环境属性报告。包括：环境变量、JVM属性、应用的配置配置、命令行中的参数。从下面该端点返回的示例片段中，我们可以看到它不仅返回了应用的配置属性，还返回了系统属性、环境变量等丰富的配置信息，其中也包括了应用还没有没有使用的配置。所以它可以帮助我们方便地看到当前应用可以加载的配置信息，并配合@ConfigurationProperties注解将它们引入到我们的应用程序中来进行使用。另外，为了配置属性的安全，对于一些类似密码等敏感信息，该端点都会进行隐私保护，但是我们需要让属性名中包含：password、secret、key这些关键词，这样该端点在返回它们的时候会使用*来替代实际的属性值。

{
 "profiles": [
  "dev"
 ],
 "server.ports": {
  "local.server.port": 8881
 },
 "servletContextInitParams": {
  
 },
 "systemProperties": {
  "idea.version": "2016.1.3",
  "java.runtime.name": "Java(TM) SE Runtime Environment",
  "sun.boot.library.path": "C:\\Program Files\\Java\\jdk1.8.0_91\\jre\\bin",
  "java.vm.version": "25.91-b15",
  "java.vm.vendor": "Oracle Corporation",
  ...
 },
 "systemEnvironment": {
  "configsetroot": "C:\\WINDOWS\\ConfigSetRoot",
  "RABBITMQ_BASE": "E:\\tools\\rabbitmq",
  ...
 },
 "applicationConfig: [classpath:/application-dev.properties]": {
  "server.port": "8881"
 },
 "applicationConfig: [classpath:/application.properties]": {
  "server.port": "8885",
  "spring.profiles.active": "dev",
  "info.app.name": "spring-boot-hello",
  "info.app.version": "v1.0.0",
  "spring.application.name": "hello"
 }
}

/mappings：该端点用来返回所有Spring MVC的控制器映射关系报告。从下面的示例片段中，我们可以看该报告的信息与我们在启用Spring MVC的Web应用时输出的日志信息类似，其中bean属性标识了该映射关系的请求处理器，method属性标识了该映射关系的具体处理类和处理函数。

{
 "/webjars/**": {
  "bean": "resourceHandlerMapping"
 },
 "/**": {
  "bean": "resourceHandlerMapping"
 },
 "/**/favicon.ico": {
  "bean": "faviconHandlerMapping"
 },
 "{[/hello]}": {
  "bean": "requestMappingHandlerMapping",
  "method": "public java.lang.String com.didispace.web.HelloController.index()"
 },
 "{[/mappings || /mappings.json],methods=[GET],produces=[application/json]}": {
  "bean": "endpointHandlerMapping",
  "method": "public java.lang.Object org.springframework.boot.actuate.endpoint.mvc.EndpointMvcAdapter.invoke()"
 },
 ...
}

/info：该端点用来返回一些应用自定义的信息。默认情况下，该端点只会返回一个空的json内容。我们可以在application.properties配置文件中通过info前缀来设置一些属性，比如下面这样：

info.app.name=spring-boot-hello
info.app.version=v1.0.0

再访问/info端点，我们可以得到下面的返回报告，其中就包含了上面我们在应用自定义的两个参数。

{
 "app": {
  "name": "spring-boot-hello",
  "version": "v1.0.0"
 }
}

度量指标类

上面我们所介绍的应用配置类端点所提供的信息报告在应用启动的时候都已经基本确定了其返回内容，可以说是一个静态报告。而度量指标类端点提供的报告内容则是动态变化的，这些端点提供了应用程序在运行过程中的一些快照信息，比如：内存使用情况、HTTP请求统计、外部资源指标等。这些端点对于我们构建微服务架构中的监控系统非常有帮助，由于Spring Boot应用自身实现了这些端点，所以我们可以很方便地利用它们来收集我们想要的信息，以制定出各种自动化策略。下面，我们就来分别看看这些强大的端点功能。

/metrics：该端点用来返回当前应用的各类重要度量指标，比如：内存信息、线程信息、垃圾回收信息等。

{
 "mem": 541305,
 "mem.free": 317864,
 "processors": 8,
 "instance.uptime": 33376471,
 "uptime": 33385352,
 "systemload.average": -1,
 "heap.committed": 476672,
 "heap.init": 262144,
 "heap.used": 158807,
 "heap": 3701248,
 "nonheap.committed": 65856,
 "nonheap.init": 2496,
 "nonheap.used": 64633,
 "nonheap": 0,
 "threads.peak": 22,
 "threads.daemon": 20,
 "threads.totalStarted": 26,
 "threads": 22,
 "classes": 7669,
 "classes.loaded": 7669,
 "classes.unloaded": 0,
 "gc.ps_scavenge.count": 7,
 "gc.ps_scavenge.time": 118,
 "gc.ps_marksweep.count": 2,
 "gc.ps_marksweep.time": 234,
 "httpsessions.max": -1,
 "httpsessions.active": 0,
 "gauge.response.beans": 55,
 "gauge.response.env": 10,
 "gauge.response.hello": 5,
 "gauge.response.metrics": 4,
 "gauge.response.configprops": 153,
 "gauge.response.star-star": 5,
 "counter.status.200.beans": 1,
 "counter.status.200.metrics": 3,
 "counter.status.200.configprops": 1,
 "counter.status.404.star-star": 2,
 "counter.status.200.hello": 11,
 "counter.status.200.env": 1
}

从上面的示例中，我们看到有这些重要的度量值：

• 系统信息：包括处理器数量processors、运行时间uptime和instance.uptime、系统平均负载systemload.average。
• mem.*：内存概要信息，包括分配给应用的总内存数量以及当前空闲的内存数量。这些信息来自java.lang.Runtime。
• heap.*：堆内存使用情况。这些信息来自java.lang.management.MemoryMXBean接口中getHeapMemoryUsage方法获取的java.lang.management.MemoryUsage。
• nonheap.*：非堆内存使用情况。这些信息来自java.lang.management.MemoryMXBean接口中getNonHeapMemoryUsage方法获取的java.lang.management.MemoryUsage。
• threads.*：线程使用情况，包括线程数、守护线程数（daemon）、线程峰值（peak）等，这些数据均来自java.lang.management.ThreadMXBean。
• classes.*：应用加载和卸载的类统计。这些数据均来自java.lang.management.ClassLoadingMXBean。
• gc.*：垃圾收集器的详细信息，包括垃圾回收次数gc.ps_scavenge.count、垃圾回收消耗时间gc.ps_scavenge.time、标记-清除算法的次数gc.ps_marksweep.count、标记-清除算法的消耗时间gc.ps_marksweep.time。这些数据均来自java.lang.management.GarbageCollectorMXBean。
• httpsessions.*：Tomcat容器的会话使用情况。包括最大会话数httpsessions.max和活跃会话数httpsessions.active。该度量指标信息仅在引入了嵌入式Tomcat作为应用容器的时候才会提供。
  
• gauge.*：HTTP请求的性能指标之一，它主要用来反映一个绝对数值。比如上面示例中的gauge.response.hello: 5，它表示上一次hello请求的延迟时间为5毫秒。
  
• counter.*：HTTP请求的性能指标之一，它主要作为计数器来使用，记录了增加量和减少量。如上示例中counter.status.200.hello: 11，它代表了hello请求返回200状态的次数为11。

对于gauge.*和counter.*的统计，这里有一个特殊的内容请求star-star，它代表了对静态资源的访问。这两类度量指标非常有用，我们不仅可以使用它默认的统计指标，还可以在程序中轻松的增加自定义统计值。只需要通过注入org.springframework.boot.actuate.metrics.CounterService和org.springframework.boot.actuate.metrics.GaugeService来实现自定义的统计指标信息。比如：我们可以像下面这样自定义实现对hello接口的访问次数统计。

@RestController
public class HelloController {
 @Autowired
 private CounterService counterService;
 @RequestMapping("/hello")
 public String greet() {
  counterService.increment("didispace.hello.count");
  return "";
 }
}

/metrics端点可以提供应用运行状态的完整度量指标报告，这项功能非常的实用，但是对于监控系统中的各项监控功能，它们的监控内容、数据收集频率都有所不同，如果我们每次都通过全量获取报告的方式来收集，略显粗暴。所以，我们还可以通过/metrics/{name}接口来更细粒度的获取度量信息，比如我们可以通过访问/metrics/mem.free来获取当前可用内存数量。

/health：该端点在一开始的示例中我们已经使用过了，它用来获取应用的各类健康指标信息。在spring-boot-starter-actuator模块中自带实现了一些常用资源的健康指标检测器。这些检测器都通过HealthIndicator接口实现，并且会根据依赖关系的引入实现自动化装配，比如用于检测磁盘的DiskSpaceHealthIndicator、检测DataSource连接是否可用的DataSourceHealthIndicator等。有时候，我们可能还会用到一些Spring Boot的Starter POMs中还没有封装的产品来进行开发，比如：当使用RocketMQ作为消息代理时，由于没有自动化配置的检测器，所以我们需要自己来实现一个用来采集健康信息的检测器。比如，我们可以在Spring Boot的应用中，为org.springframework.boot.actuate.health.HealthIndicator接口实现一个对RocketMQ的检测器类：

@Component
public class RocketMQHealthIndicator implements HealthIndicator {
 @Override
 public Health health() {
  int errorCode = check();
  if (errorCode != 0) {
   return Health.down().withDetail("Error Code", errorCode).build();
  }
  return Health.up().build();
 }
 private int check() {
  // 对监控对象的检测操作
 }
}

通过重写health()函数来实现健康检查，返回的Heath对象中，共有两项内容，一个是状态信息，除了该示例中的UP与DOWN之外，还有UNKNOWN和OUT_OF_SERVICE，可以根据需要来实现返回；还有一个详细信息，采用Map的方式存储，在这里通过withDetail函数，注入了一个Error Code信息，我们也可以填入一下其他信息，比如，检测对象的IP地址、端口等。重新启动应用，并访问/health接口，我们在返回的JSON字符串中，将会包含了如下信息：

"rocketMQ": {
 "status": "UP"
}

/dump：该端点用来暴露程序运行中的线程信息。它使用java.lang.management.ThreadMXBean的dumpAllThreads方法来返回所有含有同步信息的活动线程详情。

/trace：该端点用来返回基本的HTTP跟踪信息。默认情况下，跟踪信息的存储采用org.springframework.boot.actuate.trace.InMemoryTraceRepository实现的内存方式，始终保留最近的100条请求记录。它记录的内容格式如下：

[
 {
  "timestamp": 1482570022463,
  "info": {
   "method": "GET",
   "path": "/metrics/mem",
   "headers": {
    "request": {
     "host": "localhost:8881",
     "connection": "keep-alive",
     "cache-control": "no-cache",
     "user-agent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/53.0.2785.143 Safari/537.36",
     "postman-token": "9817ea4d-ad9d-b2fc-7685-9dff1a1bc193",
     "accept": "*/*",
     "accept-encoding": "gzip, deflate, sdch",
     "accept-language": "zh-CN,zh;q=0.8"
    },
    "response": {
     "X-Application-Context": "hello:dev:8881",
     "Content-Type": "application/json;charset=UTF-8",
     "Transfer-Encoding": "chunked",
     "Date": "Sat, 24 Dec 2016 09:00:22 GMT",
     "status": "200"
    }
   }
  }
 },
 ...
]

操作控制类

仔细的读者可能会发现，我们在“初识Actuator”时运行示例的控制台中输出的所有监控端点，已经在介绍应用配置类端点和度量指标类端点时都讲解完了。那么还有哪些是操作控制类端点呢？实际上，由于之前介绍的所有端点都是用来反映应用自身的属性或是运行中的状态，相对于操作控制类端点没有那么敏感，所以他们默认都是启用的。而操作控制类端点拥有更强大的控制能力，如果要使用它们的话，需要通过属性来配置开启。

在原生端点中，只提供了一个用来关闭应用的端点：/shutdown。我们可以通过如下配置开启它：

endpoints.shutdown.enabled=true

在配置了上述属性之后，只需要访问该应用的/shutdown端点就能实现关闭该应用的远程操作。由于开放关闭应用的操作本身是一件非常危险的事，所以真正在线上使用的时候，我们需要对其加入一定的保护机制，比如：定制Actuator的端点路径、整合Spring Security进行安全校验等。

以上所述是小编给大家介绍的Spring Boot Actuator监控端点小结，希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对网站的支持！

# spring  # boot  # actuator监控端点  # spring boot starter actuator（健康监控）配置和使用教程  # springboot 使用Spring Boot Actuator监控应用小结  # SpringBoot 监控管理模块actuator没有权限的问题解决方法  # 详解spring-boot actuator（监控）配置和使用  # spring boot actuator监控超详细教程  # 我们可以  # 关键词  # 自定义  # 来实现  # 应用程序  # 的是  # 都是  # 是一个  # 加载  # 监控系统  # 还没有  # 就可以  # 还可以  # 对其  # 可以看到  # 只需要  # 包含了  # 对它  # 中都  # 重新启动 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 微信小程序 wx.uploadFile无法上传解决办法  敲碗10年！Mac系列传将迎来「触控与联网」双革新  小视频制作网站有哪些,有什么看国内小视频的网站，求推荐？  Laravel如何构建RESTful API_Laravel标准化API接口开发指南  Laravel队列任务超时怎么办_Laravel Queue Timeout设置详解  Laravel如何实现API版本控制_Laravel版本化API设计方案  青岛网站建设如何选择本地服务器？  如何在建站之星绑定自定义域名？  Zeus浏览器网页版官网入口 宙斯浏览器官网在线通道  高防服务器租用首荐平台，企业级优惠套餐快速部署  Laravel如何集成Inertia.js与Vue/React？（安装配置）  东莞专业网站制作公司有哪些,东莞招聘网站哪个好？  Laravel如何使用.env文件管理环境变量？（最佳实践）  rsync同步时出现rsync: failed to set times on “xxxx”: Operation not permitted  如何在IIS管理器中快速创建并配置网站？  如何在万网利用已有域名快速建站？  新三国志曹操传主线渭水交兵攻略  如何在阿里云虚拟机上搭建网站？步骤解析与避坑指南  jimdo怎样用html5做选项卡_jimdo选项卡html5实现与切换效果【指南】  JS中使用new Date(str)创建时间对象不兼容firefox和ie的解决方法(两种)  如何自定义建站之星网站的导航菜单样式？  Laravel如何生成API文档？（Swagger/OpenAPI教程）  5种Android数据存储方式汇总  瓜子二手车官方网站在线入口 瓜子二手车网页版官网通道入口  Laravel如何保护应用免受CSRF攻击？（原理和示例）  EditPlus中的正则表达式 实战(4)  米侠浏览器网页图片不显示怎么办 米侠图片加载修复  Android中AutoCompleteTextView自动提示  Laravel怎么实现模型属性的自动加密  如何基于云服务器快速搭建网站及云盘系统？  微信h5制作网站有哪些,免费微信H5页面制作工具？  JS经典正则表达式笔试题汇总  高防服务器如何保障网站安全无虞？  北京的网站制作公司有哪些,哪个视频网站最好？  Laravel如何处理表单验证？（Requests代码示例）  如何在七牛云存储上搭建网站并设置自定义域名？  大学网站设计制作软件有哪些,如何将网站制作成自己app？  Windows11怎样设置电源计划_Windows11电源计划调整攻略【指南】  html5的keygen标签为什么废弃_替代方案说明【解答】  Python面向对象测试方法_mock解析【教程】  宙斯浏览器文件分类查看教程 快速筛选视频文档与图片方法  Laravel Docker环境搭建教程_Laravel Sail使用指南  Laravel如何使用查询构建器？（Query Builder高级用法）  如何在云指建站中生成FTP站点？  javascript和jQuery中的AJAX技术详解【包含AJAX各种跨域技术】  Laravel如何实现用户密码重置功能？（完整流程代码）  深圳网站制作设计招聘,关于服装设计的流行趋势，哪里的资料比较全面？  laravel怎么在请求结束后执行任务（Terminable Middleware）_laravel Terminable Middleware请求结束任务执行方法  jQuery中的100个技巧汇总  Laravel如何正确地在控制器和模型之间分配逻辑_Laravel代码职责分离与架构建议