第 5-2 课：使⽤ Spring Boot Actuator 监控应⽤

- 日理万妓 2023-06-29 02:29 7阅读 0赞

微服务的特点决定了功能模块的部署是分布式的，⼤部分功能模块都是运⾏在不同的机器上，彼此通过服务

调⽤进⾏交互，前后台的业务流会经过很多个微服务的处理和传递，出现异常如何快速定位便成为了⼀个问

题，在这种框架下微服务的监控显得尤为重要。

Spring Boot  是⼀个⾃带监控的开源框架，组件  Spring Boot Actuator  负责监控应⽤的各项静态和动态的变

量。项⽬结合  Spring Boot Actuator  的使⽤，便可轻松对  Spring Boot  应⽤监控治理， Spring Boot  的

Actuator  提供了很多⽣产级的特性，⽐如监控和度量  Spring Boot  应⽤程序，这些特性可以通过众多  REST

接⼝、远程  Shell  和  JMX  获得。

### **Actuator** 监控 ###

Spring Boot  使⽤ “ 习惯优于配置的理念 ” ，采⽤包扫描和⾃动化配置的机制来加载依赖  jar  中的  Spring Bean ，

不需要任何  XML  配置，就可以实现  Spring  的所有配置。虽然这样做能让代码变得⾮常简洁，但是整个应⽤

的实例创建和依赖关系等信息都被离散到了各个配置类的注解上，这使得我们分析整个应⽤中资源和实例的

各种关系变得⾮常的困难。

只需要在项⽬中添加  spring-boot-starter-actuator ，就⾃动启⽤了监控功能。

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

添加  spring-boot-starter-web  主要是为了保持应⽤运⾏状态。

Spring Boot Actuator  是  Spring Boot  提供的对应⽤系统的检查和监控的集成功能，可以查看应⽤配置的详细

信息，例如⾃动化配置信息、创建的  Spring beans  以及⼀些环境属性等。

### **Actuator** 的 **REST** 接⼝  ###

Actuator  监控分成两类：原⽣端点和⽤户⾃定义端点。⾃定义端点主要是指扩展性，⽤户可以根据⾃⼰的实

际应⽤，定义⼀些⽐较关⼼的指标，在运⾏期进⾏监控。

原⽣端点是在应⽤程序⾥提供众多  Web  接⼝，通过它们了解应⽤程序运⾏时的内部状况，原⽣端点⼜可以分

成三类：

*  应⽤配置类，可以查看应⽤在运⾏期的静态信息，例如⾃动配置信息、加载的 springbean 信息、yml ⽂ 件配置信息、环境信息、请求映射信息； 
 *  度量指标类，主要是运⾏期的动态信息，如堆栈、请求连、⼀些健康指标、metrics 信息等； 
 *  操作控制类，主要是指 shutdown，⽤户可以发送⼀个请求将应⽤的监控功能关闭。

Actuator  提供了  13  个接⼝，具体如下表所示。

<table style="margin-left:11.8pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:56.85pt;"> HTTP ⽅方法 </td> 
 <td style="vertical-align:top;width:101.7pt;"> &nbsp; 路路径 </td> 
 <td style="vertical-align:top;width:374.75pt;"> &nbsp; 描述 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:56.85pt;"> GET </td> 
 <td style="vertical-align:top;width:101.7pt;"> /auditevents </td> 
 <td style="vertical-align:top;width:374.75pt;"> 显示应⽤用暴暴露露的审计事件（如认证进⼊入、订单失败） </td> 
 </tr> 
 <tr> 
 <td style="width:56.85pt;"> GET </td> 
 <td style="width:101.7pt;"> /beans </td> 
 <td style="width:374.75pt;"> 描述应⽤用程序上下⽂文⾥里里全部的 Bean 以及它们的关系 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:56.85pt;"> &nbsp; GET </td> 
 <td style="vertical-align:top;width:101.7pt;"> &nbsp; /conditions </td> 
 <td style="vertical-align:top;width:374.75pt;"> 就是 1.0 的 /autoconfig，提供⼀一份⾃自动配置⽣生效的条件情况，记录哪些 ⾃自动配置条件通过了了，哪些没通过 </td> 
 </tr> 
 <tr> 
 <td style="width:56.85pt;"> GET </td> 
 <td style="width:101.7pt;"> /configprops </td> 
 <td style="width:374.75pt;"> 描述配置属性（包含默认值）如何注⼊入 Bean </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:56.85pt;"> GET </td> 
 <td style="vertical-align:top;width:101.7pt;"> /env </td> 
 <td style="vertical-align:top;width:374.75pt;"> 获取全部环境属性 </td> 
 </tr> 
 <tr> 
 <td style="width:56.85pt;"> GET </td> 
 <td style="width:101.7pt;"> /env/{name} </td> 
 <td style="width:374.75pt;"> 根据名称获取特定的环境属性值 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:56.85pt;"> GET </td> 
 <td style="vertical-align:top;width:101.7pt;"> /flyway </td> 
 <td style="vertical-align:top;width:374.75pt;"> 提供⼀一份 Flyway 数据库迁移信息 </td> 
 </tr> 
 <tr> 
 <td style="width:56.85pt;"> GET </td> 
 <td style="width:101.7pt;"> /liquidbase </td> 
 <td style="width:374.75pt;"> 显示 Liquibase 数据库迁移的纤细信息 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:56.85pt;"> GET </td> 
 <td style="vertical-align:top;width:101.7pt;"> /health </td> 
 <td style="vertical-align:top;width:374.75pt;"> 报告应⽤用程序的健康指标，这些值由 HealthIndicator 的实现类提供 </td> 
 </tr> 
 <tr> 
 <td style="width:56.85pt;"> GET </td> 
 <td style="width:101.7pt;"> /heapdump </td> 
 <td style="width:374.75pt;"> dump ⼀一份应⽤用的 JVM 堆信息 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:56.85pt;"> GET </td> 
 <td style="vertical-align:top;width:101.7pt;"> /httptrace </td> 
 <td style="vertical-align:top;width:374.75pt;"> 显示 HTTP ⾜足迹，最近 100 个 HTTP request/repsponse </td> 
 </tr> 
 <tr> 
 <td style="width:56.85pt;"> GET </td> 
 <td style="width:101.7pt;"> /info </td> 
 <td style="width:374.75pt;"> 获取应⽤用程序的定制信息，这些信息由 info 打头的属性提供 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:56.85pt;"> GET </td> 
 <td style="vertical-align:top;width:101.7pt;"> /logfile </td> 
 <td style="vertical-align:top;width:374.75pt;"> 返回 log file 中的内容（如果 logging.file 或者 logging.path 被设置） </td> 
 </tr> 
 <tr> 
 <td style="width:56.85pt;"> GET </td> 
 <td style="width:101.7pt;"> /loggers </td> 
 <td style="width:374.75pt;"> 显示和修改配置的 loggers </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:56.85pt;"> GET </td> 
 <td style="vertical-align:top;width:101.7pt;"> /metrics </td> 
 <td style="vertical-align:top;width:374.75pt;"> 报告各种应⽤用程序度量量信息，⽐比如内存⽤用量量和 HTTP 请求计数 </td> 
 </tr> 
 <tr> 
 <td style="width:56.85pt;"> GET </td> 
 <td style="width:101.7pt;"> /metrics/{name} </td> 
 <td style="width:374.75pt;"> 报告指定名称的应⽤用程序度量量值 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:56.85pt;"> GET </td> 
 <td style="vertical-align:top;width:101.7pt;"> /scheduledtasks </td> 
 <td style="vertical-align:top;width:374.75pt;"> 展示应⽤用中的定时任务信息 </td> 
 </tr> 
 <tr> 
 <td style="width:56.85pt;"> GET </td> 
 <td style="width:101.7pt;"> /sessions </td> 
 <td style="width:374.75pt;"> 如果我们使⽤用了了 Spring Session 展示应⽤用中的 HTTP Sessions 信息 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:56.85pt;"> POST </td> 
 <td style="vertical-align:top;width:101.7pt;"> /shutdown </td> 
 <td style="vertical-align:top;width:374.75pt;"> 关闭应⽤用程序，要求 endpoints.shutdown.enabled 设置为 true </td> 
 </tr> 
 <tr> 
 <td style="width:56.85pt;"> &nbsp; GET </td> 
 <td style="width:101.7pt;"> &nbsp; /mappings </td> 
 <td style="width:374.75pt;"> 描述全部的 URI 路路径，以及它们和控制器器（包含 Actuator 端点）的映射关系 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:56.85pt;"> GET </td> 
 <td style="vertical-align:top;width:101.7pt;"> /threaddump </td> 
 <td style="vertical-align:top;width:374.75pt;"> 获取线程活动的快照 </td> 
 </tr> 
 </tbody> 
</table>

### 命令详解 ###

在  Spring Boot 2.x  中为了安全期间， Actuator  只开放了两个端点  /actuator/health  和  /actuator/info ，可以在

配置⽂件中设置打开。

可以打开所有的监控点

management.endpoints.web.exposure.include=*

也可以选择打开部分：

management.endpoints.web.exposure.exclude=beans,trace

Actuator  默认所有的监控点路径都在  /actuator/\* ，当然如果有需要这个路径也⽀持定制。

management.endpoints.web.base-path=/manage

设置完重启后，再次访问地址就会变成  /manage/\* 。

Actuator  ⼏乎监控了应⽤涉及的⽅⽅⾯⾯，我们重点讲述⼀些经常在项⽬中常⽤的命令。

### **health**  ###

health  主要⽤来检查应⽤的运⾏状态，这是我们使⽤最⾼频的⼀个监控点，通常使⽤此接⼝提醒我们应⽤实

例的运⾏状态，以及应⽤不 “ 健康 ” 的原因，如数据库连接、磁盘空间不够等。

默认情况下  health  的状态是开放的，添加依赖后启动项⽬，访问： http://localhost:8080/actuator/health  即可

看到应⽤的状态。

{
     "status" : "UP"
    }

默认情况下，最终的  Spring Boot  应⽤的状态是由  HealthAggregator  汇总⽽成的，汇总的算法是：

*  设置状态码顺序为 setStatusOrder(Status.DOWN, Status.OUTOFSERVICE, Status.UP, Status.UNKNOWN); 
 *  过滤掉不能识别的状态码 
 *  如果⽆任何状态码，整个 Spring Boot 应⽤的状态是 UNKNOWN 
 *  将所有收集到的状态码按照 1 中的顺序排序 
 *  返回有序状态码序列中的第⼀个状态码，作为整个 Spring Boot 应⽤的状态

health  通过合并⼏个健康指数检查应⽤的健康情况。 Spring Boot Actuator  有⼏个预定义的健康指标⽐如

DataSourceHealthIndicator 、 DiskSpaceHealthIndicator 、 MongoHealthIndicator 、 RedisHealthIndicator

等，它使⽤这些健康指标作为健康检查的⼀部分。

举个例⼦，如果你的应⽤使⽤  Redis ， RedisHealthindicator  将被当作检查的⼀部分；如果使⽤  MongoDB ， GitChat

那么  MongoHealthIndicator  将被当作检查的⼀部分。

可以在配置⽂件中关闭特定的健康检查指标，⽐如关闭  Redis  的健康检查：

management.health.redise.enabled=false

默认所有的这些健康指标被当作健康检查的⼀部分。

### 详细的健康检查信息  ###

默认只是展示了简单的  UP  和  DOWN  状态，为了查询更详细的监控指标信息，可以在配置⽂件中添加以下

信息：

management.endpoint.health.show-details=always

重启后再次访问⽹址  http://localhost:8080/actuator/health ，返回信息如下：

"status": "UP",
     "diskSpace": {
     "status": "UP",
     "total": 209715195904,
     "free": 183253909504,
     "threshold": 10485760
     }
    }

可以看到  HealthEndPoint  给我们提供默认的监控结果，包含磁盘空间描述总磁盘空间，剩余的磁盘空间和最

⼩阈值。

其实看  Spring Boot-actuator  源码，会发现  HealthEndPoint  提供的信息不仅限于此，在

org.springframework.boot.actuate.health  包下会发现  ElasticsearchHealthIndicator 、

RedisHealthIndicator 、 RabbitHealthIndicator  等。

### **info** ###

info 是我们⾃⼰在配置⽂件中以 info 开头的配置信息，⽐如在示例项⽬中的配置是：

info.app.name=spring-boot-actuator
    info.app.version= 1.0.0
    info.app.test= test

启动示例项⽬，访问 http://localhost:8080/actuator/info 返回部分信息如下：

{
     "app": {
     "name": "spring-boot-actuator",
     "version": "1.0.0",
     "test":"test"
     }
    }

### **beans**  ###

根据示例就可以看出，展示了  bean  的别名、类型、是否单例、类的地址、依赖等信息。

启动示例项⽬，访问⽹址  http://localhost:8080/actuator/beans  返回部分信息如下：

[
     {
     "context": "application:8080:management",
     "parent": "application:8080",
     "beans": [
     {
     "bean": "embeddedServletContainerFactory",
     "aliases": [
     
     ],
     "scope": "singleton",
     "type": "org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedSe
    rvletContainerFactory",
     "resource": "null",
     "dependencies": [
     
     ]
     },
     {
     "bean": "endpointWebMvcChildContextConfiguration",
     "aliases": [
     
     ],
     "scope": "singleton",
     "type": "org.springframework.boot.actuate.autoconfigure.EndpointWebMvcChil
    dContextConfiguration$$EnhancerBySpringCGLIB$$a4a10f9d",
     "resource": "null",
     "dependencies": [
     
     ]
     }
     }
    ]

### **conditions**  ###

Spring Boot  的⾃动配置功能⾮常便利，但有时候也意味着出问题⽐较难找出具体的原因。使⽤  conditions  可

以在应⽤运⾏时查看代码了解某个配置在什么条件下⽣效，或者某个⾃动配置为什么没有⽣效。

启动示例项⽬，访问⽹址  http://localhost:8080/actuator/conditions  返回部分信息如下：

{
     "positiveMatches": {
     "DevToolsDataSourceAutoConfiguration": {
     "notMatched": [
     {
     "condition": "DevToolsDataSourceAutoConfiguration.DevToolsData
    SourceCondition", 
     "message": "DevTools DataSource Condition did not find a singl
    e DataSource bean"
     }
     ], 
     "matched": [ ]
     }, 
     "RemoteDevToolsAutoConfiguration": {
     "notMatched": [
     {
     "condition": "OnPropertyCondition", 
     "message": "@ConditionalOnProperty (spring.devtools.remote.sec
    ret) did not find property 'secret'"
     }
     ], 
     "matched": [
     {
     "condition": "OnClassCondition", 
     "message": "@ConditionalOnClass found required classes 'javax.
    servlet.Filter', 'org.springframework.http.server.ServerHttpRequest'; @Conditional
    OnMissingClass did not find unwanted class"
     }
     ]
     }
     }
    }

### **confifigprops**  ###

查看配置⽂件中设置的属性内容以及⼀些配置属性的默认值。

启动示例项⽬，访问⽹址  http://localhost:8080/actuator/confifigprops  返回部分信息如下：

{
     ...
     "environmentEndpoint": {
     "prefix": "endpoints.env",
     "properties": {
     "id": "env",
     "sensitive": true,
     "enabled": true
     }
     },
     "spring.http.multipart-org.springframework.boot.autoconfigure.web.MultipartPrope
    rties": {
     "prefix": "spring.http.multipart",
     "properties": {
     "maxRequestSize": "10MB",
     "fileSizeThreshold": "0",
     "location": null,
     "maxFileSize": "1MB",
     "enabled": true,
     "resolveLazily": false
     }
     },
     "infoEndpoint": {
     "prefix": "endpoints.info",
     "properties": {
     "id": "info",
     "sensitive": false,
     "enabled": true
     }
     }
     ...
    }

### **env**  ###

展示了系统环境变量的配置信息，包括使⽤的环境变量、 JVM  属性、命令⾏参数、项⽬使⽤的  jar  包等信

息。和  confifigprops  不同的是， confifigprops  关注于配置信息， env  关注运⾏环境信息。

启动示例项⽬，访问⽹址  http://localhost:8080/actuator/env  返回部分信息如下：

{
     "profiles": [
     
     ],
     "server.ports": {
     "local.management.port": 8088,
     "local.server.port": 8080
     },
     "servletContextInitParams": {
     
     },
     "systemProperties": {
     "com.sun.management.jmxremote.authenticate": "false",
     "java.runtime.name": "Java(TM) SE Runtime Environment",
     "spring.output.ansi.enabled": "always",
     "sun.boot.library.path": "C:\\Program Files\\Java\\jdk1.8.0_101\\jre\\bin",
     "java.vm.version": "25.101-b13",
     "java.vm.vendor": "Oracle Corporation",
     "java.vendor.url": "http://java.oracle.com/",
     "java.rmi.server.randomIDs": "true",
     "path.separator": ";",
     "java.vm.name": "Java HotSpot(TM) 64-Bit Server VM",
     "file.encoding.pkg": "sun.io",
     "user.country": "CN",
     "user.script": "",
     "sun.java.launcher": "SUN_STANDARD",
     "sun.os.patch.level": "",
     "PID": "5268",
     "com.sun.management.jmxremote.port": "60093",
     "java.vm.specification.name": "Java Virtual Machine Spe

为了避免敏感信息暴露到  /env  ⾥，所有名为  password 、 secret 、 key （或者名字中最后⼀段是这些）的属性

在  /env  ⾥都会加上 “\*” 。举个例⼦，如果有⼀个属性名字是  database.password ，那么它在  /env  中的显示效

果是这样的：

### **/env/\{name\}** ⽤法  ###

就是  env  的扩展可以获取指定配置信息，⽐如  http://localhost:8080/actuator/env/java.vm.version ，返回

\{"java.vm.version":"25.101-b13"\} 。

### **heapdump** ###

返回⼀个  GZip  压缩的  JVM  堆  dump 。

启动示例项⽬，访问⽹址  http://localhost:8080/actuator/heapdump  会⾃动⽣成⼀个  JVM  的堆⽂件

heapdump ，我们可以使⽤  JDK  ⾃带的  JVM  监控⼯具  VisualVM  打开此⽂件查看内存快照。类似如下图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0MjI3ODk2_size_16_color_FFFFFF_t_70][]

### **httptrace**  ###

该端点⽤来返回基本的  HTTP  跟踪信息。默认情况下，跟踪信息的存储采⽤

org.springframework.boot.actuate.trace.InMemoryTraceRepository  实现的内存⽅式，始终保留最近的  100

条请求记录。

启动示例项⽬，访问⽹址  http://localhost:8080/actuator/httptrace ，返回信息如下：

{
     "traces": [
     {
     "timestamp": "2018-11-21T12:42:25.333Z", 
     "principal": null, 
     "session": null, 
     "request": {
     "method": "GET", 
     "uri": "http://localhost:8080/actuator/heapdump", 
     "headers": {
     "cookie": [
     "Hm_lvt_0fb30c642c5f6453f17d881f529a1141=1513076406,151496
    1720,1515649377; Hm_lvt_6d8e8bb59814010152d98507a18ad229=1515247964,1515296008,151
    5672972,1516086283; UM_distinctid=1647364371ef6-003ab9d0469ea5-b7a103e-100200-1647
    364371f104; CNZZDATA1260945749=232252692-1513233181-%7C1537492730"
     ], 
     "accept-language": [
     "zh-CN,zh;q=0.9"
     ], 
    GitChat
     "upgrade-insecure-requests": [
     "1"
     ], 
     "host": [
     "localhost:8080"
     ], 
     "connection": [
     "keep-alive"
     ], 
     "accept-encoding": [
     "gzip, deflate, br"
     ], 
     "accept": [
     "text/html,application/xhtml+xml,application/xml;q=0.9,ima
    ge/webp,image/apng,*/*;q=0.8"
     ], 
     "user-agent": [
     "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537
    .36 (KHTML, like Gecko) Chrome/63.0.3239.84 Safari/537.36"
     ]
     }, 
     "remoteAddress": null
     }, 
     "response": {
     "status": 200, 
     "headers": {
     "Accept-Ranges": [
     "bytes"
     ], 
     "Content-Length": [
     "39454385"
     ], 
     "Date": [
     "Wed, 21 Nov 2018 12:42:25 GMT"
     ], 
     "Content-Type": [
     "application/octet-stream"
     ]
     }
     }, 
     "timeTaken": 1380
     }, 
     {
     ...
     }, 
     ...
     ]
    }

记录了请求的整个过程的详细信息。

### **metrics**  ###

最重要的监控内容之⼀，主要监控了  JVM  内容使⽤、 GC  情况、类加载信息等。

启动示例项⽬，访问⽹址  http://localhost:8080/actuator/metrics  返回部分信息如下：

{
     "mem": 337132,
     "mem.free": 183380,
     "processors": 4,
     "instance.uptime": 254552,
     "uptime": 259702,
     "systemload.average": -1.0,
     "heap.committed": 292864,
     "heap.init": 129024,
     "heap.used": 109483,
     "heap": 1827840,
     "nonheap.committed": 45248,
     "nonheap.init": 2496,
     "nonheap.used": 44269,
     "nonheap": 0,
     "threads.peak": 63,
     "threads.daemon": 43,
     "threads.totalStarted": 83,
     "threads": 46,
     "classes": 6357,
     "classes.loaded": 6357,
     "classes.unloaded": 0,
     "gc.ps_scavenge.count": 8,
     "gc.ps_scavenge.time": 99,
     "gc.ps_marksweep.count": 1,
     "gc.ps_marksweep.time": 43,
     "httpsessions.max": -1,
     "httpsessions.active": 0
    }

对  /metrics  接⼝提供的信息进⾏简单分类如下表：

<table style="margin-left:11.8pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:57.65pt;"> 分类 </td> 
 <td style="vertical-align:top;width:121.7pt;"> 前缀 </td> 
 <td style="vertical-align:top;width:353.95pt;"> 报告内容 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:57.65pt;"> &nbsp; 垃圾收集器器 </td> 
 <td style="vertical-align:top;width:121.7pt;"> &nbsp; gc.* </td> 
 <td style="vertical-align:top;width:353.95pt;"> 已经发⽣生过的垃圾收集次数，以及垃圾收集所耗费的时间，适⽤用于标记—清理理垃圾收集器器和并⾏行行垃圾收集器器（数据源⾃自java.lang.management.GarbageCollectorMXBean） </td> 
 </tr> 
 <tr> 
 <td style="width:57.65pt;"> &nbsp; 内存 </td> 
 <td style="width:121.7pt;"> &nbsp; mem.* </td> 
 <td style="width:353.95pt;"> 分配给应⽤用程序的内存数量量和空闲的内存数量量（数据源⾃自 java.lang. Runtime） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:57.65pt;"> 堆 </td> 
 <td style="vertical-align:top;width:121.7pt;"> heap.* </td> 
 <td style="vertical-align:top;width:353.95pt;"> 当前内存⽤用量量（数据源⾃自 java.lang.management.MemoryUsage） </td> 
 </tr> 
 <tr> 
 <td style="width:57.65pt;"> 类加载器器 </td> 
 <td style="width:121.7pt;"> &nbsp; classes.* </td> 
 <td style="width:353.95pt;"> JVM 类加载器器加载与卸载的类的数量量（数据源⾃自 java.lang. management.ClassLoadingMXBean） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:57.65pt;"> &nbsp; &nbsp; 系统 </td> 
 <td style="vertical-align:top;width:121.7pt;"> processors、instance.uptime、uptime、systemload.average </td> 
 <td style="vertical-align:top;width:353.95pt;"> &nbsp; 系统信息，如处理理器器数量量（数据源⾃自 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;java.lang.Runtime、运⾏行行时间 （数据源⾃自 &nbsp;&nbsp;&nbsp;java.lang.management.RuntimeMXBean）、平均负载 （数据源⾃自 java.lang.management.OperatingSystemMXBean） </td> 
 </tr> 
 <tr> 
 <td style="width:57.65pt;"> &nbsp; 线程池 </td> 
 <td style="width:121.7pt;"> &nbsp; thread.* </td> 
 <td style="width:353.95pt;"> 线程、守护线程的数量量，以及 JVM 启动后的线程数量量峰值（数据源 ⾃ 自 java.lang .management.ThreadMXBean） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:57.65pt;"> &nbsp; 数据源 </td> 
 <td style="vertical-align:top;width:121.7pt;"> &nbsp; datasource.* </td> 
 <td style="vertical-align:top;width:353.95pt;"> 数据源连接的数量量（源⾃自数据源的元数据，仅当 Spring &nbsp;应⽤用程序上下⽂文⾥里里存在 DataSource Bean 的时候才会有这个信息） </td> 
 </tr> 
 <tr> 
 <td style="width:57.65pt;"> &nbsp; Tomcat 会话 </td> 
 <td style="width:121.7pt;"> &nbsp; httpsessions.* </td> 
 <td style="width:353.95pt;"> Tomcat 的活跃会话数和最⼤大会话数（数据源⾃自嵌⼊入式 Tomcat 的Bean，仅在使⽤用嵌⼊入式 Tomcat 服务器器运⾏行行应⽤用程序时才有这个信息） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:57.65pt;"> &nbsp; HTTP </td> 
 <td style="vertical-align:top;width:121.7pt;"> counter.status._、gauge.response._ </td> 
 <td style="vertical-align:top;width:353.95pt;"> &nbsp; 多种应⽤用程序服务 HTTP 请求的度量量值与计数器器 </td> 
 </tr> 
 </tbody> 
</table>

解释说明

*  请注意，这⾥的⼀些度量值，⽐如数据源和 Tomcat 会话，仅在应⽤程序中运⾏特定组件时才有数据， 还可以注册⾃⼰的度量信息。 
 *  HTTP 的计数器和度量值需要做⼀点说明，counter.status 后的值是 HTTP 状态码，随后是所请求的路 径。举个例⼦，counter.status.200.metrics 表明 /metrics 端点返回 200(OK) 状态码的次数。 
 *  HTTP 的度量信息在结构上也差不多，却在报告另⼀类信息。它们全部以 gauge.response 开头，表明 这是 HTTP 响应的度量信息，前缀后是对应的路径，度量值是以毫秒为单位的时间，反映了最近处理该 路径请求的耗时。 
 *  这⾥还有⼏个特殊的值需要注意，root 路径指向的是根路径或/，star-star 代表了那些 Spring 认为是静 态资源的路径，包括图⽚、JavaScript 和样式表，其中还包含了那些找不到的资源，这就是为什么经常 会看到 counter.status.404.star-star，因为返回了 HTTP 404 (NOT FOUND) 状态的请求数。　　 
 *  /metrics 接⼝会返回所有的可⽤度量值，但你也可能只对某个值感兴趣。要获取单个值，请求时可以在GitChat URL 后加上对应的键名。例如，要查看空闲内存⼤⼩，可以向 /metrics/mem.free 发⼀个GET请求，⽐ 如访问⽹址 http://localhost:8080/actuator/metrics/mem.free，返回：\{"mem.free":178123\}。

### **shutdown** ###

开启接⼝优雅关闭  Spring Boot  应⽤，要使⽤这个功能⾸先需要在配置⽂件中开启：

management.endpoint.shutdown.enabled=true

配置完成之后，启动示例项⽬，使⽤  curl  模拟  post  请求访问  shutdown  接⼝。

shutdown  接⼝默认只⽀持  post  请求。

curl -X POST "http://localhost:8080/actuator/shutdown" 
    {
     "message": "Shutting down, bye..."
    }

此时会发现应⽤已经被关闭。

### **mappings**  ###

描述全部的  URI  路径，以及它们和控制器的映射关系。

启动示例项⽬，访问⽹址  http://localhost:8080/actuator/mappings  返回部分信息如下：

{
 "/**/favicon.ico": {
 "bean": "faviconHandlerMapping"
 },
 "{[/hello]}": {
 "bean": "requestMappingHandlerMapping",
 "method": "public java.lang.String com.neo.controller.HelloController.index()"
 },
 "{[/error]}": {
 "bean": "requestMappingHandlerMapping",
 "method": "public org.springframework.http.ResponseEntity<java.util.Map<java.l
 ang.String, java.lang.Object>> org.springframework.boot.autoconfigure.web.BasicErr
 orController.error(javax.servlet.http.HttpServletRequest)"
 }
 }

### **threaddump**  ###

/threaddump  接⼝会⽣成当前线程活动的快照，这个功能⾮常好，⽅便我们在⽇常定位问题的时候查看线程 GitChat

的情况，主要展示了线程名、线程  ID 、线程的状态、是否等待锁资源等信息。

启动示例项⽬，访问⽹址  http://localhost:8080/actuator/threaddump  返回部分信息如下：

{
     "threadName": "http-nio-8088-exec-6",
     "threadId": 49,
     "blockedTime": -1,
     "blockedCount": 0,
     "waitedTime": -1,
     "waitedCount": 2,
     "lockName": "java.util.concurrent.locks.AbstractQueuedSynchronizer$ConditionOb
    ject@1630a501",
     "lockOwnerId": -1,
     "lockOwnerName": null,
     "inNative": false,
     "suspended": false,
     "threadState": "WAITING",
     "stackTrace": [
     {
     "methodName": "park",
     "fileName": "Unsafe.java",
     "lineNumber": -2,
     "className": "sun.misc.Unsafe",
     "nativeMethod": true
     },
     ...
     {
     "methodName": "run",
     "fileName": "TaskThread.java",
     "lineNumber": 61,
     "className": "org.apache.tomcat.util.threads.TaskThread$WrappingRunnable",
     "nativeMethod": false
     }
     ...
     ],
     "lockInfo": {
     "className": "java.util.concurrent.locks.AbstractQueuedSynchronizer$Conditio
    nObject",
     "identityHashCode": 372286721
     }
     }
     ...
    ]

⽣产出现问题的时候，可以通过应⽤的线程快照来检测应⽤正在执⾏的任务。 GitChat

### 总结  ###

经过这节课实践我们发现  Spring Boot Actuator  作为  Spring Boot  ⾃带的监控组件⾮常强⼤，它可以监控和管

理  Spring Boot  应⽤，如健康检查、审计、统计和  HTTP  追踪等，所有的这些特性可以通过  JMX  或者  HTTP

endpoints  来获得。使⽤  Spring Boot Actuator  之后，可以让我们通过很简单的接⼝或者命令来查询应⽤的⼀

切运⾏状态，从⽽达到对应⽤的运⾏情况了如指掌。

[点击这⾥下载源码][Link 1]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0MjI3ODk2_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20200110102550704.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0MjI3ODk2,size_16,color_FFFFFF,t_70
[Link 1]: https://github.com/ityouknow/spring-boot-leaning/tree/gitbook_column2.0