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
92 lines
3.1 KiB
Markdown
92 lines
3.1 KiB
Markdown
# 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) |
|