micrometer-registry-prometheus 不采集 Oracle 连接池指标，因其仅提供计量门面，不自动探测驱动层状态；Oracle JDBC 驱动不暴露标准 JMX 或 Micrometer 钩子，需手动从 V$ 视图拉取并注册 Gauge/Counter。
为什么 micrometer-registry-prometheus 本身不采集 Oracle 连接池指标
micrometer 的核心设计是“门面”，它只提供统一的 meterregistry 接口和基础计量器（counter、gauge、timer 等），但**不会自动探测或绑定数据库驱动层的内部状态**。oracle 官方 jdbc 驱动（ojdbc8）不暴露标准 jmx mbean 或 micrometer 可识别的钩子；hikaricp、tomcat jdbc 等连接池虽有 jmx 支持，但默认不向 micrometer 注册 oracle 相关的细粒度指标（如 active connections per schema、sql parse time、buffer gets 等）。
必须手动注册 Oracle 特定指标的三个关键点
要获取 Oracle 级别指标，得绕过 Micrometer 自动配置，主动从 Oracle 动态性能视图（V$ 视图）或连接池内部状态中拉取数据，并用 Gauge 或 Counter 包装：
- 需要一个具备
SELECT ANY DICTIONARY权限的监控账号（不能用应用主账号），否则查V$SESSION、V$SQLAREA会报ORA-00942: table or view does not exist - 不能直接在
@PostConstruct里查V$视图——此时 DataSource 可能未完全初始化；应监听ContextRefreshedEvent或使用@Scheduled(fixedDelay = 30_000)延迟启动采集 - 每次查询
V$视图都是一次远程 round-trip，高频采集（如 WHERE ROWNUM 限制结果集
如何用 Gauge 暴露 V$SESSION 中活跃会话数
这是最常用也最安全的 Oracle 指标之一，只需一行 SQL，权限要求低：
@Configuration
public class OracleMetricsConfig {
@Bean
public MeterBinder oracleSessionGauge(DataSource dataSource, MeterRegistry registry) {
return meterRegistry -> {
Gauge.builder("oracle.sessions.active", () -> {
try (Connection conn = dataSource.getConnection();
PreparedStatement ps = conn.prepareStatement(
"SELECT COUNT(*) FROM V$SESSION WHERE STATUS = 'ACTIVE' AND TYPE = 'USER'")) {
try (ResultSet rs = ps.executeQuery()) {
return rs.next() ? rs.getLong(1) : 0L;
}
} catch (SQLException e) {
// 记录 warn，但不抛异常，避免中断指标注册
return 0L;
}
})
.description("Number of active user sessions in Oracle")
.baseUnit("sessions")
.register(registry);
};
}
}
注意：V$SESSION 是动态视图，结果不缓存，每次调用都实时查询；若应用使用多数据源，需为每个 DataSource 实例单独注册，且确保 meterRegistry 是 Spring Boot 自动配置的全局实例（即非 @Primary 冲突的自定义 bean）。
容易被忽略的坑：Oracle 字符集与指标标签冲突
当你尝试给指标加 tags（比如按 SCHEMA 分组）时，如果从 V$SESSION 中读取 USERNAME 并直接作为 tag value，可能触发 Micrometer 的非法字符校验失败（如用户名含 .、- 或空格），导致整个 Gauge 注册静默失败，且无日志提示。
正确做法是预处理 tag 值：
- 用
username.replaceAll("[^a-zA-Z0-9_]", "_")替换非法字符 - 限制长度 ≤63 字符（Prometheus 标签名长度上限）
- 避免空值：用
StringUtils.defaultString(username, "unknown")
更稳妥的方式是放弃动态 tag，改用静态维度（如 application、datasource.name），这些由 Spring Boot 自动注入，稳定可控。
