如何正确动态配置Prometheus scrape_config实现免重启生效

错误根因 #

你的配置存在三处结构/字段错误，直接导致Prometheus启动解析失败：

• 主配置prometheus.yml的scrape_configs层级错误：scrape_configs本身是采集作业配置数组，file_sd_configs是单个采集作业下的子配置项，不能直接挂在scrape_configs下平级编写。该写法相当于给数组类型字段传入了对象结构，就是报错中cannot unmarshal !!map into []*config.ScrapeConfig的直接原因。
• 主配置中file_sd字段名错误：指定动态加载文件路径的字段为files，不是names。
• 动态文件service_config.yml格式不符合规范：file_sd_configs加载的文件仅支持定义监控目标列表和关联自定义标签，job_name、采集间隔、指标路径这类作业级配置必须写在主配置文件中，不能放在动态加载文件里；同时你在targets前多余的短横线也破坏了YAML数组结构。

正确配置示例 #

1. 修正后主配置prometheus.yml #

global:
  scrape_interval: 5s
  evaluation_interval: 5s

alerting:
  alertmanagers:
    - static_configs:
        - targets:
          # - alertmanager:9093

rule_files:
  # - "first_rules.yml"
  # - "second_rules.yml"

scrape_configs:
  # 先定义采集作业基础配置，file_sd作为作业子项挂载
  - job_name: "webgateway"
    scrape_interval: 5s
    metrics_path: '/actuator/prometheus'
    file_sd_configs:
      - files:
          - './config/service_config.yml'
        # 动态文件刷新间隔，默认5分钟，可按需调快
        refresh_interval: 10s

2. 修正后动态配置service_config.yml #

# 仅保留目标列表和可选自定义标签即可
- targets: ["192.168.23.131:8004","192.168.24.201:8005","192.168.24.200:8005"]
  labels:
    service: webgateway
    env: prod

生效说明 #

• 第一次启动需要用修正后的配置正常启动Prometheus，后续修改service_config.yml里的targets、labels内容时，不需要重启进程，Prometheus会按照refresh_interval配置的间隔自动加载变更，自动完成监控目标的新增、下线操作。
• 后续新增其他采集作业时，直接在主配置scrape_configs数组中新增job块即可，每个job可以独立关联自己的file_sd文件。
• 编写YAML配置时注意严格对齐缩进，不要混用Tab和空格，避免触发解析错误。

内容的提问来源于stack exchange，提问作者william