refactor: config/apps 目录重组、文档重构、架构图收窄

- 中央: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
This commit is contained in:
2026-02-28 22:05:43 -05:00
parent 650e5145f1
commit ab1515dffb
48 changed files with 2071 additions and 509 deletions

View File

@@ -26,25 +26,27 @@
- **config/targets.csv**统一监控目标ping/onvif/topology格式与脚本见 [TARGETS_AND_MONITORING.md](TARGETS_AND_MONITORING.md)。
- **config/update-configs.sh**:从 targets.csv 生成 `target-onvif.json``target-ping.json``target-topology.geojson`
- **prometheus-edge (vmagent)**:使用 `vmagent-scrape.yml.template` 抓取;`CENTRAL_SERVER_HOST`/`PORT` 来自 `.env`;磁盘缓存卷 `vmagent-cache-data`
- **prometheus-edge (vmagent)**:使用 `config/vmagent/vmagent-scrape.yml.template` 抓取;`CENTRAL_SERVER_HOST`/`PORT` 来自 `.env`;磁盘缓存卷 `vmagent-cache-data`
- **.env**`CENTRAL_SERVER_HOST``CENTRAL_SERVER_PORT=8428``EDGE_NODE_ID`。本机同机用 `./deploy.sh --local`;跨机配 `.env``./deploy.sh`
## 常用操作
- 改监控目标:编辑 `config/targets.csv``cd config && ./update-configs.sh`,必要时重启 prometheus-edge
- 改监控目标:编辑 `config/targets.csv``cd config && ./update-configs.sh`vmagent 每 5 分钟自动重载 JSON无需重启
- 改中央地址:编辑 `.env``docker compose restart prometheus-edge`
## 中心宕机 / 断网时的缓存
`docker-compose.yaml` 使用 vmagent 统一实现:
`docker-compose.yaml` 使用 vmagent 实现:
- **短时内存缓存**:中心短暂不可达时在内存中缓冲
- **长时磁盘缓存**:长时间离线时写入磁盘队列(默认 512MB恢复后自动补传
- **冗余重试**:失败自动重试,边缘重启后从磁盘恢复未上传数据
| 层级 | 机制 | 说明 |
|------|------|------|
| **短时内存缓存** | 内存队列 | 中心短暂不可达时在内存中缓冲(约 30 分钟量级) |
| **长时磁盘缓存** | 持久化队列 | 长时间离线写入磁盘(默认 512MB恢复后自动补传 |
| **冗余重试** | 失败重试 | 边缘重启后从磁盘恢复未上传数据 |
详见 [EDGE_CACHE.md](EDGE_CACHE.md)
**参数**(修改 prometheus-edge 的 `command` 可调):`-remoteWrite.maxDiskUsagePerURL=512MB``-remoteWrite.tmpDataPath=/cache/remotewrite``-memory.allowedPercent=80`。监控指标:`vmagent_remotewrite_pending_bytes``vmagent_remotewrite_packets_dropped_total`
## 相关文档
- [EDGE_CACHE.md](EDGE_CACHE.md) | [DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md) | [TARGETS_AND_MONITORING.md](TARGETS_AND_MONITORING.md) | [ONVIF_ALTERNATIVES.md](ONVIF_ALTERNATIVES.md) | [ARCHITECTURE.md](ARCHITECTURE.md)
- [DEPLOYMENT_GUIDE](DEPLOYMENT_GUIDE.md) | [TARGETS_AND_MONITORING](TARGETS_AND_MONITORING.md) | [ONVIF_ALTERNATIVES](ONVIF_ALTERNATIVES.md) | [ARCHITECTURE](ARCHITECTURE.md)