Debezium Oracle Connector字符串类型JMX指标无法采集至Prometheus

核心原因 #

Prometheus仅支持数值类型（int64、float64）的指标，默认情况下JMX Exporter会忽略string类型的MBean属性，这就是currentScn、committedScn这类string格式的SCN指标无法出现在Prometheus中的直接原因。

解决方案 #

1. 修改JMX Exporter配置，添加string指标转数值规则

在JMX Exporter的配置文件中，针对Debezium的SCN相关MBean属性，添加正则匹配和数值转换规则，把string类型的SCN转为long型数值。

示例配置片段：

rules:
  - pattern: 'debezium\.connector\.oracle:type=connector-metrics,context=stream,server=(\w+),name=(\w+)'
    name: debezium_oracle_stream_$2
    labels:
      server: "$1"
    type: GAUGE
    value: 'parseLong($0)' # 将string格式的SCN转换为long数值

说明：

• pattern：需匹配你实际环境中Debezium Oracle流指标的MBean名称（可从JConsole复制完整路径后调整正则）
• value: 'parseLong($0)'：利用JMX Exporter内置函数将string类型的SCN值转为Prometheus可识别的数值类型

2. 验证配置并重启Kafka Connect

• 将修改后的配置文件替换到Kafka Connect的JMX Exporter配置路径（如kafka-connect/jmx-exporter/config.yml）
• 重启Kafka Connect节点生效配置
• 访问Connect的JMX Exporter metrics端点（默认http://<connect-host>:9999/metrics），检查是否能看到debezium_oracle_stream_currentScn、debezium_oracle_stream_committedScn这类指标

3. 优化白名单匹配（可选）

如果之前的白名单匹配范围过宽，可精准指定包含SCN指标的MBean：

whitelistObjectNames: ["debezium.connector.oracle:type=connector-metrics,context=stream,*"]

额外注意事项 #

• Oracle SCN本质是64位整数，用parseLong转换不会丢失精度
• 若你的MBean命名格式不同，需调整pattern中的正则表达式以精准匹配目标属性
• 重启后查看Connect集群日志，确认JMX Exporter无报错、指标采集正常

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