首页/云/可观测性速查/file_sd:用文件做服务发现
本包目录(282 条)
监控体系与方法40 条
Prometheus 与采集64 条
Grafana 与看板53 条日志平台52 条链路追踪23 条告警与响应50 条

file_sd:用文件做服务发现

file_sd_configs 从 JSON/YAML 文件读取目标列表并支持自动重载(默认 5 分钟检测变更);配合配置管理或脚本生成文件,适合无法动态发现的环境。

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

prometheus.yml 片段

prometheus.yml 片段
scrape_configs:
  - job_name: 'file-targets'
    file_sd_configs:
      - files:
          - /etc/prometheus/targets/*.json
        refresh_interval: 1m

targets/app.json 内容

targets/app.json 内容
[
  {
    "targets": ["10.0.1.21:8080", "10.0.1.22:8080"],
    "labels": {"env": "prod", "team": "order"}
  }
]
文件里可写多个目标组,每组可带独立标签;Prometheus 会监视文件变化并自动重载。

易错点

  • 文件格式错误会导致整份目标列表被拒绝,生成脚本应先做 JSON 校验
  • 多个 Prometheus 共享目录时注意刷新与权限一致,避免读到半写入的文件

数据来源与参考

  • Prometheus 文档 · file_sd_config
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌