文档首页/ 云监控服务 CES/ 用户指南/ 云资源监控/ 主机监控/ 云监控插件（Agent）/ Agent安装
更新时间：2025-08-06 GMT+08:00
查看PDF
分享

Agent安装

云监控插件可用于采集目标主机操作系统层面上的监控指标数据，并上报给云监控服务做数据统计。这些数据可以通过可视化的图表形式呈现，帮助您及时了解动态监控指标，同时您也可以对重要监控指标设置告警规则，以便及时发现问题。

安装云监控插件后，可以为用户提供主机的系统级、主动式、细颗粒度的监控服务。本章节主要为您介绍全量自动化安装、自定义自动化安装、单台主机下手动安装、批量手动安装Agent的操作方法。

适用场景

表1 适用场景

安装方式

适用场景

约束与限制

全量自动化安装Agent

云监控服务支持控制台一键安装云监控插件功能。若您想对主机监控列表中所有主机资源安装云监控插件，推荐您先通过云监控服务控制台全量自动化安装功能，自动为所有支持一键安装的主机资源安装云监控插件。

安装完成后，再通过手动安装插件的方式为不支持一键安装和自动安装失败的主机资源安装插件。

目前主流的操作系统已经支持了一键安装功能。支持Agent一键安装的系统请参考Agent支持的系统有哪些？

自定义自动化安装Agent

云监控服务支持控制台一键安装云监控插件功能。若您只需要为部分主机资源安装云监控插件，并且主机资源已支持一键安装，推荐您通过云监控服务控制台相关功能，自动为指定主机资源安装云监控插件。

单台主机下手动安装Agent

当主机资源不支持一键安装或使用一键安装功能安装失败时，可以通过手动方式安装Agent。

支持Agent一键安装的系统请参考Agent支持的系统有哪些？

无。

批量手动安装Agent

若您有多个同属于一个VPC的Linux操作系统的主机资源需要安装云监控插件，并且主机资源不支持一键安装，可以通过批量安装插件功能，同时为多台主机手动安装插件。

  • 批量远程安装Agent：在控制台录入主机资源的IP地址、端口、root账号的密码或密钥等信息，通过控制台下发安装指令进行批量安装。
  • 登录主机批量安装Agent：登录用户主机资源，手动执行批量安装命令，进行Agent安装。
  • 只支持linux操作系统的主机。
  • 待批量安装的主机资源属于同一个VPC。

全量自动化安装Agent

前提条件

操作步骤

  1. 登录云监控服务管理控制台。
  2. 单击“主机监控 > 弹性云服务器”，进入主机监控页面。
  3. 单击主机列表上方“安装&升级插件 > 全量安装&升级插件”，在右侧弹出安装&升级插件指引。
    图1 全量安装&升级插件
  4. 根据页面安装指引安装插件。
    1. 根据需要选择安装插件的方式：
      • 所有主机安装并升级到最新版：此次操作会为主机列表中所有支持一键安装但还未安装Agent插件的实例安装Agent，并为列表中所有安装过Agent插件的实例进行升级操作。
      • 只对没有安装的主机进行安装：此次操作会为主机列表中所有支持一键安装但还未安装Agent插件的实例安装Agent。
      • 只对安装过的主机进行升级：此次操作只针对安装过Agent插件的实例进行升级操作。
    2. 选择插件版本：
      • 基础版：提供基础操作系统监控指标，包括CPU、内存、文件系统、磁盘、网卡、网络等多类监控指标。
      • 增强版：除提供基础版能力外，还将提供：GPU监控能力、BMS硬件故障监控能力。

      增强版由于采集指标更多，可能会占用更多的主机资源，请合理选择插件。

  5. 单击“确定”启动安装插件。
  6. 查看Agent安装结果。
    1. 单击页面左侧的“任务中心”。
    2. 在任务中心页面，单击“Agent维护”页签，可以查看Agent任务状态。
      • 若“任务状态”为“成功”，表示Agent安装成功，进入主机监控页面，可以看到目标实例插件状态为运行中，插件版本为最新版本。
      • 若“任务状态”为“超时”，可通过操作列的“重试”重新执行该任务。

自定义自动化安装Agent

前提条件

操作步骤

  1. 登录云监控服务管理控制台。
  2. 单击“主机监控 > 弹性云服务器”，进入主机监控页面。
  3. 在列表中勾选待安装插件的主机，单击“安装&升级插件 > 批量安装&升级插件”，在右侧弹出安装&升级插件指引。
    图2 批量安装&升级插件
  4. 在批量修改页面可以查看操作对象，当系统检测出有不可执行对象时，请参见批量安装&升级插件时，为什么提示无法执行，查看解决方案。
  5. 单击下一步，进入安装&升级插件页面。
    1. 根据需要选择安装插件的方式：
      • 所有主机安装并升级到最新版：此次操作会为主机列表中所有支持一键安装但还未安装Agent插件的实例安装Agent，并为列表中所有安装过Agent插件的实例进行升级操作。
      • 只对没有安装的主机进行安装：此次操作会为主机列表中所有支持一键安装但还未安装Agent插件的实例安装Agent。
      • 只对安装过的主机进行升级：此次操作只针对安装过Agent插件的实例进行升级操作。
    2. 选择插件版本：
      • 基础版：提供基础操作系统监控指标，包括CPU、内存、文件系统、磁盘、网卡、网络等多类监控指标。
      • 增强版：除提供基础版能力外，还将提供：GPU监控能力、BMS硬件故障监控能力。

      增强版由于采集指标更多，可能会占用更多的主机资源，请合理选择插件。

  6. 单击“确定”启动安装插件。
  7. 查看Agent安装结果。
    1. 单击页面左侧的“任务中心”。
    2. 在任务中心页面，单击“Agent维护”页签，可以查看Agent任务状态。
      • 若“任务状态”为“成功”，表示Agent安装成功，进入主机监控页面，可以看到目标实例插件状态为运行中，插件版本为最新版本。
      • 若“任务状态”为“超时”，可通过操作列的“重试”重新执行该任务。

单台主机下手动安装Agent

前提条件

  • 已配置DNS和安全组，配置方法参考如何配置DNS和安全组？。
  • 已配置委托，配置方法参考如何配置委托？。
  • 确保操作步骤中的安装目录都有读写权限，并且安装成功后的Telescope进程不会被其他软件关闭（Linux操作系统使用root用户，Windows操作系统使用Administrator用户）。

    云监控仅支持通过管理员账号权限操作云监控插件。使用管理员账号具有一定风险，如果操作不当可能导致系统稳定性问题或数据安全问题，请谨慎操作。

操作步骤

  1. 登录云监控服务管理控制台。
  2. 单击“主机监控 > 弹性云服务器”，进入主机监控页面。
  3. 单击主机列表上方“手动安装”，在右侧弹出安装插件指引。
    图3 安装插件指引
  4. 获取安装命令：
    1. 选择操作系统：选择需要安装Agent的主机资源的操作系统类型。
    2. 选择安装方式：选择“单台安装”。
    3. 复制安装命令：单击安装命令后的，复制生成的安装命令。
  5. 登录主机。

    主机资源操作系统为Linux时，登录方式请参考，主机资源操作系统为Windows时，登录方式请参见Windows ECS登录方式概述。

  6. 登录成功后，执行步骤4获取的安装命令安装Agent。
    • Linux系统：以“root”用户执行安装命令；
    • Windows系统：以“Administrator”用户执行安装命令。
  7. 查看插件安装结果。
    • Linux系统：命令执行完成后，输出“Telescope process starts successfully.”则代表安装成功。等待3-5分钟插件即可正常采集监控数据。
    • Windows系统：当目标主机的插件状态显示“运行中”，说明Agent安装成功并启动。

批量手动安装Agent

当多个同属于一个VPC的Linux操作系统的主机资源需要安装云监控插件，并且主机资源不支持一键安装时，可以选择批量安装插件。

约束与限制
  • 批量安装不支持跨区域执行。
  • 批量安装的主机需同属一个VPC。
  • Windows版本暂不支持批量安装Agent。

前提条件

  • 已配置DNS和安全组，配置方法参考如何配置DNS和安全组？。
  • 已配置委托，配置方法参考如何配置委托？。
  • 在一个虚拟私有云下，确保有一台主机已经安装了Agent。
  • 已获取所有主机的root登录密码或登录密钥。

在控制台录入主机资源的IP地址、端口、root账号的密码或密钥等信息，通过控制台下发安装指令进行批量安装。

  1. 登录云监控服务管理控制台。
  2. 单击“主机监控 > 弹性云服务器”，进入主机监控页面。
  1. 单击“远程安装”，在右侧弹出远程安装指南。
  2. 根据页面安装指引安装Agent插件。
    1. 选择插件版本：
      • 基础版：提供基础操作系统监控指标，包括CPU、内存、文件系统、磁盘、网卡、网络等多类监控指标。
      • 增强版：除提供基础版能力外，还将提供：GPU监控能力、BMS硬件故障监控能力。
    2. 选择安装机。
      • 在一个虚拟私有云下，选择一台已经装了Agent的主机，将其定义为安装机。安装机将作为中间桥梁安装Agent到同一个虚拟私有云下的其他主机。如果之前没有设置安装机，可以在主机监控列表“操作”列，点击更多下的“设置安装机”进行设置。
      • 如果待安装Agent的虚拟私有云下没有主机安装了Agent，您可以通过单台主机下手动安装Agent方式，选择一台主机手动安装Agent。
    3. 配置需要安装插件的主机信息，参数说明请参考表2。
    图4 远程安装
    表2 主机信息配置

    参数

    参数说明

    取值样例

    主机IP

    需要远程安装Agent插件的主机IP地址。

    192.168.72.229

    登录账号

    远程安装Agent时登录主机的账号，默认为root，不支持修改。

    root

    登录端口

    远程登录主机的端口号，默认使用22端口。如需修改远程登录端口请参见怎样修改远程登录的端口。

    22

    认证方式

    登录主机时的认证方式，支持选择密码或密钥。

    密钥

    密码/密钥

    输入登录主机时的密码或者密钥。

    密钥样例：

    -----BEGIN RSA PRIVATE KEY-----

    ******

    -----END RSA PRIVATE KEY-----

    操作

    对配置的主机信息进行操作，支持删除和复制操作。

    复制
  3. 配置完成后，单击“确定”，启动安装。
  4. 查看Agent安装结果。
    1. 单击页面左侧的“任务中心”。
    2. 在任务中心页面，单击“Agent维护”页签，可以查看Agent任务状态。
      • 若“任务状态”为“成功”，表示Agent安装成功，进入主机监控页面，可以看到目标实例插件状态为运行中，插件版本为最新版本。
      • 若“任务状态”为“超时”，可通过操作列的“重试”重新执行该任务。

在一个虚拟私有云下，选择并登录一台已经装了Agent的主机资源，手动执行批量安装命令，进行Agent安装。

  1. 登录云监控服务管理控制台。
  2. 单击“主机监控 > 弹性云服务器”，进入主机监控页面。
  3. 单击主机列表上方“手动安装”，在右侧弹出安装插件指引。
  4. 获取安装命令：
    1. 选择操作系统：选择“Linux”。
    2. 选择安装方式：选择“批量安装”。
    3. 复制安装命令：单击执行安装命令后的，复制生成的安装命令。
      图5 获取批量安装插件命令
  5. 使用root用户登录已安装Agent的主机。

    登录方式请参考Linux ECS登录方式概述。

  6. 登录成功后，根据登录方式上传文件。
    • 登录方式为账号密码：已收集需要安装Agent的所有主机的IP地址和root用户密码，按照iplist.txt格式整理好，并上传到第一台机器的/usr/local目录下

      iplist.txt格式为“IP地址,root用户密码”，每个保持一行。

      示例如下所示（样例中abcd为密码，请按实际值填写）。

      192.168.1.1,abcd
192.168.1.2,abcd
    • 登录方式为密钥：已收集需要安装Agent的所有ECS的IP地址，按照iplist.txt格式整理好，并上传到第一台机器的/usr/local目录下，上传密钥文件user.pem到ECS的/usr/local目录下。

      iplist.txt格式为“IP地址”，每个保持一行。

      示例如下所示：

      192.168.1.1
192.168.1.2
  7. 手动执行步骤4获取的命令，批量安装Agent。
  8. 查看插件安装结果。

    命令执行完成后，输出“install successfully.”则代表安装成功，等待3-5分钟插件即可正常采集监控数据。

相关文档

Agent各种状态说明及异常状态处理方法

Agent安装成功后管理控制台没有操作系统监控数据或者显示数据滞后

父主题： 云监控插件（Agent）