文档首页/ 云监控服务 CES/ 故障排除/ 主机监控/ Agent安装失败问题排查
更新时间:2026-06-26 GMT+08:00
分享

Agent安装失败问题排查

当您在安装Agent失败时,可以参考本章节排查失败原因。

操作场景

可能原因

解决方案

单台主机下手动安装Agent/批量远程安装Agent

当前主机安装过Agent,在重新安装Agent前,卸载的Agent有残留文件。

检查Agent安装路径下文件是否删除干净。如果有,请手动删除以下目录。

Windows:
  • 新版本Agent:C:\Program Files\uniagent
  • 老版本Agent:C:\Program Files\telescope

Linux:

  • 新版本Agent:
    rm /usr/local/uniagent
  • 老版本Agent:
    rm /usr/local/telescope

主机中同时存在新老版本,配置文件丢失。

卸载当前主机中安装的Agent,并重新安装最新版本Agent。卸载Agent操作请参阅卸载Agent

Windows操作系统云服务器无法通过169.254.169.254获取元数据。

  1. 提交工单联系客服,寻求ECS技术支持
  2. 规避方案:在安装命令中添加 -r {region_id}。不同区域region_id不一样,例如:ECS资源所属区域为“华北-北京一”,则RegionID为“cn-north-1”,其他区域的RegionID详见地区和终端节点

WMI服务被禁用

开启WMI服务,操作步骤如下:
  1. 在控制面板,选择“管理工具”。
  2. 在管理工具中,双击“服务”。
  3. 在“服务”页面,修改WMI Performance Adapter的启动类型为手动或自动,并启动该服务。

wget工具缺失

下载并安装wget工具,下载地址请参阅https://ftp.gnu.org/gnu/wget/

当前主机为私有镜像。

私有镜像暂不支持安装Agent。

一键安装Agent/手动安装Agent

DNS配置错误

修改DNS服务器地址,具体操作请参阅查看/修改DNS与安全组配置

相关文档