Distributed-Prometheus/doc/TARGETS_CSV_GUIDE.md

targets.csv 配置指南

概述

targets.csv 是统一的监控目标配置文件，可以在一个文件中同时配置 ONVIF 设备和网络 Ping 目标。

文件格式

type,ip,device,group,network,device_type,model,location,username,password,onvif_port

字段说明

字段	说明	必需	适用类型
type	目标类型：ping 或 onvif	✅	所有
ip	IP 地址	✅	所有
device	设备名称	❌	ping
group	设备分组	❌	ping
network	网络类型（internal/external）	❌	ping
device_type	设备类型（camera/nvr）	✅	onvif
model	设备型号	✅	onvif
location	设备位置	✅	onvif
username	用户名	✅	onvif
password	密码	✅	onvif
onvif_port	ONVIF 端口（默认80）	❌	onvif

配置示例

Ping 目标配置

type,ip,device,group,network,device_type,model,location,username,password,onvif_port
ping,192.168.1.1,main_router,network,internal,,,,,,
ping,8.8.8.8,google_dns,external,external,,,,,,
ping,1.1.1.1,cloudflare_dns,external,external,,,,,,

说明：

• type 设置为 ping
• 填写 ip, device, group, network
• ONVIF 相关字段留空

ONVIF 设备配置

type,ip,device,group,network,device_type,model,location,username,password,onvif_port
onvif,192.168.1.100,,,front_door,camera,HIKVISION_DS-2CD2342WD-I,front_door,admin,password1,80
onvif,192.168.1.101,,,back_yard,camera,DAHUA_IPC-HFW1230S,back_yard,admin,password2,80
onvif,192.168.1.50,,,server_rack,nvr,HIKVISION_DS-7608NI-I2,server_rack,admin,password4,80

说明：

• type 设置为 onvif
• 填写 ip, device_type, model, location, username, password
• onvif_port 默认为 80，如果不是 80 需要填写
• Ping 相关字段（device, group, network）可以留空

混合配置示例

type,ip,device,group,network,device_type,model,location,username,password,onvif_port
ping,192.168.1.1,main_router,network,internal,,,,,,
ping,8.8.8.8,google_dns,external,external,,,,,,
onvif,192.168.1.100,,,front_door,camera,HIKVISION_DS-2CD2342WD-I,front_door,admin,password1,80
onvif,192.168.1.101,,,back_yard,camera,DAHUA_IPC-HFW1230S,back_yard,admin,password2,80

使用注释

可以在 CSV 文件中使用 # 开头的注释行：

# 这是注释行
type,ip,device,group,network,device_type,model,location,username,password,onvif_port
ping,8.8.8.8,google_dns,external,external,,,,,,
# onvif,192.168.1.100,,,front_door,camera,HIKVISION_DS-2CD2342WD-I,front_door,admin,password1,80

生成配置文件

编辑 targets.csv 后，运行：

cd config
./update-configs.sh

这会生成：

• onvif-targets.json - ONVIF 设备配置
• ping-targets.json - Ping 目标配置

向后兼容

如果存在旧的配置文件：

• devices.csv - 仍会被识别并转换
• ping-targets.csv - 仍会被识别并转换

但建议统一使用 targets.csv 进行配置。

注意事项

1. 字段顺序：必须按照 CSV 头部定义的顺序填写
2. 空字段：不需要的字段可以留空，但逗号不能省略
3. 特殊字符：如果字段值包含逗号，需要用引号包裹
4. 密码安全：密码以明文存储，请确保文件权限安全

迁移指南

从旧格式迁移

旧格式（devices.csv + ping-targets.csv）：

# devices.csv
ip,device_type,model,location,username,password,onvif_port
192.168.1.100,camera,HIKVISION_DS-2CD2342WD-I,front_door,admin,password1,80

# ping-targets.csv
ip,device,group,network
8.8.8.8,google_dns,external,external

新格式（targets.csv）：

type,ip,device,group,network,device_type,model,location,username,password,onvif_port
onvif,192.168.1.100,,,front_door,camera,HIKVISION_DS-2CD2342WD-I,front_door,admin,password1,80
ping,8.8.8.8,google_dns,external,external,,,,,,

只需将两个文件的内容合并到 targets.csv，并添加 type 列即可。