c4825c2d27
- 对外端口统一为 18428（vmauth 入口），VM 不再直接暴露宿主机端口 - 边缘 vmagent 与中央 Prometheus remote_write 增加 basic auth - 支持 tenants.csv 驱动的 per-tenant 写入/查询隔离，并提供管理员跨租户只读查询 - 更新 Grafana provisioning 与部署/文档 Made-with: Cursor
45 lines
2.6 KiB
Markdown
45 lines
2.6 KiB
Markdown
# 中央服务器配置文件说明
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
central-server/
|
||
├── docker-compose.yml # 服务编排
|
||
├── deploy.sh # 部署脚本
|
||
├── config/ # 配置目录
|
||
│ ├── prometheus/ # Prometheus 配置（prometheus.yml、alert_rules.yml）
|
||
│ ├── alertmanager/ # Alertmanager 配置
|
||
│ └── grafana/ # Grafana 配置（provisioning、dashboards）
|
||
├── apps/ # 自建应用源码
|
||
│ ├── tile-cache/ # 天地图瓦片缓存
|
||
│ └── topology-editor/ # GPS 标注助手
|
||
└── data/ # 运行时数据（gitignore）
|
||
```
|
||
|
||
## 主要服务与端口
|
||
|
||
| 服务 | 端口 | 说明 |
|
||
|------|------|------|
|
||
| prometheus-central | 9091 | 自抓 + 告警评估；边缘数据由 Grafana 从 VictoriaMetrics 查询 |
|
||
| grafana | 3000 | 数据源：Prometheus（中央自抓）、VictoriaMetrics（边缘数据） |
|
||
| vmauth | 18428 | 边缘 remote_write 与 Grafana 查询入口（鉴权） |
|
||
| alertmanager | 9093 | 告警路由与通知 |
|
||
|
||
## 关键配置摘要
|
||
|
||
- **config/prometheus/prometheus.yml**：`remote_write` 指向 VictoriaMetrics；`rule_files: alert_rules.yml`；抓取自身、VM、Alertmanager、Grafana。
|
||
- **告警规则与通知**：见 [ALERTING.md](ALERTING.md)。
|
||
- **Grafana 数据源**：Provisioning 下配置 Prometheus、VictoriaMetrics；查边缘指标请选 **VictoriaMetrics**。
|
||
- **Grafana Geomap 使用天地图缓存**：在 Geomap 面板中将 Base layer 选为 **XYZ Tile layer**，底图 URL 填 `http://<central>:4090/tiles/vec/{z}/{x}/{y}`，再添加一层 XYZ 填 `http://<central>:4090/tiles/cva/{z}/{x}/{y}`（中文注记）。key 仅需在 central 配置 `TIANDITU_TK`，无需在 Grafana 中填写。详见 [TIANDITU_CONFIG.md](TIANDITU_CONFIG.md)。
|
||
- **多用户**：`config/grafana/setup-users.sh`，见 [USER_MANAGEMENT.md](USER_MANAGEMENT.md)。
|
||
|
||
## 修改与重载
|
||
|
||
- Prometheus：改 `config/prometheus/prometheus.yml` 或 `config/prometheus/alert_rules.yml` 后 `docker compose restart prometheus-central`，或 `curl -X POST http://localhost:9091/-/reload`（若启用 lifecycle）。
|
||
- Alertmanager：改 `config/alertmanager/alertmanager.yml` 后 `docker compose restart alertmanager`。
|
||
- Grafana：改 provisioning 后重启；或通过 Web UI 修改（持久化到库）。
|
||
|
||
## 相关文档
|
||
|
||
- [ARCHITECTURE.md](ARCHITECTURE.md) | [ALERTING.md](ALERTING.md) | [USER_MANAGEMENT.md](USER_MANAGEMENT.md) | [central-server/CONFIGURATION.md](../central-server/CONFIGURATION.md)
|