# 中央服务器配置文件说明

## 目录结构

```
central-server/
├── docker-compose.yml          # 服务编排
├── deploy.sh                   # 部署脚本
├── prometheus.yml              # Prometheus 主配置
├── alert_rules.yml             # 告警规则
├── alertmanager/alertmanager.yml
└── grafana/
    ├── setup-users.sh
    ├── provisioning/datasources/   # prometheus.yml, victoriametrics.yml
    └── dashboards/
```

## 主要服务与端口

| 服务 | 端口 | 说明 |
|------|------|------|
| prometheus-central | 9091 | 自抓 + 告警评估；边缘数据由 Grafana 从 VictoriaMetrics 查询 |
| grafana | 3000 | 数据源：Prometheus（中央自抓）、VictoriaMetrics（边缘数据） |
| victoria-metrics | 8428 | 接收边缘 remote_write |
| alertmanager | 9093 | 告警路由与通知 |

## 关键配置摘要

- **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>:4080/tiles/vec/{z}/{x}/{y}`，再添加一层 XYZ 填 `http://<central>:4080/tiles/cva/{z}/{x}/{y}`（中文注记）。key 仅需在 central 配置 `TIANDITU_TK`，无需在 Grafana 中填写。详见 [TIANDITU_CONFIG.md](TIANDITU_CONFIG.md)。
- **多用户**：`grafana/setup-users.sh`，见 [USER_MANAGEMENT.md](USER_MANAGEMENT.md)。

## 修改与重载

- Prometheus：改 `prometheus.yml` 或 `alert_rules.yml` 后 `docker compose restart prometheus-central`，或 `curl -X POST http://localhost:9091/-/reload`（若启用 lifecycle）。
- Alertmanager：改 `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)