主机监控安装与维护

在 Linux 主机安装可选采集器,验证数据新鲜度并排查状态页。

运维任务指南更新于 2026-10-27

确认范围和前提

应用指标与主机采集分开;主机监控是每个环境的可选配置,不会自动发现机器,也不是长期监控或集群聚合。应用历史保存在实例内存中,重启后清空。

在实际部署主机的应用仓库根目录操作,确认 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 状态,而不是直接完全停用。保留采集文件供排查;数据库迁移不会因此撤销。

按部署版本核对具体能力与操作。 查看文档适用范围

BOS API · TYPEX

销售咨询暂不可用

暂时无法初始化销售接待,请稍后重试。你仍可查看文档并免费自托管。

查看文档免费自托管