安装UniAgent（新版）

更新时间：2025-03-03 GMT+08:00

统一数据采集Agent（简称UniAgent）完成统一插件生命周期管理，并为AOM提供指令下发功能，如脚本下发和执行。UniAgent本身不提供数据采集能力，运维数据由不同的插件分工采集，可在接入中心安装对应的插件，并创建采集任务，来进行指标数据采集。

AOM支持对本Region内或本Region外的ECS云服务器或其他服务器主机安装UniAgent。

本Region内：给区域内主机安装UniAgent，即给用户登录AOM服务控制台所在region区主机安装UniAgent。
本Region外：给区域外主机安装UniAgent，即给用户登录AOM服务控制台所在region区外的其他区域主机或非华为云主机安装UniAgent。例如自建IDC（Internet Data Center，互联网数据中心）、第三方云厂商或华为云跨Region主机等。

安装UniAgent支持的Linux操作系统与Windows操作系统，详情请参见操作系统使用限制。
如果您进入的是旧版安装UniAgent页面，需在左侧导航栏选择“设置 > 采集设置 > UniAgent 安装与配置”，单击“UniAgent 安装与配置”页面右上角“体验新版”进入新版安装UniAgent页面。如需返回旧版安装UniAgent，单击“UniAgent 安装与配置”页面右上角“返回旧版”按钮，进入旧版安装页面。

AOM支持对主机通过命令行方式安装UniAgent。

表1 安装方式
方式	适用场景
命令行安装UniAgent	适用于首次安装、单机安装UniAgent场景。使用 PuTTY 等远程登录工具，登录待安装UniAgent的主机，手动执行安装命令去安装UniAgent，详情请参见：命令行安装 UniAgent （本Region内）命令行安装 UniAgent （本Region外）

在安装UniAgent页面中，配置相关安装UniAgent参数信息。

图1 安装UniAgent

表2 安装参数说明表
参数	说明	示例
服务器所在Region	选择待安装UniAgent的云服务器所在区域支持以下两种：本Region内：云服务器所在区域与当前AOM服务端在同一区域，默认云服务器与AOM服务端网络互通。本Region外：云服务器所在区域与当前AOM服务端不在同一区域，需要根据场景选择合适的网络联通方案。	本Region内
服务器类型	选择云服务器类型支持以下两种： ECS云服务器：ECS云服务器管理下的主机。其他服务器：其他服务器管理下的主机。	ECS云服务器
选择安装模式	选择安装模式当前仅支持命令行安装。控制台会提供安装命令，您需要远程登录机器执行安装命令。	命令行安装
云服务器操作系统	选择云服务器操作系统当前仅支持Linux。	Linux
UniAgent版本	选择待安装的UniAgent版本，默认最新版本。	最新版本
复制并执行安装命令	单击“复制命令”，复制以下安装命令： set +o history; curl -k -X GET -m 20 --retry 1 --retry-delay 10 -o /tmp/install_uniagent https://aom-uniagent-*************.com/install_uniagent.sh;bash /tmp/install_uniagent -p ********************* -y ********************************* set -o history; 使用 PuTTY 等远程登录工具登录服务器，并以root权限执行复制的安装命令。	复制并执行Linux安装命令

在安装UniAgent页面中，配置相关安装UniAgent参数信息。

图2 安装UniAgent

表3 安装参数说明表
参数	说明	示例
服务器所在Region	选择待安装UniAgent的云服务器所在区域支持以下两种：本Region内：云服务器所在区域与当前AOM服务端在同一区域，默认云服务器与AOM服务端网络互通。本Region外：云服务器所在区域与当前AOM服务端不在同一区域，需要根据场景选择合适的网络联通方案。	本Region外
云服务器操作系统	选择云服务器操作系统，当前仅支持Linux。	Linux
网络连通方式	选择网络连通方式，当前仅支持公网。区域外主机与公网连通后，就可以直接通过公网与华为云当前区域AOM进行通信。	公网
复制并执行安装命令	单击“复制命令”，复制以下安装命令： set +o history; curl -k -X GET -m 20 --retry 1 --retry-delay 10 -o /tmp/install_uniagent https://aom-uniagent-**********.com/install_uniagent.sh;bash /tmp/install_uniagent -o public -p ********************* -y ********************************** 使用 PuTTY 等远程登录工具登录服务器，并以root权限执行复制的安装命令。	复制并执行Linux安装命令

在“UniAgent 安装与配置”页面查看目标主机的UniAgent状态，详细请参见表4 UniAgent状态说明。

表4 UniAgent状态
状态	说明
运行中	表示主机安装的UniAgent运行正常。
异常	表示主机安装的UniAgent功能异常，请联系技术支持。
安装中	表示该主机正在安装UniAgent。安装UniAgent预计需要1分钟左右，请耐心等待。
安装失败	表示主机安装UniAgent失败，请卸载UniAgent后，并重新安装。如果还未安装成功，请联系技术支持。
未安装	表示主机未安装UniAgent。对于成功安装过UniAgent的主机，在卸载UniAgent后，且未被执行删除操作，则该主机UniAgent处于“未安装”状态。可重新对该主机安装UniAgent，或直接在UniAgent列表中删除该主机。

主机成功安装完UniAgent后，UniAgent会在本地启动查询端口“39338”和“39339”，用于查询日志级别，采集任务等。

您可以对已安装UniAgent的主机执行如下相关操作：

表5 相关操作
操作	说明
搜索主机	在主机列表上方的搜索框，可以通过服务器ID，服务器名称，运行状态来搜索对应主机。
刷新主机列表	单击主机列表右上角的按钮，可刷新主机列表信息。
设置主机展示列	单击主机列表右上角的按钮，可对已接入的主机展示列进行设置。
切换排序	在主机列表的表头，单击各列的可切换主机排序。为默认排序，为按正序排序，为按倒序排序。