多租户多数据源Spring Boot应用：如何用Micrometer导出HikariCP指标到Prometheus？

问题原因 #

你当前仅能导出主数据源的HikariCP指标，是因为Micrometer的HikariMetricsBinder默认只会自动绑定Spring上下文里直接注册的DataSource Bean——也就是你定义的MultitenantDataSourceRouter，但它是路由数据源而非HikariDataSource实例。而你dataSources集合中的其他租户数据源并未被自动注册到指标体系中。

解决方案步骤 #

1. 确保所有数据源都是HikariDataSource实例 #

初始化租户数据源时，明确创建HikariDataSource对象并配置参数，避免使用包装类或其他DataSource实现。示例代码：

private final Map<Object, Object> dataSources = new LinkedHashMap<>();

// 初始化所有数据源（主数据源+租户数据源）
@PostConstruct
public void initDataSources() {
    // 示例：加载租户配置（实际可从数据库/配置中心读取）
    Map<String, Map<String, String>> tenantDbConfigs = loadTenantDatabaseConfigs();
    
    // 初始化主数据源
    HikariDataSource mainDs = new HikariDataSource();
    mainDs.setJdbcUrl("jdbc:mysql://main-db:3306/main_db");
    mainDs.setUsername("main_user");
    mainDs.setPassword("main_pass");
    mainDs.setDriverClassName(com.mysql.cj.jdbc.Driver.class.getName());
    mainDs.setMaximumPoolSize(15);
    dataSources.put("main-datasource", mainDs);
    
    // 初始化租户数据源
    for (Map.Entry<String, Map<String, String>> entry : tenantDbConfigs.entrySet()) {
        String tenantId = entry.getKey();
        Map<String, String> dbConfig = entry.getValue();
        
        HikariDataSource tenantDs = new HikariDataSource();
        tenantDs.setJdbcUrl(dbConfig.get("jdbcUrl"));
        tenantDs.setUsername(dbConfig.get("username"));
        tenantDs.setPassword(dbConfig.get("password"));
        tenantDs.setDriverClassName(dbConfig.get("driverClassName"));
        tenantDs.setMaximumPoolSize(10);
        
        dataSources.put(tenantId, tenantDs);
    }
}

2. 手动绑定所有HikariDataSource到Micrometer MeterRegistry #

创建一个Bean，遍历所有dataSources中的HikariDataSource实例，使用HikariMetricsBinder将它们绑定到MeterRegistry，并通过标签区分不同数据源（租户ID/数据源名称）：

import io.micrometer.core.instrument.MeterRegistry;
import io.micrometer.core.instrument.binder.jdbc.HikariMetricsBinder;
import io.micrometer.core.instrument.Tags;
import org.springframework.context.annotation.Bean;
import org.springframework.stereotype.Component;

import java.util.ArrayList;
import java.util.List;

@Component
public class HikariMetricsRegistrar {

    private final Map<Object, Object> dataSources;

    public HikariMetricsRegistrar(Map<Object, Object> dataSources) {
        this.dataSources = dataSources;
    }

    @Bean
    public List<HikariMetricsBinder> bindHikariMetrics(MeterRegistry meterRegistry) {
        List<HikariMetricsBinder> binders = new ArrayList<>();
        
        for (Map.Entry<Object, Object> entry : dataSources.entrySet()) {
            Object dataSourceKey = entry.getKey();
            Object dataSource = entry.getValue();
            
            if (dataSource instanceof HikariDataSource hikariDs) {
                // 给指标添加data_source标签，区分不同数据源
                HikariMetricsBinder binder = new HikariMetricsBinder(
                    hikariDs, 
                    "hikaricp", 
                    Tags.of("data_source", dataSourceKey.toString())
                );
                binder.bindTo(meterRegistry);
                binders.add(binder);
            }
        }
        
        return binders;
    }
}

3. 确认Metrics配置开启 #

在application.yml中确保HikariCP指标处于启用状态（默认已启用，可显式配置确认）：

management:
  endpoint:
    health:
      show-details: always
  endpoints:
    web:
      exposure:
        include: health,info,metrics,prometheus
  metrics:
    enable:
      jvm: true
      hikari: true # 显式开启HikariCP指标
    export:
      prometheus:
        enabled: true
    distribution:
      sla:
        http:
          server:
            requests: 50ms,100ms,200ms,300ms,500ms,1s
    tags:
      application: my-app

验证效果 #

启动应用后，访问/actuator/prometheus端点，搜索hikaricp_前缀的指标，会看到每个数据源的指标都带有data_source标签，例如：

hikaricp_connections_active{application="my-app",data_source="tenant1",...} 2.0
hikaricp_connections_active{application="my-app",data_source="main-datasource",...} 1.0

内容的提问来源于stack exchange，提问作者lubrum