首页/云/可观测性速查/consul_sd:Consul 服务目录发现
Prometheus 与采集64 条

consul_sd:Consul 服务目录发现

consul_sd_configs 从 Consul 服务目录读取实例列表;适合已有 Consul 体系复用服务注册信息,减少重复维护目标清单。

可观测性速查云更新于 2026-10-12

配置示例(带健康过滤)

配置示例(带健康过滤)
scrape_configs:
  - job_name: 'consul-services'
    consul_sd_configs:
      - server: 'consul.example.com:8500'
        services: ['order-api', 'pay-api']
    relabel_configs:
      - source_labels: [__meta_consul_service]
        target_label: service
默认只发现通过健康检查的实例;需要自行过滤时可使用 __meta_consul_health 标签。

易错点

  • Consul 中注册的端口可能与指标端口不同,需要 relabel 改写 __address__ 端口
  • 跨机房部署时发现延迟与网络抖动会被放大,注意 consul server 的地理分布

数据来源与参考

  • Prometheus 文档 · consul_sd_config
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌