Question

15.2.1 引入依赖

在 Spring Boot 中使用监控，首先需要在 pom.xml 文件中引入所需的依赖 spring-boot-starter-actuator，具体代码如下：

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

15.2.2 添加配置

在 pom.xml 文件中引入 spring-boot-starter-actuator 依赖包之后，我们需要在 application.properties 文件中添加如下配置信息：

     ### 应用监控配置
     # 指定访问这些监控方法的端口
     # management.port
     # 指定地址，比如只能通过本机监控，可以设置 management.address = 127.0.0.1
     # management.address=127.0.0.1
     # 敏感信息访问限制
     # endpoints.bean.sensitive=false
     # 设置关闭安全限制
     management.security.enabled=false

management.port 用于指定访问这些监控方法的端口；management.address 用于指定地址，比如只能通过本机监控，可以设置 management.address = 127.0.0.1；endpoints.bean.sensitive 用于敏感信息访问限制。在表 15-1 中，鉴权为 false 的，表示不敏感，可以随意访问，否则就做了一些保护，不能随意访问。比如 beans 端点，我们可以设置 endpoints.bean.sensitive=false，这样就可以访问 beans 的所有信息。每一个端点都设置 sensitive=false 比较麻烦，因此也可以设置关闭安全限制：management. security.enabled=false。

15.2.3 测试

spring-boot-starter-actuator 依赖和配置都添加成功之后，重新启动 my-spring-boot 项目，项目启动成功之后，在浏览器中测试各个端点。比如在浏览器中输入 http:// localhost:8080/health，可以看到如图 15-1 所示的应用健康信息。

图 15-1 应用健康信息

在浏览器中输入 http://localhost:8080/metrics，可以看到如图 15-2 所示的各项指标信息。

图 15-2 指标信息

其他端点测试可以按照表 15-2 所示的访问路径依次访问测试。

表 15-2 端点访问路径

在浏览器中可以把返回的数据格式化成 json 格式，这是因为在 Google 浏览器中安装了 JsonView 插件，具体安装步骤如下：

步骤 01 在浏览器中输入链接：https://github.com/search?utf8=%E2%9C%93&q= jsonview，在弹出的页面中单击 gildas-lormeau/JSONView-for-Chorme，如图 15-3 所示。

图 15-3 JSONView-for-Chrome 界面

步骤 02 单击【Download Zip】，插件下载完成后，解压缩到相应目录（D:\Download\ JSONView-for-Chrome-master）。

步骤 03 在浏览器右上角单击【更多工具】→【扩展程序】→【加载已解压的扩展程序】，选择插件目录（D:\Download\JSONView-for-Chrome-master\WebContent）。

步骤 04 安装完成后，重新启动浏览器（快捷键：Ctrl+R）。

15.2.4 定制端点

除了 spring-boot-starter-actuator 提供的默认端点外，我们还可以定制端点，定制端点一般通过 endpoints+端点名+属性名来设置。比如，我们可以在配置文件 application.properties 中把端点名 health 修改为 myhealth，具体代码如下：

      endpoints.health.id=myhealth

配置添加完成之后，重新启动 my-spring-boot 项目，在浏览器中输入访问地址：http://localhost:8080/myhealth，一样可以获得应用健康相关的信息。如果我们想关闭端点 beans，可以在配置文件 application.properties 中添加如下代码：

       endpoints.beans.enabled=false

配置添加完成之后，重新启动 my-pring-boot 项目，在浏览器中输入访问地址：http://localhost:8080/beans，查询不到 bean 相关的信息，而是跳转到错误界面。还可以通过关闭所有的端点，再开启所需端点来实现我们的需求，具体代码如下：

     ### 关闭所有的端点
     endpoints.enabled=false
     ### 开启具体端点，如 beans
     endpoints.beans.enabled=true

配置添加完成之后，重新启动 my-spring-boot 项目，在浏览器中输入访问地址：http://localhost:8080/beans，可以查询到 bean 相关信息，而输入访问地址：http:// localhost:8080/health，查询不到应用健康相关的信息。除了 beans 端点外，输入其他端点的访问地址同样查询不到任何信息。

端点的访问路径默认在根路径下，如 http://localhost:8080/beans。我们可以配置修改端点访问的上下文路径，具体代码如下：

      ### 配置端点访问的上下文路径
      management.context-path=/manage

配置添加完成之后，重新启动 my-pring-boot 项目，在浏览器中输入访问地址：http://localhost:8080/manage/beans，可以查询到 bean 相关的信息。端点访问的端口默认是项目访问端口，我们还可以通过配置修改端点访问端口。具体代码如下：

      management.port=8081

配置添加完成之后，重新启动 my-pring-boot 项目，在浏览器中输入访问地址：http://localhost:8081/manage/beans，可以查询到 bean 相关的信息。