39 lines
1.7 KiB
Markdown
39 lines
1.7 KiB
Markdown
# hy-app-monitor Agent Guide
|
|
|
|
## 项目目标
|
|
|
|
- 这是部署在 `deploy` 机器上的轻量监控面板。
|
|
- 页面端口固定走 `2026`，不要再改回 `6666` 一类浏览器 unsafe port。
|
|
- 服务健康检查直接走各业务机器的 HTTP 接口。
|
|
- 主机 `CPU / 内存 / 磁盘 / 进程数` 统一走 `TAT` 远程采集，不额外安装 agent。
|
|
|
|
## 配置约定
|
|
|
|
- 项目根目录 `.env` 是运行时唯一配置源。
|
|
- `.env` 必须保留在本地和远端项目目录里，但不能提交到 Git。
|
|
- `.env.example` 只作为模板，不能写真实密钥。
|
|
- `TENCENT_SECRET_ID` / `TENCENT_SECRET_KEY` / `DEPLOY_REGION` 从 `.env` 读取。
|
|
- `config/targets.json` 里的 `instanceId` 不能删，`TAT` 主机采集依赖它。
|
|
|
|
## 运行约定
|
|
|
|
- 正式运行优先使用 `systemd`。
|
|
- `scripts/install_systemd.sh` 负责安装 unit 并启用开机自启。
|
|
- `scripts/start.sh` / `stop.sh` / `restart.sh` / `status.sh` 在检测到 unit 后应直接转调 `systemctl`。
|
|
- `scripts/run_foreground.sh` 只给 `systemd` 用，不要把它改成后台模式。
|
|
|
|
## 部署约定
|
|
|
|
- 远端路径固定为 `/opt/hy-app-monitor`。
|
|
- 部署入口是 `ops/deploy_via_tat.py`。
|
|
- 该脚本需要把本地项目根目录 `.env` 同步到远端项目根目录 `.env`。
|
|
- 远端 Python 运行时优先使用项目内 `.venv`。
|
|
- `requirements-ops.txt` 里的依赖既服务于部署脚本，也服务于运行时 `TAT` 指标采集。
|
|
|
|
## 修改原则
|
|
|
|
- 不要把 `TAT` 采集替换成 agent 方案，除非用户明确要求。
|
|
- 不要把密钥写进版本库。
|
|
- 不要删除页面里的主机指标区块。
|
|
- Python 文件保持高注释密度，优先写清楚每个步骤在做什么。
|