可观测性与稳定性 / 系统课时
scrape_configs 怎样定义监控目标
scrape_configs 怎样定义监控目标
Prometheus 是否会采集某台服务器,主要由 prometheus.yml 中的 scrape_configs 决定。本篇用一个 Node Exporter 抓取任务说明怎样设置任务名称、目标地址和采集周期,并在加载配置前用 promtool 检查语法,避免因为 YAML 或字段错误导致配置无法生效。
学习目标
- 理解
job_name、scrape_interval、static_configs和targets的职责 - 编写一个包含多个静态目标的抓取任务
- 使用
promtool在加载配置前验证配置文件
scrape_configs 如何组织抓取任务
scrape_configs 是抓取任务列表。通常一个任务使用一个 job_name,其下再定义抓取参数和目标来源。对固定数量的服务器,最直接的方式是使用 static_configs 静态列出 host:port。
下面几个字段最常用:
| 字段 | 作用 |
|---|---|
job_name |
标识抓取任务,并默认成为采集时间序列的 job 标签 |
scrape_interval |
当前任务的抓取周期;省略时继承全局设置 |
scrape_timeout |
单次抓取允许等待的最长时间,不能大于抓取周期 |
metrics_path |
指标 HTTP 路径,默认是 /metrics |
static_configs |
定义静态目标组及其附加标签 |
targets |
需要抓取的目标地址,通常写成 主机:端口 |
配置两个 Node Exporter 目标
假设两台服务器已经运行 Node Exporter,并分别可以通过 10.0.0.11:9100 和 10.0.0.12:9100 访问。可以在 prometheus.yml 中写入下面的完整配置:
global:
scrape_interval: 15s
scrape_timeout: 10s
scrape_configs:
- job_name: "node"
scrape_interval: 30s
metrics_path: /metrics
static_configs:
- targets:
- "10.0.0.11:9100"
- "10.0.0.12:9100"
labels:
env: "prod"这里全局默认采集周期是 15 秒,但 node 任务单独设置了 scrape_interval: 30s,因此该任务会使用 30 秒周期。targets 中不需要写 http://;在没有额外指定 scheme 时,Prometheus 使用 HTTP,并访问默认或显式指定的 /metrics 路径。
labels 会为这个静态目标组采集到的时间序列增加 env="prod" 标签。以后查询多个环境的数据时,可以利用这个标签进行筛选。
加载前先检查配置
手工修改 YAML 最常见的问题是缩进错误、字段拼写错误或字段值不合法。Prometheus 自带的 promtool 可以在服务重新加载配置前执行检查。
在 prometheus.yml 所在目录执行:
promtool check config prometheus.yml预期输出:
Checking prometheus.yml
SUCCESS: prometheus.yml is valid prometheus config file syntax出现 SUCCESS 说明 Prometheus 能够解析这份配置。实际输出中的文件名会与传入的配置文件路径一致;如果使用其他 <PATH>,对应位置也会显示实际路径。
配置检查通过后,再让正在运行的 Prometheus 重新加载配置或重启进程。生效后,node 任务会按照 30 秒周期分别抓取两台服务器,而不是按照全局 15 秒周期执行。
配置正确不等于目标一定可抓取
promtool check config 主要验证配置能否被正确解析,它不会证明每个目标此刻都能成功返回指标。因此配置加载后还要确认目标是否实际可访问。
如果任务存在但目标抓取失败,优先检查目标地址和端口是否正确、Node Exporter 是否监听在 Prometheus 可访问的地址、网络策略或防火墙是否允许连接,以及 /metrics 是否能够正常返回指标。只有配置语法与实际网络链路都正确,目标才会稳定产生新的时间序列样本。
对固定实验环境或少量服务器,static_configs 足够直观;当实例数量频繁变化时,再考虑服务发现机制会比持续手工维护 targets 更合适。