lislgosms/tools/monitoring/README.md

CMPP Prometheus 监控配置

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

在目标Debian/Ubuntu测试服务器上，以root执行：

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

脚本会安装Prometheus与Node Exporter、备份已有Prometheus配置及本脚本曾写入的systemd override、校验规则、写入新override，并仅重启这两个监控服务。备份目录会在脚本结束时打印。它不会重启API、Gateway、数据库、Redis、MinIO或Nginx。9090和9100固定监听127.0.0.1。

安装后将下列配置写入/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)'

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