Kafka集群JMX客户端维度指标缺失问题排查求助

• 客户端标识配置验证
  确认左侧集群的测试客户端是否正确设置了client.id参数。Kafka Broker生成客户端维度指标的前提是客户端连接时传递有效的client.id，若未设置或为空，Broker仅会生成全局指标。对比左右集群客户端的启动命令/配置文件，确保client.id（如perf-user）的配置完全一致。

• Broker核心参数检查

  • 核对broker.client.metrics.enable参数：该参数控制Broker是否生成客户端维度的监控指标，默认值为true。若左侧集群被手动设置为false，则不会生成客户端细分指标，需确保左右集群该参数配置一致。
  • 检查认证相关配置：针对MTLS/OAuth客户端，确认左侧集群Broker是否正确配置了身份提取规则。比如MTLS场景下，需确保ssl.client.auth=required，且principal.builder.class设置为org.apache.kafka.common.security.auth.SslPrincipalBuilder，保证Broker能从客户端证书中提取CN作为身份标识；OAuth场景下需确认Broker能正确解析客户端传递的用户身份，只有Broker识别到客户端身份，才会生成对应维度的指标。

• JMX Exporter过滤规则排查
  检查左侧集群的JMX Exporter配置文件（如jmx_exporter.yaml），确认是否存在过滤规则排除了客户端维度的指标。比如是否配置了drop规则过滤包含client-id或具体客户端标识的指标，对比左右集群的JMX Exporter配置，确保规则完全一致。

• Kafka版本一致性验证
  确认两个集群的Kafka版本是否相同。部分客户端维度的监控指标是在特定版本后引入的（如客户端级别的节流时间指标在Kafka 2.0+版本才支持），若左侧集群版本过低，可能不支持这些细分指标。

• Broker日志分析
  查看左侧集群Broker的日志，搜索client.id、principal相关条目，确认客户端连接时Broker是否成功识别到客户端标识或身份。比如搜索Connection from client.*with client-id或Authenticated with principal等日志，若左侧集群无此类记录，说明Broker未正确识别客户端，导致无法生成对应维度的指标。

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