hy-app-monitor/AGENTS.md

hy-app-monitor Agent Guide

项目目标

• 这是部署在 deploy 机器上的轻量监控面板。
• 页面端口固定走 2026，不要再改回 6666 一类浏览器 unsafe port。
• 服务健康检查直接走各业务机器的 HTTP 接口。
• 主机 CPU / 内存 / 磁盘 / 进程数 统一走 TAT 远程采集，不额外安装 agent。
• Nacos 和 MongoDB 指标优先走 deploy 机直连，不需要额外 agent。

配置约定

• 项目根目录 .env 是运行时唯一配置源。
• .env 必须保留在本地和远端项目目录里，但不能提交到 Git。
• .env.example 只作为模板，不能写真实密钥。
• TENCENT_SECRET_ID / TENCENT_SECRET_KEY / DEPLOY_REGION 从 .env 读取。
• NACOS_BASE_URL / NACOS_NAMESPACE_ID / MONGO_URI 也从 .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 指标采集。
• Python 代码按模块维护，核心目录是 monitor/，server.py 只保留入口。

修改原则

• 不要把 TAT 采集替换成 agent 方案，除非用户明确要求。
• 不要把密钥写进版本库。
• 不要删除页面里的主机指标区块。
• Python 文件保持高注释密度，优先写清楚每个步骤在做什么。