如何处理在阿里云主机上自动安装云监控插件失败问题?

更新时间:
复制 MD 格式

如果您在阿里云主机上自动安装云监控插件失败,请按照以下方法逐步排查。

操作步骤

  1. root用户登录云监控插件所在的阿里云主机。

    重要

    云监控仅支持通过管理员账号root操作云监控插件。使用管理员账号具有一定风险,如果操作不当可能导致系统稳定性问题或数据安全问题,请谨慎操作。

  2. 执行以下命令,检查是否能获取到阿里云主机的地域ID。

    curl http://100.100.100.200/latest/meta-data/region-id
  3. 执行以下命令,检查阿里云主机与对象存储OSS之前的网络是否正常。

    ping cms-agent-${region-id}.oss-${region-id}.aliyuncs.com
    说明

    {region-id}是阿里云主机的地域ID,例如:{region-id}cn-hangzhou,命令为ping cms-agent-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com

    • 是:网络正常,但插件仍未成功安装。请继续执行步骤 4,查看安装日志定位具体失败原因;若日志排查后仍无法解决,请给云监控提交工单

    • 否:网络异常,可能是对象存储OSS的网络问题。请给对象存储OSS提交工单

  4. 登录云监控插件所在服务器,查看安装日志,定位具体失败原因。

    根据操作系统查看对应位置的日志文件:

    • Linux 系统:查看 /var/log 目录下的云监控安装日志文件,从中获取具体报错信息。

    • Windows 系统:查看云监控插件安装目录下的日志文件,或打开事件查看器eventvwr.msc),在应用程序日志中查看相关错误记录。

    若步骤 3 的 ping 命令检测网络连通正常,但控制台自动安装仍失败,可尝试手动执行安装命令进行验证:

    Linux 系统(以 root 用户执行以下命令):

    ARGUS_VERSION=4.0.0 /bin/bash -c "$(curl -s https://cms-agent-<region-id>.oss-<region-id>-internal.aliyuncs.com/Argus/agent_install-2.0.3.sh)"

    <region-id> 替换为主机所在地域的 ID(例如 cn-hangzhou)。安装成功后,需等待一段时间让监控数据收集生效。

    Windows 系统:请参考下方「Windows 系统专属排查」中的对应场景进行手动安装处理。

Windows 系统专属排查

若 ECS 实例操作系统为 Windows,且完成上述步骤排查后插件仍安装失败,请根据具体失败场景参考以下处理方法。

场景一:文件占用导致手动安装失败

若安装过程中提示 C 盘已有文件无法删除或替换,请按以下步骤处理:

  1. 以管理员身份打开命令提示符,执行以下命令,尝试直接启动云监控插件服务:

    net start argusagent
  2. 若服务成功启动,则无需重新安装,等待监控数据上报正常即可。

  3. 若仍无法启动,请检查是否有其他进程占用了相关文件,关闭占用进程后重新尝试安装。若问题仍存在,请重启服务器后再次尝试。

场景二:注册表 SN 缓存导致安装失败

若云监控插件曾在该服务器上安装过,注册表中残留的 serial_number 缓存可能导致重新安装失败。请按以下步骤清理后重新安装:

  1. Win+R,输入 regedit 后按回车,打开注册表编辑器

  2. 导航至以下注册表路径:

    HKEY_LOCAL_MACHINE\SOFTWARE\cloudmonitor
  3. 找到 serial_number 键值,右键单击,选择删除

  4. 关闭注册表编辑器,然后重新安装云监控插件。

场景三:云助手异常或 Administrator 密码错误导致控制台安装指令无法下发

若在控制台单击安装后无任何响应,或安装状态长时间无变化,可能是云助手服务异常或 ECS 实例 Administrator 账号密码错误所致。请按以下步骤排查:

  1. Win+R,输入 services.msc 后按回车,打开服务管理界面,确认 Aliyun Assist Service 处于正在运行状态。若服务未运行,请右键单击该服务并选择启动,然后在控制台重新触发安装。

  2. 确认 ECS 实例的 Administrator 账号密码设置正确。云助手通过该账号下发并执行安装指令,密码错误将导致指令执行失败。如需重置密码,请登录 ECS 控制台操作,重置后在控制台重新触发安装。