配置文件的简单介绍

在文章 快速构建测试环境 中，我们已经启动了一个实验环境，prometheus_lab 中的配置文件内容被没有做详细的说明。下面我们来说说测试环境中的配置文件。

Prometheus scrape config

这里只着重说明 prometheus/prometheus.yml 文件中与 SNMP 相关的配置。

scrape_configs:
  - job_name: prometheus
    metrics_path: /metrics
    static_configs:
    - targets:
      - prometheus:9090

  - job_name: node
    file_sd_configs:
    - files:
      - /etc/prometheus/file_sd/node.yml

  - job_name: snmp
    scrape_interval: 30s # 覆盖全局默认值
    scrape_timeout: 5s # 覆盖全局默认值
    file_sd_configs:
      - files:
        - /etc/prometheus/file_sd/snmp.yml # 指定 snmp 服务发现配置文件路径
    metrics_path: /snmp
    params:
      module:
      - if_mib   # 指定默认采集 MIB 模块的名称
      community:
      - public  # 指定团体号，当 snmp_exporter snmp.yml 配置文件没有指定团体号，此处定义的团体号生效。
    relabel_configs:
    - source_labels:
      - __address__
      target_label: __param_target
    - source_labels:
      - __param_target
      target_label: instance
    - replacement: snmp_exporter:9116
      target_label: __address__
    - source_labels:  # 从目标中获取MIB模块名称
      - mib
      target_label: __param_module

Service Discovery Config

snmp 的服务发现配置文件中我们可以额外定义一些参数，方便我们可以对不同目标做更小颗粒度的划分。
自动发现配置文件支持 json 格式与 yaml 格式，目标定义了 Prometheus 必须为指标而抓取的端点。
比如我在下面的示例中添加了architecture与model等变量，这些变量prometheus获取目标信息是，会作为目标的标签与目标绑定。

[
  {
      "labels": {
          "mib": "apcups",
          "architecture": "x86_64",
          "model": "linux"
      },
      "targets": [
          "snmpd"
      ]
  }
]

服务发现中的目标标签

多个目标

如果有多个目标，需要在服务发现配置文件中列出多个目标信息，这里我贴出一个简单的 python 脚本，可以生成自动发现配置文件，你也可以根据自己的需求修改。

#!/usr/bin/env python

import sys
import json

data = []

with open(sys.argv[1], "r") as handler:
    for line in handler:
        line = line.strip('\n')
        fields = line.split(',')
        labels = {}
        labels['brand'] = fields[1]
        labels['model'] = fields[2]
        labels['hostname'] = fields[3]
        labels['mib'] = fields[4]
        targets = []
        targets.append(fields[0])
        custom = {}
    custom['targets'] = targets
        custom['labels'] = labels
        print(custom)
        data.append(custom)

with open(sys.argv[2], "w") as json_handler:
    json.dump(data, json_handler, indent=4)

你需要提前编辑一个 csv 文件，示例如下：

192.168.100.1,Huawei,S5328C-EI,BJ-LG-HW5328,if_mib
192.168.100.2,Huawei,Quidway S9306,SH-GQ-HW9306CSS,if_mib
192.168.100.3,Huawei,Quidway S9306,BJ-LG-HW9306CSS,if_mib
192.168.100.4,Huawei,Quidway S9306,GZ-RMZ-HW9306CSS,if_mib

第一个逗号前的内容为主机地址，第二个逗号前的内容为设备厂商名称，第三个逗号前的内容设备型号，第四个逗号前的内容为自定义设备名称，最后一段内容为获取mib名称。
使用下面的名称执行脚本：

python sd_generate.py <your_csv_file_name> <sd_json_file_name>

执行后生成如下内容：

[
    {
        "labels": {
            "mib": "if_mib",
            "brand": "Huawei",
            "hostname": "BJ-LG-HW5328",
            "model": "S5328C-EI"
        },
        "targets": [
            "192.168.100.1"
        ]
    },
    {
        "labels": {
            "mib": "if_mib",
            "brand": "Huawei",
            "hostname": "SH-GQ-HW9306CSS",
            "model": "Quidway S9306"
        },
        "targets": [
            "192.168.100.2"
        ]
    },
    {
        "labels": {
            "mib": "if_mib",
            "brand": "Huawei",
            "hostname": "BJ-LG-HW9306CSS",
            "model": "Quidway S9306"
        },
        "targets": [
            "192.168.100.3"
        ]
    },
    {
        "labels": {
            "mib": "if_mib",
            "brand": "Huawei",
            "hostname": "GZ-RMZ-HW9306CSS",
            "model": "Quidway S9306"
        },
        "targets": [
            "192.168.100.4"
        ]
    }
]

之后 prometheus 会自动加载刚刚生成的服务发现配置文件，不需要重启 prometheus。

相关链接
快速构建测试环境