jack
ab1515dffb
- 中央：config/(prometheus,alertmanager,grafana)、apps/(tile-cache,topology-editor) - 边缘：config/(vmagent,blackbox,targets)、apps/(onvif-exporter) - env: TRAEFIK_PROVIDER、prometheus/env.example 详细说明 - 文档：README/doc 重构，EDGE_CACHE 合并到 EDGE_AGENT_CONFIG - targets.csv 更新流程说明，ARCHITECTURE 图收窄 Made-with: Cursor
75 lines
3.1 KiB
Markdown
75 lines
3.1 KiB
Markdown
# 监控目标与 targets.csv
|
||
|
||
边缘监控目标统一由 `edge-agent/config/targets.csv` 配置，经 `update-configs.sh` 生成 `target-onvif.json`、`target-ping.json`、`target-topology.geojson`。
|
||
|
||
**更新流程**：部署时 deploy.sh 自动从 targets.csv 生成 target-*.json；修改 targets.csv 后需手动执行 `cd edge-agent/config && ./update-configs.sh`，vmagent 每 5 分钟自动重载 JSON，无需重启。
|
||
|
||
---
|
||
|
||
## 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 探测，生成 `target-ping.json`。
|
||
- **onvif**：有 IP，由 ONVIF Exporter 探测，生成 `target-onvif.json`；需填 device_type, model, location, username, password。
|
||
- **topology**：仅拓扑节点（可无 IP），不参与抓取；用于生成 `target-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
|
||
./update-configs.sh
|
||
```
|
||
|
||
- `update-configs.sh`：根据 targets.csv 生成 `target-onvif.json`、`target-ping.json`、`target-topology.geojson`（含设备点与 parent 连线）。
|
||
|
||
---
|
||
|
||
## 监控类型与数据流
|
||
|
||
| 类型 | Job | Exporter | 配置文件 |
|
||
|------|-----|----------|----------|
|
||
| 网络 Ping | network-ping | Blackbox | target-ping.json |
|
||
| ONVIF | onvif-devices | ONVIF Exporter | target-onvif.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"}` 等。
|