Agent安装失败问题排查

问题现象

• 若您一键安装Agent失败，可能是由于DNS配置错误导致，请参见查看/修改DNS与安全组配置进行查看和修改。若DNS配置正确仍安装失败，请提交工单联系运维人员处理。
• 若您登录主机或通过“远程安装”功能手动安装Agent失败，请参见图1进行排查。
  图1 Agent安装失败问题排查
  

DNS配置错误

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

主机中同时存在新老版本Agent

主机中同时存在新旧版本的Agent，导致配置文件丢失。请登录主机，检查manifest.json配置文件是否存在。配置文件所在路径如下：

• Linux：

  /usr/local/uniagent/extension/holder/telescope/manifest.json

• Windows：

  C:\Program Files\uniagent\extension\holder\telescope\manifest.json

若在路径下找不到配置文件，请卸载当前主机中安装的Agent，并重新安装最新版本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

Linux主机缺失wget工具

wget是一个开源的命令行网络下载工具，用于从HTTP、HTTPS、FTP 等协议下载文件。Linux系统安装Agent依赖wget拉取安装脚本，未安装wget会直接报“command not found”，无法下载，安装流程中断。

1. 执行以下命令，若返回“command not found”，说明当前主机未安装wget工具。

   wget --version

2. 下载并安装wget工具，下载地址请参见https://ftp.gnu.org/gnu/wget/。

Windows系统中WMI服务被禁用

WMI（Windows Management Instrumentation）服务为Windows提供统一的系统管理接口，支持本地及远程查询与管理硬件、操作系统、应用程序、服务、进程、性能计数器等系统资源。该服务被禁用后，依赖WMI的Agent将无法采集CPU、内存、磁盘、进程、网络等Windows指标，导致监控数据缺失。

在搜索框中搜索并打开“services.msc”，查看“Windows Management Instrumentation”状态，若状态显示“禁用”，请按照如下操作步骤启动WMI服务。

Windows操作系统无法获取元数据

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

1. 您可以参考Windows操作系统云服务器无法获取元数据怎么办？进行排查，或提交工单联系客服，寻求ECS技术支持。
2. 规避方案：在安装命令中添加 -r {region_id}。不同区域region_id不一样，例如：ECS资源所属区域为“华北-北京一”，则RegionID为“cn-north-1”，其他区域的RegionID参见地区和终端节点。

提交工单

如果上述方法均不能解决您的疑问，请提交工单寻求更多帮助。