lislgosms/tools/monitoring/README.md

CMPP Prometheus 监控配置

本目录提供系统监控第一版所需的真实采集配置。运营端不嵌入Prometheus或Grafana页面；NestJS仅从本机Prometheus读取固定指标，再由平台原生UI展示。

在目标 Debian/Ubuntu（apt）或 Alibaba Cloud Linux 4 ARM64 测试服务器上，以 root 执行：

cd /opt/cmpp-platform
bash tools/monitoring/install-prometheus-monitoring.sh
bash tools/monitoring/install-service-exporters.sh

Debian/Ubuntu 使用系统包；Alibaba Cloud Linux 4 ARM64 使用脚本中锁定版本和 SHA-256 的官方 release 二进制。第一个脚本安装 Prometheus 与 Node Exporter，备份已有配置并校验规则；第二个脚本安装 PostgreSQL、Redis 和 Nginx Exporter，开启 MinIO 回环原生指标。API 指标仅监听 127.0.0.1:9464，Gateway 指标复用回环控制端口 8090。9090、9100、9187、9121、9113 和 9464 均不得对公网开放。两个脚本均会打印恢复资产路径。

安装后将下列配置写入/etc/cmpp-platform/cmpp-platform.env，再按正常发布窗口重启API：

PROMETHEUS_URL=http://127.0.0.1:9090
PROMETHEUS_QUERY_TIMEOUT_MS=5000

校验命令：

promtool check config /etc/prometheus/prometheus.yml
promtool check rules /etc/prometheus/cmpp-alerts.yml
curl -fsS http://127.0.0.1:9090/-/ready
curl -fsS 'http://127.0.0.1:9090/api/v1/query?query=up'
ss -lnt | grep -E ':(9090|9100)'
curl -fsS http://127.0.0.1:9464/metrics
curl -fsS http://127.0.0.1:8090/metrics

完整架构、PromQL口径、故障语义和验收标准见docs/prometheus-system-monitoring-design-20260814.md。