# 安装UniAgent 统一数据采集 Agent（简称UniAgent），聚焦统一插件生命周期管理，作为采集插件的底座管理平台，承担插件集成管理职责，并持续维护插件状态。UniAgent自身不具备指标数据采集能力，运维数据采集由各类分工明确的插件完成。 - 在AOM的UniAgent管理页面为主机安装ICAgent插件，通过ICAgent插件进行指标或日志数据采集。 - 在AOM的接入中心页面为主机安装对应的中间件及自定义插件，并创建采集任务，来进行指标数据采集。 AOM支持为虚拟私有云下的云服务器主机安装UniAgent。 图1新手介绍 ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002179440093.png "点击放大") #### 前提条件 请确保安装机与待安装UniAgent的主机间网络互通。 #### 约束与限制 - 安装UniAgent支持的Linux操作系统与Windows操作系统，详情请参见[操作系统使用限制](https://support.huaweicloud.com/productdesc-aom2/aom_01_0013.html#section3)。 - 如果您进入的是新版安装UniAgent页面，需在左侧导航栏选择"设置 \> 全局设置 \> 采集设置 \> UniAgent管理"，单击"UniAgent管理"页面右上角"返回旧版"返回至旧版安装UniAgent页面。如需体验新版安装UniAgent功能，单击"UniAgent管理"页面右上角"体验新版"按钮，进入[新版安装](https://support.huaweicloud.com/usermanual-aom2/agent_02_0005.html)页面。 #### 安装方式说明 AOM支持对主机安装UniAgent，UniAgent支持的安装方式：Excel导入安装、手动安装和远程安装。您可以按照实际场景进行选择。 表1安装方式 | 方式 | 适用场景 | |:---|:---| | [手动安装UniAgent] | 适用于首次安装、单机安装UniAgent场景。登录待安装UniAgent的主机，手动执行安装命令安装UniAgent。 **首次安装UniAgent时，必须使用手动安装方式。** | | [远程安装UniAgent] | 适用于批量安装UniAgent场景。将一台已经安装了UniAgent的主机[设置为安装机]，然后通过该安装机对其他机器进行远程安装UniAgent。（在安装页面直接输入待安装UniAgent的主机信息。） | | [Excel导入安装UniAgent] | 适用于批量安装UniAgent场景。将一台已经安装了UniAgent的主机[设置为安装机]，然后通过该安装机对其他机器进行远程安装UniAgent。（在安装页面通过Excel导入待安装UniAgent的主机信息。） **当前通过Excel导入安装方式受限开放，如有需求可以通过[提交工单](https://support.huaweicloud.com/usermanual-ticket/zh-cn_topic_0127038618.html)，为您开放此功能。** | - [手动安装UniAgent] 首次安装UniAgent时，必须使用手动安装方式。 1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。 2. 在左侧导航栏中选择"设置 \> 全局设置"，进入全局设置界面。 3. 左侧导航栏中，选择"采集设置 \> UniAgent管理"，单击"安装UniAgent"，选择"手动安装"。（首次安装UniAgent时，默认进入"手动安装"页面，无需选择"手动安装"。） 4. 在安装UniAgent页面中，配置相关安装UniAgent参数信息。 图2手动安装UniAgent ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002517024199.png "点击放大") 表2手动安装参数说明表 | 参数 | 说明 | 示例 | |:---|:---|:---| | UniAgent版本 | UniAgent的版本，必选项。 | 1.2.0 | | 接入方式 | 接入方式有两种：直连接入和代理接入。 - 直连接入：使用直连接入的方式。 - 代理接入：通过选择已配置代理机的代理区域，使用代理接入的方式安装UniAgent。 | 直连接入 | | 代理区域 | 代理区域是对代理机的分类管理。当接入方式选择"代理接入"时，需选择代理区域，或单击"新增代理区域"可[新增代理区域](https://support.huaweicloud.com/usermanual-aom2/agent_01_0010.html)。 代理区域中必须配置可用的代理机；且代理机必须为一台已经安装了UniAgent的云主机。 | 选择代理区域 | | 安装命令 | 安装UniAgent的命令，分为LINUX和WINDOWS。 **LINUX** 1. 单击![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002076854813.png)复制安装命令。 ``` set +o history; curl -k -X GET -m 20 --retry 1 --retry-delay 10 -o /tmp/install_uniagent https://aom-uniagent-xxxxxx/install_uniagent.sh;bash /tmp/install_uniagent -p xxxxxx -v 1.x.x -e xxxx; set -o history; ``` **WINDOWS** 1. 复制界面下载地址到浏览器，即可下载安装包：https://aom-uniagent-*{region_name}* .obs.*{region_name}* .*{Site domain name suffix}* / +uniagentd-*{version}* -win32.zip 其中*{region_name}* 和*{version}*均可在安装界面获取： - *region_name*：指定承载REST服务端点的服务器域名或IP，不同服务不同区域的名称不同。 - Site domain name suffix ：站点域名后缀，例如"myhuaweicloud.com"。 - *version*：当前所安装的UniAgent的版本。 2. 解压安装包后，单击uniagentd.msi，指定安装路径为C:\\uniagentd。 3. 修改C:\\uniagentd\\conf\\uniagentd.conf文件，填入以下的配置（以下信息均可在安装界面获取）： ``` master=https://aom-mgr-lb.xxxxxxxxxxx,https://xx.xx.xx.xx:xxxxx project_id=xxxxxxxxxxxxxx public_net=xxxx ``` 4. 以管理员身份执行：C:\\uniagentd\\bin\\start.bat启动程序。 如果用户需要校验windows安装包的sha256的值，可以下载https://aom-uniagent-*{region_name}* .obs.*{region_name}* .*{Site domain name suffix}* /uniagentd-*{version}*-win32.zip.sha256文件查看。 | 复制LINUX安装命令 | 5. 复制安装命令，在主机中执行该命令进行安装。 - Linux操作系统主机：使用远程登录工具，登录待安装UniAgent的Linux操作系统主机，以root权限执行上一[步骤]复制的Linux安装命令进行安装。 - Windows操作系统主机：登录待安装UniAgent的Windows操作系统主机，按照上一[步骤]中Windows安装命令的提示，下载安装包，并执行相关步骤进行安装。 6. 安装完成后，在UniAgent列表中可查看。 - [远程安装UniAgent] 1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。 2. 在左侧导航栏中选择"设置 \> 全局设置"，进入全局设置界面。 3. 左侧导航栏中，选择"采集设置 \> UniAgent管理"，单击"安装UniAgent"。 4. 在安装UniAgent页面中，单击"远程安装"，配置相关安装UniAgent参数信息。（首次安装UniAgent时，默认进入"手动安装"页面，不能选择"远程安装"，必须有可用的安装机，才可进行远程安装。） 图3远程安装UniAgent ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002517030163.png "点击放大") 表3UniAgent安装参数说明表 | 参数 | 说明 | 示例 | |:---|:---|:---| | UniAgent版本 | UniAgent的版本，必选项。 | 1.2.0 | | 接入方式 | 接入方式有两种：直连接入和代理接入。 - 直连接入：使用直连接入的方式。 - 代理接入：通过选择已配置代理机的代理区域，使用代理接入的方式远程安装UniAgent。 | 直连接入 | | 代理区域 | 代理区域是对代理机的分类管理。当接入方式选择"代理接入"时，需选择代理区域，或单击"新增代理区域"可[新增代理区域](https://support.huaweicloud.com/usermanual-aom2/agent_01_0010.html#agent_01_0010__section6176162012554)。 代理区域中必须配置可用的代理机，且代理机必须为一台已经安装了UniAgent的云主机。 | 选择代理区域 | | 安装机 | 安装机是远程安装方式下命令的执行机，必选项。 如果没有设置安装机，按如下步骤进行配置： 1. 返回"虚机接入"页面，在主机列表中，勾选待配置为安装机的主机。 2. 单击"操作"列的"设置安装机"，在设置安装机页面，填写安装机名称，字符长度不超过50。 3. 单击"确认"，安装机设置成功。在远程安装页面即可选择刚设置的安装机。 | 选择安装机 | | 需安装UniAgent主机 | 需安装UniAgent主机的详细信息，必选项。 单击"添加主机信息"，填写如下信息（最多支持添加100个主机）： - 主机IP：主机的IP。 - 操作系统：主机的操作系统。 当前通过远程安装方式安装UniAgent时，主机暂不支持Windows操作系统。 安装机和主机的操作系统需要保持一致，不能混装，即如果安装机的操作系统是Linux系统，安装UniAgent的主机也必须是Linux操作系统。 - 登录账号：登录主机的账号。当操作系统为Linux时，建议使用root账号，可保证有足够的读写权限。 - 登录端口：访问主机的端口。 - 认证方式：认证方式为密码。 - 密码：登录主机的密码。 - 连接测试结果：连接测试的结果，测试安装机和需安装主机间的网络连通性。 主机信息填写完后，可在"操作"列对填写的主机信息进行删除、复制和连接测试。 连接测试用于测试安装机和待安装UniAgent的主机间的网络连通性。测试结果会展示在"连接测试结果"列。 | 配置需安装UniAgent的主机信息 | | 安装ICAgent | ICAgent为指标和日志采集插件。默认开启安装ICAgent按钮，可选项。当前通过远程安装方式安装ICAgent时，主机暂不支持Windows操作系统。 | - | 5. 单击"立即安装"，安装完成后，在UniAgent列表中可[查看UniAgent状态]。 - [Excel导入安装UniAgent] 当前通过Excel导入安装方式受限开放，如有需求可以通过[提交工单](https://support.huaweicloud.com/usermanual-ticket/zh-cn_topic_0127038618.html)，为您开放此功能。 1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。 2. 在菜单栏选择"设置 \> 全局设置"，进入全局设置界面。 3. 左侧导航栏中，选择"采集设置 \> UniAgent管理"，单击右上角"安装UniAgent"。 4. 在安装UniAgent页面中，选择"Excel导入安装"，配置相关安装UniAgent参数信息。（首次安装UniAgent时，默认进入"手动安装"页面，不能选择"Excel导入安装"。） 图4Excel导入安装UniAgent ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002485280576.png "点击放大") 表4Excel导入安装参数说明表 | 参数 | 说明 | 示例 | |:---|:---|:---| | UniAgent版本 | UniAgent的版本，必选项。 | 1.1.9.7 | | 安装机 | 安装机是Excel导入安装方式下命令的执行机，必选项。当前通过Excel导入方式安装UniAgent时，安装机暂不支持Windows操作系统。 如果没有设置安装机，按如下步骤进行配置： 1. 返回"虚机接入"页面，在主机列表中，勾选待配置为安装机的主机。 2. 单击"操作"列的"设置安装机"，在设置安装机页面，填写安装机名称，字符长度不超过50。 3. 单击"确认"，安装机设置成功。在远程安装页面即可选择刚设置的安装机。 | 选择安装机 | | Excel导入安装 | 只能上传一个Excel表格，最多5000条数据；仅支持.xls和.xlsx两种类型。当前通过Excel导入方式安装UniAgent时，主机暂不支持Windows操作系统。 Excel表格参照如下样例填写主机信息： 图5配置主机信息 ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002175461977.png "点击放大") - ip：待安装UniAgent的主机IP。 - 账号：登录主机的账号。建议使用root账号，可保证有足够的读写权限。 - 端口：访问主机的端口。 - 账号密码：登录主机的密码。 | 上传填写主机信息的Excel表格 | 5. 单击"立即安装"，安装完成后，在UniAgent列表中可[查看UniAgent状态]。 #### 查看UniAgent状态 在"虚机接入"页面查看目标主机的UniAgent状态。详细请参见[表5]。 主机成功安装完UniAgent后，UniAgent会在本地启动查询端口，用于查询日志级别，采集任务等。**UniAgent版本号是1.1.5之前的（含1.1.5版本）端口号是"39338"和"39339"，1.1.5版本之后的端口号是"29338"和"29339"。** 表5UniAgent状态 | 状态 | 说明 | |:---|:---| | 运行中 | 表示服务器安装的UniAgent运行正常。 | | 离线 | 表示服务器安装的UniAgent功能异常。 | | 安装中 | 表示该服务器正在安装UniAgent。安装UniAgent预计需要1分钟左右，请耐心等待。 | | 安装失败 | 表示服务器安装UniAgent失败，请卸载UniAgent后，并重新安装。 | | 未安装 | 表示服务器未安装UniAgent。 | #### UniAgent版本说明 在"虚机接入"页面查看目标主机的UniAgent版本，建议您尽快[升级到最新版本](https://support.huaweicloud.com/usermanual-aom2/agent_01_0006.html)。UniAgent版本详细请参见[表6]。 表6UniAgent版本 | 版本号 | 说明 | 发布时间 | |:---|:---|:---| | 1.2.0 | 支持自建k8s集群安装UniAgent。 | 2025-11-13 | | 1.1.9 | 支持对Windows操作系统的主机远程安装UniAgent。 | 2025-06-18 | | 1.1.8 | - 支持CCE集群安装UniAgent。 - 支持对Windows操作系统的主机进行插件管理。 | 2025-02-25 | | 1.1.6 | 支持Linux操作系统免密登录。（当前仅COC云服务支持该功能） | 2024-11-30 | | 1.1.5 | Python脚本执行标准输出缓存问题优化。 | 2024-09-18 | | 1.1.4 | 解决带环境变量场景，执行脚本退出码问题。 | 2024-08-30 | #### 其他相关操作 您可以对已安装UniAgent的主机执行如下相关操作： 表7相关操作 | 操作 | 说明 | |:---|:---| | 搜索主机 | 在主机列表上方的搜索框，可以通过主机IP、导入IP、主机名称、安装机名称和代理IP来搜索对应主机。 | | 刷新主机列表 | 单击主机列表右上角的![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002140409288.png "点击放大")按钮，可刷新主机列表信息。 | | 设置虚机展示列 | 单击主机列表右上角的![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002140567368.png)按钮，可对已接入的虚机展示列进行设置。 | | 过滤主机信息 | 在主机列表的表头，单击各列的![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002140409296.png)，可按特定类型过滤显示主机的信息。 | | 切换主机排序 | 在主机列表的表头，单击"UniAgent心跳时间"列的![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002271799158.png)可切换主机的排序。![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002306358997.png "点击放大")为默认排序，![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002306432057.png "点击放大")为按时间正序排序（即最新的UniAgent心跳时间显示在最后方），![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002271742320.png)为按时间倒序排序（即最新的UniAgent心跳时间显示在最前方）。 | | 删除主机 | 当主机的UniAgent状态为离线、未安装或安装失败时，可删除主机。 单击主机名称及IP地址右侧对应的"删除"。 删除主机需要注意以下事项： - 安装中/升级中/卸载中的机器不能直接删除，请刷新页面等待状态更新后，再执行删除操作。 - 运行中的机器需要先卸载UniAgent才能删除。 - 安装机/代理机不能直接删除，请先取消相关设置。 | | 设置安装机 | 通过如下操作可以设置安装机的名称。 单击主机列表操作列的"设置安装机"，输入安装机的名称。 | | 取消安装机 | 当主机已设置了安装机，通过如下操作可取消设置。 单击主机列表操作列的" 取消安装机"，可取消原有的安装机。 | | 修改安装机名称 | 当主机已设置了安装机，通过如下操作可以修改安装机的名称。 单击安装机名称，在弹出的对话框中重命名安装机的名称。 | #### 安装时遇到的问题和解决方法 如果您在安装UniAgent时遇到问题，请参考[常见问题](https://support.huaweicloud.com/faq-aom2/aom_06_0022.html)处理。