Prometheus Operator中ScrapeConfig配置参数问题解析

问题背景

在使用Prometheus Operator监控Kubernetes集群中的Rook Ceph存储系统时，一个常见需求是配置Prometheus抓取Ceph提供的指标数据。Rook Ceph默认通过MGR服务暴露指标端点，通常位于http://rook-ceph-mgr.rook-ceph:9283/metrics。

错误现象

当用户尝试通过ScrapeConfig资源配置Prometheus抓取这些指标时，可能会遇到"server returned HTTP status 404 Not Found"的错误。从表面看，这个端点确实存在且可以通过浏览器或wget直接访问，但在Prometheus的Targets页面却显示为DOWN状态。

问题根源分析

通过深入排查发现，问题的根本原因在于ScrapeConfig资源配置中的params字段使用不当。在原始配置中：

spec:
  metricsPath: /metrics
  params:
    module: [http]

这种配置会导致Prometheus在抓取指标时自动添加?module=http查询参数，而Rook Ceph的指标端点并不支持这个参数，因此返回404错误。

解决方案

正确的配置应该移除不必要的params字段，并显式指定scheme为HTTP：

spec:
  metricsPath: /metrics
  scheme: HTTP
  staticConfigs:
    - labels:
        job: rook-ceph
      targets: 
        - rook-ceph-mgr.rook-ceph:9283

技术细节

1. scheme字段：明确指定使用HTTP协议而非HTTPS
2. metricsPath：保持默认的/metrics路径
3. staticConfigs：直接指定目标端点，不添加额外参数

最佳实践建议

1. 在配置ScrapeConfig时，应避免添加不必要的参数
2. 对于内部服务端点，通常不需要HTTPS，可以显式指定HTTP
3. 调试时可以使用Prometheus的debug日志级别查看详细的抓取请求
4. 在Kubernetes环境中，确保服务发现和DNS解析正常工作

总结

这个案例展示了Prometheus Operator配置中的一个常见陷阱 - 自动添加的查询参数可能导致端点不可达。通过理解ScrapeConfig资源各字段的实际作用，可以避免这类问题。对于监控Rook Ceph这类存储系统，保持配置简洁明了是关键。