在文章 快速构建测试环境 中,我们已经启动了一个实验环境,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。
相关链接
快速构建测试环境