可观测性与稳定性 / 系统课时

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 中写入下面的完整配置:

yaml
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 所在目录执行:

bash
promtool check config prometheus.yml

预期输出:

text
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 更合适。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

scrape_configs 怎样定义监控目标

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通