Prometheus Operator无法识别其他Namespace的ServiceMonitor问题

问题根源 #

你当前的Prometheus资源配置中，serviceMonitorNamespaceSelector: {}的默认行为是仅监听Prometheus所在的monitoring Namespace的ServiceMonitor，所以其他Namespace的实例无法被识别。

解决步骤 #

1. 修改Prometheus资源配置，允许跨Namespace监听 #

编辑monitoring Namespace下的Prometheus资源：

kubectl edit prometheus k8s -n monitoring

根据需求选择以下两种配置方式：

方式一：监听所有Namespace的ServiceMonitor

将spec中的serviceMonitorNamespaceSelector修改为匹配所有Namespace的规则：

spec:
  # 其他配置保持不变
  serviceMonitorNamespaceSelector:
    matchLabels: {}  # 匹配所有带有任意标签（或无标签）的Namespace
  # 或者用更明确的规则：
  # serviceMonitorNamespaceSelector:
  #   matchExpressions:
  #   - key: kubernetes.io/metadata.name
  #     operator: Exists
  serviceMonitorSelector: {}  # 保持空即可匹配所有ServiceMonitor，如需过滤可添加标签规则

方式二：仅监听指定Namespace的ServiceMonitor

如果只需要监听other-namespace这类特定Namespace，先给目标Namespace打标签：

kubectl label namespace other-namespace monitor-target=enabled

然后修改Prometheus配置中的选择器：

spec:
  # 其他配置保持不变
  serviceMonitorNamespaceSelector:
    matchLabels:
      monitor-target: enabled
  serviceMonitorSelector: {}

2. 验证配置生效 #

保存修改后，Prometheus Operator会自动同步配置。等待1-2分钟后，访问Prometheus的/targets或/service-discovery页面，即可看到其他Namespace的ServiceMonitor被识别。

额外检查项 #

• 确认目标Namespace中的ServiceMonitor配置正确：selector能匹配到对应Service，endpoints的端口、路径配置无误
• 确认Prometheus的ServiceAccount（默认是prometheus-k8s）拥有访问目标Namespace资源的权限（kube-prometheus默认的ClusterRole已包含所需权限，无需额外配置）

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