3. 服务发现机制：基于文件、Kubernetes 与 Consul

在 Prometheus 监控体系中，服务发现（Service Discovery, SD） 是控制平面通信的起点。Prometheus Server 通过服务发现动态获取目标（Target）的端点列表，替代了静态配置中逐个写入 targets 的方式。本章深入剖析三种主流服务发现机制：基于文件、基于 Kubernetes 和 基于 Consul，涵盖原理、配置、适用场景及故障排查要点。

3.1 基于文件的服务发现（File SD）

基于文件的服务发现是最简单、最通用的方式。Prometheus 定期扫描指定路径下的 YAML 或 JSON 文件，从中读取目标列表。文件可由外部系统（如 CMDB、脚本、配置管理工具）生成。

工作原理

• Prometheus 根据 file_sd_config 中定义的 files 路径模式（支持 glob）监控文件变更。
• 默认每 5 分钟 重新读取一次文件（可通过 refresh_interval 调整）。
• 文件内容必须包含 targets 列表和可选的 labels 映射。

配置示例

# prometheus.yml
scrape_configs:
  - job_name: 'node-exporter'
    file_sd_configs:
      - files:
          - '/etc/prometheus/targets/*.json'
        refresh_interval: 30s

目标文件示例（/etc/prometheus/targets/nodes.json）：

[
  {
    "targets": ["192.168.1.10:9100", "192.168.1.11:9100"],
    "labels": {
      "env": "production",
      "region": "us-east-1"
    }
  },
  {
    "targets": ["192.168.1.20:9100"],
    "labels": {
      "env": "staging",
      "region": "us-west-2"
    }
  }
]

适用场景与限制

3.2 基于 Kubernetes 的服务发现（K8s SD）

Kubernetes 服务发现是 Prometheus 在容器化环境中的核心能力。Prometheus 通过 Kubernetes API 实时监听 Pod、Service、Endpoint、Node 等资源的变更，自动生成抓取目标。

发现模式与角色

Prometheus 支持多种 Kubernetes 角色（role），每种角色对应不同的资源类型和标签注入方式：

配置示例（基于 Endpoints 发现）

scrape_configs:
  - job_name: 'kubernetes-pods'
    kubernetes_sd_configs:
      - role: endpoints
    relabel_configs:
      - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_scrape]
        action: keep
        regex: true
      - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_path]
        action: replace
        target_label: __metrics_path__
        regex: (.+)
      - source_labels: [__address__, __meta_kubernetes_pod_annotation_prometheus_io_port]
        action: replace
        regex: ([^:]+)(?::\d+)?;(\d+)
        replacement: $1:$2
        target_label: __address__

Kubernetes SD 通信流程（SVG）

3.3 基于 Consul 的服务发现（Consul SD）

Consul 是 HashiCorp 推出的服务网格与注册中心。Prometheus 通过 Consul HTTP API 查询健康服务实例，自动生成抓取目标。Consul SD 特别适合微服务架构中服务注册与监控的联动。

工作原理

• Prometheus 向 Consul Agent 的 /v1/catalog/services 和 /v1/health/service/<service_name> 发起查询。
• 默认只返回 通过健康检查 的服务实例（可通过 allow_stale 和 tag_separator 调整）。
• 每个服务实例的标签（如 dc、version）会自动注入为 Prometheus 标签。

配置示例

scrape_configs:
  - job_name: 'consul-services'
    consul_sd_configs:
      - server: 'localhost:8500'
        datacenter: 'dc1'
        services:
          - 'web'
          - 'api'
    relabel_configs:
      - source_labels: [__meta_consul_service]
        target_label: job
      - source_labels: [__meta_consul_node]
        target_label: instance
      - source_labels: [__meta_consul_tags]
        target_label: tags

Consul SD 与 K8s SD 对比

Consul SD 架构图（SVG）

3.4 三种服务发现机制对比总结