Spring Boot Admin 监控 HikariCP 数据库连接池指标配置步骤

Spring Boot Admin 可以监控数据库连接池指标。以下是具体说明和配置方法：

一、支持的连接池

Spring Boot Admin 可以监控多种连接池的指标：

• HikariCP（Spring Boot 默认）
• Tomcat JDBC Pool
• Commons DBCP2
• Oracle UCP

二、配置步骤

1.添加依赖（被监控应用）

确保已包含 Actuator 和对应的 JDBC 驱动：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-actuator</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-jdbc</artifactId><!-- 或 spring-boot-starter-data-jpa --></dependency>

2.暴露健康端点（被监控应用）

# application.ymlmanagement:endpoints:web:exposure:include:health,metrics,info,prometheusendpoint:health:show-details:alwaysmetrics:enabled:true

3.连接池特定配置

HikariCP（默认）

无需额外配置，指标自动通过/actuator/metrics暴露：

• hikaricp.connections.active
• hikaricp.connections.idle
• hikaricp.connections.pending
• hikaricp.connections.max
• hikaricp.connections.min

其他连接池

确保启用指标收集：

spring:datasource:hikari:# 对于 HikariCP，默认启用指标register-mbeans:true# 可选，用于 JMX 监控

三、Spring Boot Admin 中的展示

1.健康检查页面

在应用的详情页中，可以看到数据源的健康状态：

• 绿色：连接正常
• 红色：无法获取连接

2.指标图表

在Metrics标签页中，可以：

1. 搜索连接池相关指标（如hikaricp）
2. 创建可视化图表，监控：
   • 活跃连接数
   • 空闲连接数
   • 等待获取连接的线程数
   • 连接池大小

3.自定义仪表盘

可以在 SBA 中配置固定图表：

# Spring Boot Admin Server 配置spring:boot:admin:ui:public-url:http://localhost:8080

四、高级监控配置

1.自定义健康指示器

@ComponentpublicclassConnectionPoolHealthIndicatorimplementsHealthIndicator{@AutowiredprivateDataSourcedataSource;@OverridepublicHealthhealth(){// 自定义健康检查逻辑returnHealth.up().withDetail("connections",getConnectionCount()).build();}}

2.集成 Prometheus + Grafana

management:metrics:export:prometheus:enabled:trueendpoint:prometheus:enabled:true

3.JMX 监控（备选）

spring:datasource:hikari:register-mbeans:truemanagement:endpoints:jmx:exposure:include:"*"

五、常见指标示例

六、故障排查

如果看不到连接池指标：

1. 检查/actuator/metrics端点是否包含连接池指标
2. 确认连接池类型和配置
3. 确保management.endpoints.web.exposure.include包含metrics
4. 查看应用日志是否有相关错误

七、最佳实践

1. 设置合理的连接池参数

spring:datasource:hikari:maximum-pool-size:20minimum-idle:5connection-timeout:30000

2. 配置告警规则（在 SBA 或 Grafana 中）

   • 活跃连接持续接近最大值
   • 等待连接线程数 > 0 持续一段时间

3. 定期审查指标趋势

   • 高峰期的连接使用情况
   • 连接泄漏检测

Spring Boot Admin 对数据库连接池的监控是开箱即用的，只要正确配置了 Actuator 端点，就能在 Web 界面中方便地查看和分析连接池状态。