# 监控目标与 targets.csv

边缘监控目标统一由 `edge-agent/config/targets.csv` 配置，经 `update-configs.sh` 生成 `onvif-targets.json`、`ping-targets.json`，并可生成拓扑 GeoJSON 供 Grafana Geomap 使用。

---

## targets.csv 格式

表头（列顺序固定）：

```text
type,ip,name,role,parent,uplink_type,network,device_type,model,location,username,password,onvif_port,lat,lon
```

| 字段 | 说明 | 适用类型 |
|------|------|----------|
| type | `ping` / `onvif` / `topology` | 必填 |
| ip | IP（topology 哑设备可空） | ping, onvif |
| name | 节点唯一名，用于拓扑 parent 引用 | 必填 |
| role | 如 core_switch, access_switch, camera, wireless_bridge, media_converter | 可选 |
| parent | 上联设备 name，用于画拓扑连线 | 可选 |
| uplink_type | 与上联链路类型：fiber / copper / wireless | 可选 |
| network | 如 internal / external | 可选 |
| device_type, model, location | 设备描述；onvif 必填 location、账号等 | onvif |
| username, password, onvif_port | ONVIF 认证与端口（默认 80） | onvif |
| lat, lon | 经纬度（十进制度），Geomap 打点与拓扑 | 可选 |

- **ping**：有 IP，由 Blackbox Exporter 探测，生成 `ping-targets.json`。
- **onvif**：有 IP，由 ONVIF Exporter 探测，生成 `onvif-targets.json`；需填 device_type, model, location, username, password。
- **topology**：仅拓扑节点（可无 IP），不参与抓取；用于生成 `topology.geojson` 画点与连线。

---

## 示例

```csv
type,ip,name,role,parent,uplink_type,network,device_type,model,location,username,password,onvif_port,lat,lon
ping,192.168.2.1,core_sw_1,core_switch,,,internal,,,,,,,22.54,113.98
ping,8.8.8.8,google_dns,dns,core_sw_1,fiber,external,,,,,,,22.55,113.99
topology,,dumb_sw_1,access_switch,core_sw_1,copper,internal,switch,,building_A,,,,22.543,113.988
onvif,192.168.1.100,camera_front,camera,dumb_sw_1,copper,internal,camera,HIKVISION,front_door,admin,pass,80,22.123,113.567
```

---

## 生成配置与拓扑

```bash
cd edge-agent/config
chmod +x *.sh
./update-configs.sh
./csv-to-topology-geojson.sh targets.csv topology.geojson
```

- `update-configs.sh`：根据 targets.csv 生成 `onvif-targets.json`、`ping-targets.json`。
- `csv-to-topology-geojson.sh`：生成 `topology.geojson`，供 Grafana Geomap 加载（设备点 + parent 连线，uplink_type 可区分线型）。

---

## 监控类型与数据流

| 类型 | Job | Exporter | 配置文件 |
|------|-----|----------|----------|
| 网络 Ping | network-ping | Blackbox | ping-targets.json |
| ONVIF | onvif-devices | ONVIF Exporter | onvif-targets.json |
| 边缘自身 | prometheus-edge | Prometheus | 内置 |

数据流：目标 → Exporter → prometheus-edge 抓取 → remote_write → 中央 VictoriaMetrics。Grafana 查边缘数据需选 **VictoriaMetrics** 数据源。

---

## 验证

- 边缘 Prometheus（http://localhost:9092）：`probe_success{job="network-ping"}`、`onvif_device_up`。
- 中央 Grafana（VictoriaMetrics 数据源）：`probe_success{region="workernode_1"}` 等。