4. 配置文件详解：global、alerting、rule_files、scrape_configs 四大核心配置块解析

Prometheus 的配置体系以 YAML 格式为核心，所有行为由单一配置文件（通常为 prometheus.yml）驱动。理解 global、alerting、rule_files、scrape_configs 这四大配置块，是掌握 Prometheus 控制面配置与调优的基础。本章将逐一解析每个配置块的结构、关键参数及最佳实践。

4.1 global 配置块：全局行为基准

global 块定义所有 Job 的默认行为，是配置文件的顶层入口。其参数可被单个 Job 的 scrape_config 覆盖。

# global 配置示例
global:
  scrape_interval:     15s      # 每 15 秒抓取一次
  scrape_timeout:      10s      # 抓取超时 10 秒
  evaluation_interval: 15s      # 每 15 秒评估一次规则
  external_labels:
    cluster: 'production'
    env:     'control-plane'

4.2 alerting 配置块：告警路由中枢

alerting 块定义 Prometheus 与 Alertmanager 的通信方式。它不定义告警规则，只定义告警通知的发送目标。

# alerting 配置示例
alerting:
  alertmanagers:
    - static_configs:
        - targets:
          - 'alertmanager-01:9093'
          - 'alertmanager-02:9093'
      scheme: http
      timeout: 10s
      api_version: v2

4.3 rule_files 配置块：规则动态加载

rule_files 块指定 Prometheus 加载的告警规则和记录规则文件路径。支持 Glob 模式匹配，便于按目录组织规则。

# rule_files 配置示例
rule_files:
  - "rules/node_exporter_alerts.yml"
  - "rules/kubernetes_alerts/*.yml"
  - "rules/recording_rules.yml"

4.4 scrape_configs 配置块：抓取任务核心

scrape_configs 是配置文件中结构最复杂、参数最多的块。每个 job_name 定义一个抓取任务，包含目标发现、标签管理、抓取参数等。

# scrape_configs 配置示例
scrape_configs:
  - job_name: 'node-exporter'
    scrape_interval: 30s
    static_configs:
      - targets:
        - 'node-01:9100'
        - 'node-02:9100'
        labels:
          group: 'compute'
    relabel_configs:
      - source_labels: [__address__]
        regex: '(.*):.*'
        replacement: '${1}'
        target_label: 'instance_ip'

4.5 四大配置块协同工作流

下图展示了 Prometheus 启动后，四大配置块如何协同完成从配置加载到数据存储、告警触发的完整流程。

4.6 配置调优实战：控制面环境推荐参数

针对控制面环境（Kubernetes 控制平面组件、etcd、API Server 等），以下是一组经过验证的推荐配置参数：

# 使用 promtool 验证配置文件语法
promtool check config prometheus.yml

# 检查规则文件语法
promtool check rules rules/node_exporter_alerts.yml

4.7 常见配置错误与排查

• 缩进错误： YAML 对缩进敏感，使用空格而非 Tab，建议统一为 2 空格缩进。
• targets 格式错误： targets 必须为列表格式，即使只有一个目标也要加 - 前缀。
• 标签冲突： relabel_configs 中若 target_label 与已有标签重名，会覆盖原值，可能导致数据混乱。
• 规则文件路径错误： rule_files 使用相对路径时，基准目录为 Prometheus 进程的工作目录，建议使用路径。
• Alertmanager 不可达： 若 alerting 块配置的 Alertmanager 地址不可达，Prometheus 仍会正常抓取，但告警无法发送，需检查网络连通性。