更新时间:2025-08-29 GMT+08:00

安装UniAgent(新版)

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

AOM支持对本Region内的ECS云服务器或其他服务器主机安装UniAgent。
  • 本Region内:给区域内主机安装UniAgent,即给用户登录AOM服务控制台所在region区主机安装UniAgent。

前提条件

  • 明确需要安装UniAgent的服务器,以及准备各云服务器root权限的登录账号和密码。
  • 如果是通过中转机安装UniAgent,需确保中转机(已成功安装UniAgent的服务器)与待安装UniAgent的主机间网络互通。
  • 如果在此项目下还没有调用凭证AccessCode,需要先创建1个AccessCode,详情请参见创建AccessCode

约束与限制

  • 安装UniAgent支持的Linux操作系统与Windows操作系统,详情请参见操作系统使用限制
  • 如果您进入的是旧版虚机接入页面,需在左侧导航栏选择“设置 > 采集设置 > 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(本Region内)

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

    表2 安装参数说明表

    参数

    说明

    示例

    服务器所在Region

    选择待安装UniAgent的云服务器所在区域:

    • 本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 ************************* -d https://aom-uniagent-xxxxxx -m https://aom-mgr-lb. xxxxxx,https://xx.xx.xx.xx:xxxx -v 1.x.x  -q false && /usr/local/uniagentd/xxxx -p icagent -s install -c "{\"PROJECT_ID\":\"xxxxx\"}" -d https://icagent-xx-xxx/ICAgent_linux -v x.x.x -m "{\"accessip\":\"x.x.x.x\",\"aomaksk\":\"*******\",\"ltsaksk\":\"********\",\"obsdomain\":\"x.x.x.x\",\"region\":\"xxxx\"}"
        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://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. 选择“安装场景”为“控制台手动安装”。(仅“ECS 云服务器”页签中的主机支持通过控制台手动安装UniAgent。)
  6. 在安装UniAgent页面中,配置相关参数信息。

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

      参数

      说明

      示例

      服务器所在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 ************************* -d https://aom-uniagent-xxxxxx -m https://aom-mgr-lb. xxxxxx,https://xx.xx.xx.xx:xxxx -v 1.x.x  -q false && /usr/local/uniagentd/xxxx -p icagent -s install -c "{\"PROJECT_ID\":\"xxxxx\"}" -d https://icagent-xx-xxx/ICAgent_linux -v x.x.x -m "{\"accessip\":\"x.x.x.x\",\"aomaksk\":\"*******\",\"ltsaksk\":\"********\",\"obsdomain\":\"x.x.x.x\",\"region\":\"xxxx\"}"
          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://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,如果是,则自动被筛选出来,作为中转机。),并单击“下一步”。(仅安装模式选择“界面安装”时,需要执行。)

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

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

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

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

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

查看UniAgent状态

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

表4 UniAgent状态

状态

说明

运行中

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

离线

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

安装中

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

安装失败

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

未安装

表示服务器未安装UniAgent。

其他相关操作

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

表5 相关操作

操作

说明

搜索主机

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

刷新主机列表

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

设置主机展示列

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

切换排序

在主机列表的表头,单击各列的可切换主机排序。