17.3.3 基于服务注册中心的发现机制

基于服务注册中心的发现机制#

基于服务注册中心的发现机制通过对接注册中心（如 Consul、Nacos、Eureka、Zookeeper 等）的 API 动态获取服务实例与元数据，避免静态配置维护成本，适用于微服务规模大、实例频繁伸缩场景。Prometheus 内置多种发现模块，定期拉取实例列表，并将实例属性映射为标签，从而实现自动化目标管理与精准采集。

1. 原理草图与工作流程#

• 拉取周期：通过 refresh_interval 定期更新目标列表。
• 目标生成：实例地址、端口、服务名等转换为 __meta_* 标签。
• 标签重写：relabel_configs 映射为业务标签并过滤目标。
• 健康检查：依赖注册中心健康状态过滤不可用实例。

2. Consul 发现：安装、配置与验证#

2.1 安装 Consul（单机演示）

# 下载并解压
wget https://releases.hashicorp.com/consul/1.15.4/consul_1.15.4_linux_amd64.zip
unzip consul_1.15.4_linux_amd64.zip
sudo mv consul /usr/local/bin/

# 启动开发模式（仅演示）
consul agent -dev -client=0.0.0.0

# 验证
consul members
curl -s http://127.0.0.1:8500/v1/agent/self | jq '.Config.Datacenter'

2.2 注册服务（带健康检查与标签）

# /etc/consul.d/node-exporter.json
{
  "service": {
    "name": "node-exporter",
    "tags": ["env=dev","cluster=lab","role=infra"],
    "port": 9100,
    "check": {
      "http": "http://127.0.0.1:9100/metrics",
      "interval": "10s"
    }
  }
}

# 重新加载
consul reload

2.3 Prometheus SD 配置

# /etc/prometheus/prometheus.yml
scrape_configs:
  - job_name: "consul-node-exporter"
    consul_sd_configs:
      - server: "127.0.0.1:8500"
        datacenter: "dc1"
        refresh_interval: 15s
    relabel_configs:
      # 仅保留 node-exporter 服务
      - source_labels: [__meta_consul_service]
        regex: node-exporter
        action: keep
      # 将 Consul tag 映射为 env/cluster
      - source_labels: [__meta_consul_tags]
        regex: .*env=([^,]+).*
        target_label: env
      - source_labels: [__meta_consul_tags]
        regex: .*cluster=([^,]+).*
        target_label: cluster
      - source_labels: [__meta_consul_tags]
        regex: .*role=([^,]+).*
        target_label: role
      # 使用 Consul 实例地址
      - source_labels: [__meta_consul_address, __meta_consul_service_port]
        separator: ":"
        target_label: __address__

2.4 验证目标发现

# 访问 Prometheus 目标页面
curl -s http://127.0.0.1:9090/api/v1/targets | jq '.data.activeTargets[] | {discoveredLabels,labels,lastError}'

预期：job=consul-node-exporter 出现并且 env/cluster/role 标签存在，lastError 为空。

3. Nacos 发现：配置与示例#

3.1 Nacos 简要启动（单机）

# 假设已解压 nacos 并进入目录
./bin/startup.sh -m standalone

# 验证
curl -s "http://127.0.0.1:8848/nacos/v1/ns/service/list?pageNo=1&pageSize=10"

3.2 Prometheus 配置 Nacos SD（示例）

# /etc/prometheus/prometheus.yml
scrape_configs:
  - job_name: "nacos-app"
    nacos_sd_configs:
      - server: "127.0.0.1:8848"
        namespace: "public"
        group: "DEFAULT_GROUP"
        refresh_interval: 30s
    relabel_configs:
      - source_labels: [__meta_nacos_service]
        regex: app-service
        action: keep
      - source_labels: [__meta_nacos_namespace]
        target_label: namespace
      - source_labels: [__meta_nacos_cluster]
        target_label: cluster
      - source_labels: [__meta_nacos_instance_ip, __meta_nacos_instance_port]
        separator: ":"
        target_label: __address__
      - target_label: env
        replacement: dev

4. 关键标签设计与一致性规范（含示例）#

# 统一标签规范示例
# 采集指标后建议至少包含：
# job, instance, service, env, cluster, role
relabel_configs:
  - source_labels: [__meta_consul_service]
    target_label: service
  - source_labels: [__meta_consul_address, __meta_consul_service_port]
    separator: ":"
    target_label: instance
  - target_label: env
    replacement: dev

• 避免高基数：不要将 pod_id、request_id 等动态字段作为标签。
• 可复用：告警和仪表盘可稳定按 service/env/cluster 聚合。

5. 故障排查与常见问题（含命令）#

• 目标未出现

# 检查 Prometheus 配置语法
promtool check config /etc/prometheus/prometheus.yml

# 查看 Prometheus 日志
journalctl -u prometheus -n 200 --no-pager

• 发现但采集失败

# 直接访问目标 /metrics
curl -s http://<ip>:9100/metrics | head

# 检查防火墙与端口
ss -lntp | grep 9100

• 标签未生效

# 查看发现标签与重写结果
curl -s http://127.0.0.1:9090/api/v1/targets | jq '.data.activeTargets[] | {discoveredLabels,labels}'

• 注册中心不可用

# Consul 健康检查
curl -s http://127.0.0.1:8500/v1/status/leader
# Nacos 状态
curl -s http://127.0.0.1:8848/nacos/v1/ns/operator/servers

6. 练习与实操任务#

1. 新增服务并自动发现：在 Consul 注册一个 app-exporter，Prometheus 自动发现并采集。
2. 标签过滤：仅保留 env=prod 的实例并验证目标变化。
3. 告警联动：基于 service/env 编写告警规则，触发后检查标签是否准确。
4. 故障演练：停止 Exporter，观察 Prometheus up 指标变化并记录告警触发时间。

7. 关键命令与参数解释速查#

• refresh_interval：服务发现刷新周期，过小会加大注册中心压力。
• __meta_*：服务发现原始元数据标签。
• relabel_configs：标签重写与过滤的核心配置。
• __address__：Prometheus 实际抓取目标地址。