Files

jack ab1515dffb 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

2026-02-28 22:05:43 -05:00

3.1 KiB

Raw Blame History

Distributed-Prometheus

分布式 Prometheus 监控系统：中央收集、边缘上报、多用户多设备。

架构概览

边缘 targets.csv → update-configs.sh → target-onvif / target-ping / target-topology
边缘 vmagent 抓取 → remote_write → 中央 VictoriaMetrics
中央 Prometheus 抓取本地 + 查 VictoriaMetrics → 告警 + Grafana

边缘将指标推送到中央 VictoriaMetrics（8428）；Grafana 查询边缘数据选 VictoriaMetrics，中央自抓选 Prometheus。

项目结构

Distributed-Prometheus/
├── central-server/          # 中央节点
│   ├── config/              # 配置（prometheus、alertmanager、grafana）
│   ├── apps/                # 自建应用（tile-cache、topology-editor）
│   └── data/                # 运行时数据（gitignore）
│
├── edge-agent/              # 边缘节点（可多台）
│   ├── config/              # 配置（vmagent、blackbox、targets.csv）
│   └── apps/                # 自建应用（onvif-exporter）
│
└── doc/                     # 文档

快速开始

顺序：中央 → 边缘（边缘上报中央，中央须先就绪）

# 1. 中央
cd central-server && cp env.example .env && bash deploy.sh

# 2. 边缘（本机同机）
cd edge-agent && bash deploy.sh --local

# 2. 边缘（跨机）
cd edge-agent && cp env.example .env
# 编辑 .env 中 CENTRAL_SERVER_HOST=中央IP
bash deploy.sh

访问地址（默认）

服务	端口	URL
Grafana	3000	http://localhost:3000
Prometheus	9091	http://localhost:9091
VictoriaMetrics	8428	http://localhost:8428
Alertmanager	9093	http://localhost:9093
GPS 标注助手	4080	http://localhost:4080
边缘 vmagent	9092	http://localhost:9092

Grafana 默认 admin/admin123；查边缘数据选数据源 VictoriaMetrics。

监控目标（targets.csv）

边缘监控目标在 edge-agent/config/targets.csv，部署时自动生成 target-onvif.json、target-ping.json。

修改 targets.csv 后：手动执行 cd edge-agent/config && ./update-configs.sh（或重新 deploy.sh），vmagent 每 5 分钟自动重载，无需重启。

详见 doc/TARGETS_AND_MONITORING.md。

文档

类别	文档
部署与配置	doc/README.md 部署步骤、DEPLOYMENT_GUIDE
架构	ARCHITECTURE 容器关系、数据流
中央	CENTRAL_SERVER_CONFIG、central-server/CONFIGURATION.md
边缘	EDGE_AGENT_CONFIG、TARGETS_AND_MONITORING
告警	ALERTING 规则与 Alertmanager
扩展	ONVIF_ALTERNATIVES、TIANDITU_CONFIG、USER_MANAGEMENT
运维	TROUBLESHOOTING、BEST_PRACTICES

3.1 KiB Raw Blame History Unescape Escape