ServiceMonitor

Tip

让 proemtheus 根据标签（Label）去自动发现并抓取这一组 Service 的监控指标

工作原理

---

1. 标签关联：业务 Pod 暴露 /metrics 端口，并且有一个 K8s Service 代理了这些 Pod。
2. 动态发现：ServiceMonitor 通过 spec.selector 匹配到这个 K8s Service。
3. 配置渲染：Prometheus Operator 监测到集群中多了一个 ServiceMonitor，并且它的标签满足 Prometheus 实例的 serviceMonitorSelector 要求。
4. 自动热重载：Operator 自动把这个 ServiceMonitor 翻译成 Prometheus 能够理解的 kubernetes_sd_configs（K8s 服务发现规则），写入 Prometheus 配置并触发 /-/reload 接口。监控立刻生效。

配置案例

---

被监控的业务 Service

apiVersion: v1
kind: Service
metadata:
  name: order-service
  namespace: dev-team-a
  labels:
    app: order-service-app # 1. 业务 Service 自身的标签
spec:
  ports:
  - name: metrics-port     # 2. 必须给监控端口起一个名字！
    port: 8080
    targetPort: 8080
  selector:
    app: order-service-pod

配套的 ServiceMonitor 配置文件

apiVersion: ://coreos.com
kind: ServiceMonitor
metadata:
  name: order-service-monitor
  namespace: dev-team-a # 通常和被监控的 Service 在同一个 Namespace
  labels:
    # 【避坑重点】这里的标签必须匹配 Prometheus CRD 中配置的 serviceMonitorSelector
    # 如果你用的是 kube-prometheus-stack，默认通常是下面这个标签：
    release: kube-prometheus-stack 
spec:
  # 1. 标签选择器：指定去寻找集群中具有哪些 Label 的 Service
  selector:
    matchLabels:
      app: order-service-app # 对应上面业务 Service 的 labels.app
 
  # 2. 命名空间选择器：指定去哪些 Namespace 下寻找上述 Service
  namespaceSelector:
    matchNames:
    - dev-team-a # 限制只在当前命名空间下寻找（也可以用 any: true 允许跨空间寻找）
 
  # 3. 抓取端点配置（可以配置多个）
  endpoints:
  - port: metrics-port      # 对应上面业务 Service 中定义的 ports[0].name
    path: /actuator/prometheus # 抓取的 HTTP 路径（如果不写，默认是 /metrics）
    interval: 15s           # 该服务特属的抓取频率（覆盖 Prometheus 全局的 30s）
    scrapeTimeout: 10s      # 抓取超时时间