# Distributed-Prometheus

分布式 Prometheus 监控系统，支持多用户、多设备监控。

---

## 部署顺序

**先中央，后边缘**（边缘向中央上报，中央必须先就绪）。

| 步骤 | 做什么 | 命令摘要 |
|------|--------|----------|
| **第一步** | 部署中央服务器 | `cd central-server && bash deploy.sh` |
| **第二步** | 部署边缘节点（可选，可多台） | 本机同机：`cd edge-agent && bash run-edge-local.sh`；远程：配 `.env` 后 `bash deploy.sh` |
| **第三步** | 多用户 / 告警（可选） | Grafana：`central-server/grafana/setup-users.sh`；告警：编辑 `alertmanager/alertmanager.yml` |

**完整说明、验证方式与文档入口**：**[doc/README.md](doc/README.md)**（建议先看其中的「部署顺序」）。

---

## 项目结构

- **central-server/** — 中央：Prometheus、Grafana、VictoriaMetrics、Alertmanager、拓扑标注助手
- **edge-agent/** — 边缘：Prometheus Edge、ONVIF Exporter、Blackbox Exporter
- **topology-editor/** — 拓扑标注助手（与 central 同机运行）：上传/下载 targets.csv，H5 采集 GPS、天地图校验

---

## 快速开始（对应第一步 + 第二步）

1. **第一步：部署中央**
   ```bash
   cd central-server
   cp env.example .env   # 可选
   bash deploy.sh
   ```
   访问 Grafana：http://localhost:3000（admin / admin123）。  
   拓扑标注助手随中央一起启动：http://localhost:4080 — 上传本机 `targets.csv`，选设备、补 GPS 或地图点击修正后下载 CSV，再部署到边缘 `edge-agent/config/`。

2. **第二步：部署边缘**（可选）  
   - 本机同机：`cd edge-agent && bash run-edge-local.sh`  
   - 边缘在别台机器：在 `edge-agent` 里配 `.env` 的 `CENTRAL_SERVER_HOST`、`CENTRAL_SERVER_PORT=8428`，然后 `cd config && ./update-configs.sh && cd .. && bash deploy.sh`  

   边缘数据在 Grafana 中需选择数据源 **「VictoriaMetrics」** 才能看到；中央自身指标在数据源「Prometheus」。

3. **第三步（可选）**：多用户见 `doc/USER_MANAGEMENT.md`，告警见 `doc/ALERTING.md`。

---

## 访问地址（默认）

- Grafana: http://localhost:3000
- Prometheus: http://localhost:9091
- VictoriaMetrics: http://localhost:8428
- Alertmanager: http://localhost:9093
- **拓扑标注助手**: http://localhost:4080  
- 边缘 Prometheus（端口 9092）：http://localhost:9092

---

## 多用户与数据隔离

Grafana 支持多组织、多用户；通过 Prometheus 标签做数据隔离（如 `user_group`）。管理员可查看全部数据。详见 **doc/USER_MANAGEMENT.md**。

---

## 拓扑标注助手（targets.csv 标注流程）

拓扑标注助手主要解决「在现场用手机给设备打坐标、维护拓扑关系」的问题，典型使用流程：

1. **准备 CSV**  
   在本机编辑好 `targets.csv`（推荐按 `edge-agent/config/targets.csv` 的示例维护完整的 type/name/role/parent/uplink_type 等字段）。

2. **上传到标注助手**  
   中央已启动后，浏览器访问 `http://localhost:4080`：  
   - 在顶部「上传 / 下载 targets.csv」区域，选择本机 `targets.csv` 并点击 **上传 CSV**。

3. **现场标注 / 校正坐标**  
   - 在「选择已有设备」下拉中选中要标注的设备；  
   - 在现场用手机点击 **获取当前 GPS 坐标**，或在天地图上点击正确位置；  
   - 如有需要，补充/调整 `parent`、`uplink_type` 等字段；  
   - 点击 **保存到 targets.csv**（仅修改标注助手中的当前副本）。

4. **下载并应用到边缘**  
   - 在页面顶部点击 **下载 targets.csv**，得到新的 CSV；  
   - 将其拷贝到边缘节点的 `edge-agent/config/targets.csv` 覆盖原文件；  
   - 在边缘节点执行：
     ```bash
     cd edge-agent/config
     ./update-configs.sh
     ./csv-to-topology-geojson.sh targets.csv topology.geojson
     ```
     以生成最新的 onvif/ping 配置与拓扑 GeoJSON，Grafana Geomap 即可按经纬度和拓扑关系展示设备与链路。

---

## 文档

**入口与部署顺序**：**[doc/README.md](doc/README.md)**

其他文档均在 `doc/` 下：架构（ARCHITECTURE）、中央/边缘配置、告警、部署指南、故障排查等，见 [doc/README.md#文档列表](doc/README.md)。