详解配置spring-boot-actuator时候遇到的一些小问题

下面我将详细讲解如何配置spring-boot-actuator时可能会遇到的一些小问题，包括监控端点的配置、安全性配置、接口映射等，同时附带两个示例。

监控端点的配置

spring-boot-actuator中默认提供了很多监控端点，包括/health、/info、/metrics等，可以通过application.properties或application.yml进行配置，具体配置方式如下：

配置application.properties

# 配置端点访问的前缀
management.endpoints.web.base-path=/actuator
# 配置允许访问的端点
management.endpoints.web.exposure.include=health,info,metrics,env
# 配置不允许访问的端点
management.endpoints.web.exposure.exclude=beans,auditevents,loggers

其中，management.endpoints.web.base-path配置了端点访问的前缀，默认为/actuator；management.endpoints.web.exposure.include配置可以被访问的端点，多个端点逗号隔开；management.endpoints.web.exposure.exclude配置不允许被访问的端点。

配置application.yml

management:
  endpoints:
    web:
      base-path: /actuator
    web:
      exposure:
        include: health,info,metrics,env
        exclude: beans,auditevents,loggers

安全性配置

spring-boot-actuator提供了很多安全性配置，包括用户认证、角色授权等，可以通过application.properties或application.yml进行配置，具体配置方式如下：

配置application.properties

# 配置用户认证，用户名为admin，密码为123456
spring.security.user.name=admin
spring.security.user.password=123456
# 配置角色授权，只允许管理员角色访问所有端点
management.endpoint.*.roles=admin

其中，spring.security.user.name和spring.security.user.password配置用户认证，可以配置多个用户；management.endpoint..roles配置角色授权，代表端点名称，可以配置多个端点。

配置application.yml

spring:
  security:
    user:
      name: admin
      password: 123456
management:
  endpoint:
    '*':
      roles: admin

接口映射

spring-boot-actuator中默认提供的监控端点的映射是/actuator/，可以通过application.properties或application.yml进行配置，具体配置方式如下：

配置application.properties

# 配置监控端点映射，将/actuator修改为/api
management.endpoints.web.base-path=/api

配置application.yml

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

配置完成后，监控端点的访问路径就会变成/api/。

这里我给出了两个示例：

示例一：配置health和info端点，将health端点映射到/api/monitor/health，将info端点映射到/api/monitor/info

配置application.properties

# 配置端点访问的前缀
management.endpoints.web.base-path=/api/monitor
# 配置允许访问的端点
management.endpoints.web.exposure.include=health,info
# 配置health的路径
management.endpoints.web.path-mapping.health=monitor/health
# 配置info的路径
management.endpoints.web.path-mapping.info=monitor/info

配置application.yml

management:
  endpoints:
    web:
      base-path: /api/monitor
      exposure:
        include: health,info
      path-mapping:
        health: monitor/health
        info: monitor/info

示例二：配置Metrics端点的JVM内存指标，只允许管理员角色访问Metrics端点，将Metrics端点映射到/api/metrics

配置application.properties

# 配置端点访问的前缀
management.endpoints.web.base-path=/api
# 配置metrics的路径
management.endpoints.web.path-mapping.metrics=metrics
# 配置角色授权，只允许管理员角色访问Metrics端点
management.endpoint.metrics.roles=admin

配置application.yml

management:
  endpoints:
    web:
      base-path: /api
      path-mapping:
        metrics: metrics
    endpoint:
      metrics:
        roles: admin

以上就是详解配置spring-boot-actuator时遇到的一些小问题的完整攻略，包括监控端点的配置、安全性配置、接口映射等，同时附带两个示例。