# 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/                     # 文档
```

---

## 快速开始

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

```bash
# 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/TARGETS_AND_MONITORING.md)。

---

## 文档

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