学习Spring Boot：（二十七）Spring Boot 2.0 中使用 Actuator_management.server.servlet.context-path

前言

本文的源码地址
主要是完成微服务的监控，完成监控治理。可以查看微服务间的数据处理和调用，当它们之间出现了异常，就可以快速定位到出现问题的地方。

• springboot - version: 2.0

正文

依赖

maven 项目 在 pom.xml 文件中加入 actuator 的依赖：

<dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-actuator</artifactId>
  </dependency>
1
2
3
4

使用 Gradle 构建：

dependencies {
	compile("org.springframework.boot:spring-boot-starter-actuator")
}
1
2
3

配置

需要注意的是 Spring Boot 2.0 相对于上个版本， Actuator 发生很多变化，

keys 的配置改变

基本路径

1. 所有 endpoints 默认情况下都已移至 /actuator。就是多了跟路径 actuator ；

2. 上个版本中的 management/context-path: 和 management/port: 改为 :

   management:
     server:
       port: 8004
       servlet:
         context-path: /xxx # 只有在设置了 management.server.port 时才有效 
   1
   2
   3
   4
   5

   另外，您还可以使用新的单独属性 management.endpoints.web.base-path 为管理端点设置基本路径。

   例如，如果你设置management.server.servlet.context-path=/management和management.endpoints.web.base-path=/application，你就可以在下面的路径到达终点健康：/management/application/health。

   如果你想恢复 1.x 的行为（即具有/health代替/actuator/health），设置以下属性：management.endpoints.web.base-path=/

ENDPOINTS

1.X 的时候属性：

2.0 部分更改：

默认端点 path 前面多了一级 /actuator 。

同时注意只有端点/health和/info端点是暴露的。

1. 您可以按如下方式公开所有端点：management.endpoints.web.exposure.include=*
2. 您可以通过以下方式显式启用/shutdown端点：management.endpoint.shutdown.enabled=true
3. 要公开所有（已启用）网络端点除env端点之外：

management.endpoints.web.exposure.include=*
management.endpoints.web.exposure.exclude=env
1
2

例如：

我现在开启所有的端点：

management:
  endpoints:
    web:
      exposure:
        include: "*" # * 在yaml 文件属于关键字
1
2
3
4
5

执行 localhost:${port}/actuator，可以看到所有可以执行查看的端点监控的 Url，然后我们尝试执行关闭应用进程的指令：shutdown：

端点格式

1. /actuator/mappings 端点大改变
   JSON 格式已经更改为现在正确地包含有关上下文层次结构，多个DispatcherServlets，部署的 Servlet 和 Servlet 过滤器的信息。详情请参阅＃9979。
   Actuator API 文档的相关部分提供了一个示例文档。

2. /actuator/httptrace 端点大改变
   响应的结构已经过改进，以反映端点关注跟踪 HTTP 请求 - 响应交换的情况。

总结

主要是 Spring Boot 2.0 版本升级在 Actuator 上面有许多改动，需要记录下。

参考文章

• Part V. Spring Boot Actuator: Production-ready features
• Spring Boot 2.0系列文章(一)：Spring Boot 2.0 迁移指南