主机监控安装与维护
在 Linux 主机安装可选采集器,验证数据新鲜度并排查状态页。
确认范围和前提
应用指标与主机采集分开;主机监控是每个环境的可选配置,不会自动发现机器,也不是长期监控或集群聚合。应用历史保存在实例内存中,重启后清空。
在实际部署主机的应用仓库根目录操作,确认 Docker context 和 DOCKER_HOST 指向该主机,保留原有 deploy/stack.env。安装器需要 Linux、systemd、Python 3 和 sudo。
安装并检查采集器
确认 timer 为 active、最近一次服务结果成功,且快照可读。服务为一次性任务,运行完成后 inactive 是正常状态;安装失败时先排查日志,再启用应用集成。
sudo bash deploy/monitor/install.sh
sudo systemctl is-active bosapi-monitor.timer
sudo systemctl show bosapi-monitor.service -p Result -p ExecMainStatus
sudo journalctl -u bosapi-monitor.service -n 30 --no-pager
test -r /var/lib/bosapi-monitor/local.json启用应用集成
快照生成后创建本机标记。新部署或需要构建的源码更新执行 up;已有兼容镜像且只更改运行配置时执行 start。选择其中一种,应用可能被重建并短暂中断。
touch deploy/monitor.enabled./deploy/stack.sh up./deploy/stack.sh start- 后续使用 stack.sh 保留监控 overlay;单独使用基础 Compose 文件会遗漏它。
验证与排错
- 等待约 30–60 秒,最长检查 120 秒;确认 local.json 的 sampled_at 持续更新,检查容器中的 /app/monitor/local.json 可读及 BOS_MONITOR_NODE_DIR=/app/monitor,执行 stack.sh status 检查服务。
- 以超级管理员进入“系统状态”,核对节点身份、采样时间和采集错误。首次 CPU 或网络速率可能缺失,等待连续样本;快照超过 90 秒会显示过期。
- 节点为空或过期时,按 timer、主机 JSON、容器挂载与变量、后台快照、页面的顺序排查。应用指标正常不代表主机采集已配置。
- TLS 检查需要单独配置 BOS_MONITOR_TLS_TARGETS;页面提示不是持久告警或外部通知。多实例须逐个验证。
停用与恢复
若本次新启用的集成需要完全停用,在变更窗口移除 deploy/monitor.enabled,执行 ./deploy/stack.sh start,成功后再停用 timer 并停止正在运行的 service。确认应用健康、挂载和变量消失。此操作也停止该 overlay 转发的 TLS 检查。
若监控原本已启用,升级回退应恢复之前的脚本、单元文件、覆盖配置和 timer 状态,而不是直接完全停用。保留采集文件供排查;数据库迁移不会因此撤销。
按部署版本核对具体能力与操作。 查看文档适用范围