首页/云/可观测性速查/抓取任务(scrape_configs)基础写法
Prometheus 与采集64 条

抓取任务(scrape_configs)基础写法

每个抓取任务定义一个 job:目标列表、抓取路径、协议、参数与超时;job 名会成为 job 标签,是查询与聚合的基础维度。

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

带鉴权与自定义路径的任务

带鉴权与自定义路径的任务
scrape_configs:
  - job_name: app-metrics
    metrics_path: /actuator/prometheus
    scheme: http
    basic_auth:
      username: metrics
      password_file: /etc/prometheus/metrics.pw
    static_configs:
      - targets: ['10.0.1.21:8080', '10.0.1.22:8080']
        labels:
          env: prod
业务标签(env、team)统一写在 static_configs.labels 或 external_labels,避免散落各处。

易错点

  • metrics_path 写错的典型表现是 404 与 up=0,先在目标机上 curl 验证端点
  • 密码明文写在配置里有泄露风险,优先用 password_file 或密钥管理

数据来源与参考

  • Prometheus 文档 · scrape_config 配置项
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌