文档首页/ 应用运维管理 AOM/ 用户指南/ 接入AOM/ 管理采集器底座UniAgent/ 安装UniAgent（新版）
更新时间：2025-07-01 GMT+08:00
查看PDF
分享

安装UniAgent（新版）

统一数据采集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的服务器，以及准备各云服务器root权限的登录账号和密码。
  • 如果是通过中转机安装UniAgent，需确保中转机（已成功安装UniAgent的服务器）与待安装UniAgent的主机间网络互通。
  • 如果在此项目下还没有调用凭证AccessCode，需要先创建1个AccessCode，详情请参见创建AccessCode。

约束与限制

  • 安装UniAgent支持的Linux操作系统与Windows操作系统，详情请参见操作系统使用限制。
  • 当前新版安装UniAgent功能受限开放，如有需求可以通过提交工单，为您开放此功能。
  • 如果您进入的是旧版虚机接入页面，需在左侧导航栏选择“设置 > 采集设置 > UniAgent管理”，单击“UniAgent管理”页面右上角“体验新版”进入新版安装UniAgent页面。如需返回旧版安装UniAgent，单击“UniAgent管理”页面右上角“返回旧版”按钮，进入旧版安装页面。
  • 如果待安装UniAgent的服务器中包含CCE集群托管的云服务器，建议您前往“K8s集群管理”页面安装UniAgent。

安装方式说明

AOM支持对主机安装UniAgent。UniAgent有以下几种安装方式，您可以按照实际场景进行选择。

表1 安装方式

方式

适用场景

脚本快速安装（推荐）

适用于首次安装、单机安装UniAgent场景。使用远程登录工具，登录待安装UniAgent的服务器，手动执行安装命令去安装UniAgent，详情请参见：

控制台手动安装

适用于在AOM控制台批量安装UniAgent场景。同一虚拟私有云中，在AOM控制台中通过中转机（一台已安装UniAgent的服务器）批量为其他ECS云服务器安装UniAgent。详情请参见：控制台手动安装UniAgent（本Region内）。

该场景必须有一台已经装了UniAgent的服务器，如果是首次安装UniAgent，需要通过脚本快速安装方式进行安装。

中转机脚本安装

适用于通过在中转机上执行脚本安装UniAgent场景。使用远程登录工具，登录中转机（一台已成功安装UniAgent的服务器），然后在该中转机上执行脚本，为一个或多个服务器安装UniAgent：

该场景必须有一台已经装了UniAgent的服务器，如果是首次安装UniAgent，需要通过脚本快速安装方式进行安装。

脚本快速安装UniAgent（本Region内）

  1. 登录AOM 2.0控制台。
  2. 在左侧导航栏选择“设置 > 全局设置”，进入全局设置页面。
  3. 在全局设置页面选择“采集设置 > UniAgent管理”，并单击页面右上角“体验新版”。
  4. 进入新版UniAgent管理页面后，默认进入“ECS 云服务器”页签，单击“安装UniAgent”。
  5. 选择“安装场景”为“脚本快速安装（推荐）”。（“其他服务器”页签中的服务器仅支持通过脚本快速安装方式来安装UniAgent，单击该页签的“安装UniAgent”后，无需选择安装场景，直接进入安装UniAgent页面。）
  6. 在安装UniAgent页面中，配置相关安装UniAgent参数信息。

    图1 安装UniAgent
    表2 安装参数说明表

    参数

    说明

    示例

    服务器所在Region

    选择待安装UniAgent的云服务器所在区域支持以下两种：

    • 本Region内：云服务器所在区域与当前AOM服务端在同一区域，默认云服务器与AOM服务端网络互通。
    • 本Region外：云服务器所在区域与当前AOM服务端不在同一区域，跨区域的云服务器默认与AOM服务端网络不通，需要根据场景选择合适的网络联通方案。

    本Region内

    服务器类型
    选择云服务器类型支持以下两种：
    • ECS云服务器：ECS云服务器管理下的主机。
    • 其他服务器：其他服务器管理下的主机。

    ECS云服务器

    选择安装模式

    选择安装模式当前仅支持命令行安装。

    控制台会提供安装命令，您需要远程登录机器执行安装命令。

    命令行安装

    云服务器操作系统

    选择云服务器操作系统，当前支持Linux和Windows。

    Linux

    UniAgent版本

    选择待安装的UniAgent版本，默认最新版本。

    最新版本

    复制并执行安装命令

    安装UniAgent的命令，分为Linux和Windows：

    • 云服务器操作系统设置为“Linux”：
      1. 单击“复制命令”，复制以下安装命令 
        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 ************************* -v 1.x.x -e xxxx -y ***********************************
set -o history;
      2. 使用远程登录工具，登录待安装UniAgent的Linux操作系统服务器，并以root权限执行复制的安装命令。

      当UniAgent和ICAgent都没安装时，执行以上安装命令可同时安装UniAgent和ICAgent；如果安装了UniAgent或ICAgent中的其中一个，则执行以上安装命令可以安装另一个。

    • 云服务器操作系统设置为“Windows”（此种方式只支持安装UniAgent）：
      1. 登录待安装UniAgent的Window操作系统服务器。
      2. 下载安装包：uniagentd-x.x.x.x-winxx.zip。

        如果用户需要校验windows安装包的sha256的值，可以下载https://aom-uniagent-{region_name}.obs.{region_name}.{Site domain name suffix}/uniagentd-{version}-win32.zip.sha256文件查看。

      3. 解压后，点击uniagentd.msi，指定安装路径为C:\uniagentd。
      4. 修改C:\uniagentd\conf\uniagentd.conf文件，填入以下的配置（可选，仅安装1.1.3或以前的版本才需要执行该步骤）：

        master=https://xxxxxx.xxxxxxxxxxx,https://xx.xx.xx.xx:xxxxx

        project_id=xxxxxxxxxxxxxx

        public_net=xxxx

        可单击“复制命令”，直接复制以上配置信息。

      5. 管理员身份执行：C:\uniagentd\bin\start.bat启动程序。

    复制并执行安装命令

  7. 安装完成后，可在UniAgent列表中查看UniAgent状态。

脚本快速安装UniAgent（本Region外）

  1. 登录AOM 2.0控制台。
  2. 在左侧导航栏选择“设置 > 全局设置”，进入全局设置页面。
  3. 在全局设置页面选择“采集设置 > UniAgent管理”，并单击页面右上角“体验新版”。
  4. 进入新版UniAgent管理页面后，默认进入“ECS 云服务器”页签，单击“安装UniAgent”。
  5. 选择“安装场景”为“脚本快速安装（推荐）”。（“其他服务器”页签中的服务器仅支持通过脚本快速安装方式来安装UniAgent，单击该页签的“安装UniAgent”后，无需选择安装场景，直接进入安装UniAgent页面。）
  6. 在安装UniAgent页面中，配置相关安装UniAgent参数信息。

    图2 安装UniAgent
    表3 安装参数说明表

    参数

    说明

    示例

    服务器所在Region

    选择待安装UniAgent的云服务器所在区域支持以下两种：

    • 本Region内：云服务器所在区域与当前AOM服务端在同一区域，默认云服务器与AOM服务端网络互通。
    • 本Region外：云服务器所在区域与当前AOM服务端不在同一区域，跨区域的云服务器默认与AOM服务端网络不通，需要根据场景选择合适的网络联通方案。

    本Region外

    云服务器操作系统

    选择云服务器操作系统，当前支持Linux和Windows。

    Linux

    网络连通方式

    选择网络连通方式，当前仅支持公网。支持公网的区域为：华北-北京四、华东-上海一、华东-上海二、华南-广州区域。

    区域外主机与公网连通后，就可以通过公网将数据上传到服务端。

    公网

    复制并执行安装命令

    安装UniAgent的命令，分为Linux和Windows：

    • 云服务器操作系统设置为“Linux”：
      1. 单击“复制命令”，复制以下安装命令： 
        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 ************************* -e ******** -y ***********************************
set -o history;
      2. 使用远程登录工具，登录待安装UniAgent的Linux操作系统服务器，并以root权限执行复制的安装命令。

      当UniAgent和ICAgent都没安装时，执行以上安装命令可同时安装UniAgent和ICAgent；如果安装了UniAgent或ICAgent中的其中一个，则执行以上安装命令可以安装另一个。

    • 云服务器操作系统设置为“Windows”（此种方式只支持安装UniAgent）：
      1. 登录待安装UniAgent的Window操作系统服务器。
      2. 下载安装包：uniagentd-x.x.x.x-winxx.zip。

        如果用户需要校验windows安装包的sha256的值，可以下载https://aom-uniagent-{region_name}.obs.{region_name}.{Site domain name suffix}/uniagentd-{version}-win32.zip.sha256文件查看。

      3. 解压后，点击uniagentd.msi，指定安装路径为C:\uniagentd。
      4. 修改C:\uniagentd\conf\uniagentd.conf文件，填入以下的配置（以下信息均可在安装界面获取）：

        master=https://xxx.xx.xxx.xxx:xxxxx

        project_id=******************

        public_net=xxx

      5. 以管理员身份执行：C:\uniagentd\bin\start.bat启动程序。

    复制并执行安装命令

  7. 安装完成后，可在UniAgent列表中查看UniAgent状态。

控制台手动安装UniAgent（本Region内）

  1. 登录AOM 2.0控制台。
  2. 在左侧导航栏选择“设置 > 全局设置”，进入全局设置页面。
  3. 在全局设置页面选择“采集设置 > UniAgent管理”，并单击页面右上角“体验新版”。
  4. 进入新版UniAgent管理页面后，默认进入“ECS 云服务器”页签，单击“安装UniAgent”。
  5. 选择“安装场景”为“控制台手动安装”。（仅“ECS 云服务器”页签中的主机支持通过控制台手动安装UniAgent。）
  6. 在安装UniAgent页面中，配置相关参数信息。

    1. 配置基本信息，并选择服务器，单击“下一步”。
      图3 配置基本信息
      表4 安装参数说明表

      参数

      说明

      示例

      服务器所在Region

      待安装UniAgent的云服务器所在区域仅支持“本Region内”。

      云服务器所在区域与当前AOM服务端在同一区域，默认云服务器与AOM服务端网络互通。

      本Region内

      服务器类型

      云服务器类型仅支持ECS云服务器。

      ECS云服务器

      选择安装模式

      安装模式当前支持命令行安装和界面安装。

      界面安装

      云服务器操作系统

      操作系统支持Linux和Windows。（仅安装模式选择“命令行安装”时，需要设置。）

      Linux

      UniAgent版本

      选择待安装的UniAgent版本，默认最新版本。

      最新版本

      复制并执行安装命令

      安装UniAgent的命令，分为Linux和Windows（仅安装模式选择“命令行安装”时，需要执行。）：

      • 云服务器操作系统设置为“Linux”：
        1. 单击“复制命令”，复制以下安装命令 
          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 ************************* -v 1.x.x -e xxxx -y ***********************************
set -o history;
        2. 使用远程登录工具，登录待安装UniAgent的Linux操作系统服务器，并以root权限执行复制的安装命令。

        当UniAgent和ICAgent都没安装时，执行以上安装命令可同时安装UniAgent和ICAgent；如果安装了UniAgent或ICAgent中的其中一个，则执行以上安装命令可以安装另一个。

      • 云服务器操作系统设置为“Windows”（此种方式只支持安装UniAgent）：
        1. 登录待安装UniAgent的Window操作系统服务器。
        2. 下载安装包：uniagentd-x.x.x.x-winxx.zip。

          如果用户需要校验windows安装包的sha256的值，可以下载https://aom-uniagent-{region_name}.obs.{region_name}.{Site domain name suffix}/uniagentd-{version}-win32.zip.sha256文件查看。

        3. 解压后，点击uniagentd.msi，指定安装路径为C:\uniagentd。
        4. 修改C:\uniagentd\conf\uniagentd.conf文件，填入以下的配置（可选，仅安装1.1.3或以前的版本才需要执行该步骤）：

          master=https://xxxxxx.xxxxxxxxxxx,https://xx.xx.xx.xx:xxxxx

          project_id=xxxxxxxxxxxxxx

          public_net=xxxx

          可单击“复制命令”，直接复制以上配置信息。

        5. 管理员身份执行：C:\uniagentd\bin\start.bat启动程序。

      复制并执行安装命令

      选择服务器
      单击“添加服务器”，在弹出框中选择待安装UniAgent的云服务器。（仅安装模式选择“界面安装”时，需要设置。）
      • 在“添加服务器”页面勾选一个或多个已有的云服务器。仅支持选择Linux操作系统的云服务器。
      • 选择完云服务器后，可以执行如下操作：
        • 如果需要去掉所选服务器，可单击“移除”。
        • 通过服务器ID或服务器名称等信息对列表进行过滤。
        • 单击，通过选中/取消选中各展示项前的复选框，自定义列表项的展示/隐藏。
        • 单击，手工刷新服务器列表。

      选择服务器
    2. 检查上一步选择的服务器所属虚拟私有云下，是否已配置了中转机（即检查同一虚拟私有云下，是否有服务器安装了UniAgent，如果是，则自动被筛选出来，作为中转机。），并单击“下一步”。（仅安装模式选择“界面安装”时，需要执行。）
      图4 检查中转机

      在“检查中转机”页面您还可以执行如下操作：

      • 如果虚拟私有云下有多台服务器安装了UniAgent，可根据实际需求单击该虚拟私有云的操作列“更换中转机”，在弹出框中选择适合的主机作为中转机。
      • 如果虚拟私有云下没有服务器安装UniAgent，可单击该虚拟私有云的操作列“配置中转机”，复制安装命令，然后在一台服务器上手动执行安装命令去安装UniAgent，将其定义为中转机。
      • 通过“虚拟私有云”或“中转机配置”对列表进行过滤查询。
      • 单击，通过选中/取消选中各展示项前的复选框，自定义列表项的展示/隐藏。
      • 单击，手工刷新中转机列表。
    3. 进行连通性测试。（仅安装模式选择界面安装时，需要执行。）
      1. 在服务器所在“账号（具备root权限）”、“密码”、以及“端口”列分别配置登录该服务器具有root权限的账号和密码，以及端口号。
      2. 单击“操作”列的“测试”。

      如果多个服务器具有相同root权限的账号、密码、以及端口号，可勾选服务器前的复选框，并单击“批量配置登录账号和密码”批量填充root账号、密码、已经端口号，然后单击“批量测试”

    4. 连通性测试成功后，单击“完成安装”。

  7. 安装完成后，可在UniAgent列表中查看查看UniAgent状态。

通过中转机执行脚本安装UniAgent（单机安装）

一台已成功安装UniAgent的服务器作为中转机，在该中转机上执行脚本，为另一个服务器远程安装UniAgent。

  • 前提条件：确保中转机（已成功安装UniAgent的服务器）与待安装UniAgent的服务器主机间网络互通，且ssh命令可执行。
  • 操作步骤：
    1. 使用远程登录工具，以root权限用户登录中转机（一台已成功安装UniAgent的服务器作为中转机），执行以下命令： 
      bash /usr/local/uniagentd/bin/remote_cmd.sh -ip x.x.x.x -command "安装命令"
      • x.x.x.x：表示待安装UniAgent的服务器IP地址。
      • 安装命令：表示安装UniAgent的安装命令，可从AOM控制台的安装界面复制安装命令，然后替换以上命令行中的安装命令。（复制安装命令时不要包含“set +o history;”和“set -o history;”。）
    2. 根据提示输入待安装UniAgent的服务器root权限用户的密码。

      当显示“UniAgent install success”时，表示安装成功，UniAgent已安装在了“/usr/local/uniagentd”目录。安装成功后，在AOM控制台左侧导航栏中选择“采集设置 > UniAgent管理”，查看该服务器的UniAgent状态。

通过中转机执行脚本安装UniAgent（批量安装）

一台已成功安装UniAgent的服务器作为中转机，在该中转机上执行脚本，批量为其他服务器远程安装UniAgent。

  • 前提条件：
    • 确保中转机（已成功安装UniAgent的服务器）与待安装UniAgent的主机间网络互通，且ssh命令可执行。
    • 已收集需要安装UniAgent的所有服务器IP、root权限用户的密码，并按照iplist.cfg格式整理好，上传到中转机的/usr/local/uniagentd目录下（该目录可自定义，但需确保与下方安装操作步骤中执行安装命令的目录一致）。iplist.cfg格式示例如下所示（IP与密码之间只能用一个空格隔开，其他位置不能包含空格）： 
      192.168.0.109 密码（请根据实际填写）
192.168.0.39 密码（请根据实际填写）

      iplist.cfg中包含您的敏感信息，建议您使用后清理。

  • 操作步骤：
    1. 使用远程登录工具，以root权限用户登录中转机（一台已成功安装UniAgent的服务器）。
    2. 执行以下命令： 
      bash /usr/local/uniagentd/bin/remote_cmd.sh -batchModeConfig /usr/local/uniagentd/iplist.cfg -command "安装命令"

      安装命令：表示安装UniAgent的安装命令，可从AOM控制台的安装界面复制安装命令，然后替换以上命令行中的安装命令。（复制安装命令时不要包含“set +o history;”和“set -o history;”。）

      当显示“UniAgent install success”时，表示安装成功，UniAgent已安装在了“/usr/local/uniagentd”目录。安装成功后，在AOM控制台左侧导航栏中选择“采集设置 > UniAgent管理”，查看该服务器的UniAgent状态。

查看UniAgent状态

在“UniAgent管理”页面查看目标主机的UniAgent状态，详细请参见表4 UniAgent状态说明。

表5 UniAgent状态

状态

说明

运行中

表示服务器安装的UniAgent运行正常。

离线

表示服务器安装的UniAgent功能异常。

安装中

表示该服务器正在安装UniAgent。安装UniAgent预计需要1分钟左右，请耐心等待。

安装失败

表示服务器安装UniAgent失败，请卸载UniAgent后，并重新安装。

未安装

表示服务器未安装UniAgent。

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

其他相关操作

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

表6 相关操作

操作

说明

搜索主机

在主机列表上方的搜索框，可以通过服务器ID，服务器名称，运行状态，IP地址来搜索对应主机。

刷新主机列表

单击主机列表右上角的按钮，可刷新主机列表信息。

设置主机展示列

单击主机列表右上角的按钮，可对已接入的主机展示列进行设置。

切换排序

在主机列表的表头，单击各列的可切换主机排序。为默认排序，为按正序排序，为按倒序排序。

安装时遇到的问题和解决方法

如果您在安装UniAgent时遇到问题，请参考常见问题处理。