Agent安装说明
安装云监控插件后,可以为用户提供主机的系统级、主动式、细颗粒度的监控服务。本章节主要为您介绍在控制界面安装/升级、单台主机下安装、批量安装Agent的操作方法。
在控制台界面安装/升级Agent
安装&升级插件、手动安装和远程安装任务提交后,即可在“任务中心”页面的“Agent维护”页签查看。

单台主机下安装Agent
目前只支持Linux操作系统和Windows操作系统。支持的系统请参见Agent支持的系统有哪些?。
前提条件
- 已配置DNS和安全组,配置方法参考如何配置DNS和安全组?。
- 已配置委托,配置方法参考如何配置委托?。
- 确保操作步骤中的安装目录都有读写权限,并且安装成功后的Telescope进程不会被其他软件关闭。
- 确保已下载Agent安装脚本,获取脚本的方式如下:
操作步骤
- 使用root账号,登录主机。
- 执行以下命令,安装Agent,安装脚本分为agent_install.sh和agentInstall.sh,分别对应以下两种命令。
cd /usr/local && curl -k -O ${download_url} && bash agent_install.sh -u 0.2.1 -t ${version} -r ${regionID}
老架构Agent:
cd /usr/local && curl -k -O ${download_url} && bash agentInstall.sh
将${download_url} 替换成表2中的下载路径,将${version}替换成Agent版本特性中的版本,将${regionID}替换成表2中的regionID。例如,用北京一下载地址替换${download_url},对应的安装命令为:
cd /usr/local && curl -k -O https://obs.cn-north-1.myhuaweicloud.com/uniagent-cn-north-1/package/agent_install.sh && bash agent_install.sh -u 0.2.1 -t 2.7.5 -r cn-north-1
命令执行完成时,输出Telescope process starts successfully.则代表安装成功。
- 执行如下命令,清除安装脚本。
if [[ -f /usr/local/uniagent/extension/install/telescope/bin/telescope ]]; then rm /usr/local/agent_install.sh; else rm /usr/local/agentInstall.sh; fi
说明:
Agent插件配置完成后,因监控数据暂未上报,插件状态仍显示“未安装”,等待3-5分钟,刷新即可。
前提条件
- 已配置DNS和安全组,配置方法参考如何配置DNS和安全组?。
- 已配置委托,配置方法参考如何配置委托?。
- 使用具有administrator权限的账户安装,例如administrator用户,并且确保安装成功后的Telescope进程不会被其他软件关闭。
- 已获取Agent安装包,格式为exe/zip,安装包获取方式如下。
操作步骤
- 使用具有“管理员”权限的账号(例如,administrator)登录Windows弹性云服务器。
- 在浏览器地址栏输入表3中的下载路径,下载并保存安装包。
- 进入安装包存放目录。
- 根据安装包的格式选择相应的操作方式进行插件安装。
- 若安装包为zip格式
如果安装包是telescope_windows_amd64.zip,解压zip安装包后双击执行“install.bat”脚本,安装启动Agent。
- 若安装包为exe格式
如果安装包是“install_amd64.exe”,则执行以下步骤:
- 打开Windows PowerShell。
- 执行以下命令,进入安装包存放路径(存放路径以"C:\Users\Administrator\Downloads"为例,执行命令时请修改为您机器上安装包存放的路径)。
cd C:\Users\Administrator\Downloads
- 执行以下命令,安装插件(执行时需将${version}替换成Agent版本特性中的版本,请根据版本特性按需选择安装版本。
.\install_amd64.exe -u 0.2.1 -t ${version}
例如选择安装2.7.5版本,对应的安装命令为:".\install_amd64.exe -u 0.2.1 -t 2.7.5"。说明:
Agent插件配置完成后,因监控数据暂未上报,插件状态仍显示“未安装”,等待3-5分钟,刷新即可。
- 若安装包为zip格式
前提条件
- 已配置DNS和安全组,配置方法参考如何配置DNS和安全组?。
- 已配置委托,配置方法参考如何配置委托?。
- 确保操作步骤中的安装目录都有读写权限,并且安装成功后的Telescope进程不会被其他软件关闭。
- 确保已下载Agent安装脚本,获取脚本的方式如下:
操作步骤
- 使用root账号,登录主机。
- 执行以下命令,安装Agent,安装脚本分为agent_install.sh和agentInstall.sh,分别对应以下两种命令。
cd /usr/local && curl -k -O ${download_url} && bash agent_install.sh -u 0.2.1 -t ${version} -r ${regionID}
老架构Agent:
cd /usr/local && curl -k -O ${download_url} && bash agentInstall.sh
将${download_url} 替换成表2中的下载路径,将${version}替换成Agent版本特性中的版本,将${regionID}替换成表2中的regionID。例如,用北京一下载地址替换${download_url},对应的安装命令为:
cd /usr/local && curl -k -O https://obs.cn-north-1.myhuaweicloud.com/uniagent-cn-north-1/package/agent_install.sh && bash agent_install.sh -u 0.2.1 -t 2.7.5 -r cn-north-1
命令执行完成时,输出Telescope process starts successfully.则代表安装成功。
- 执行如下命令,清除安装脚本。
if [[ -f /usr/local/uniagent/extension/install/telescope/bin/telescope ]]; then rm /usr/local/agent_install.sh; else rm /usr/local/agentInstall.sh; fi
说明:
Agent插件配置完成后,因监控数据暂未上报,插件状态仍显示“未安装”,等待3-5分钟,刷新即可。
前提条件
- 已配置DNS和安全组,配置方法参考如何配置DNS和安全组?。
- 已配置委托,配置方法参考如何配置委托?。
- 使用具有administrator权限的账户安装,例如administrator用户,并且确保安装成功后的Telescope进程不会被其他软件关闭。
- 已获取Agent安装包,格式为exe/zip,安装包获取方式如下。
操作步骤
- 使用具有“管理员”权限的账号(例如,administrator)登录Windows弹性云服务器。
- 在浏览器地址栏输入表3中的下载路径,下载并保存安装包。
- 进入安装包存放目录。
- 根据安装包的格式选择相应的操作方式进行插件安装。
- 若安装包为zip格式
如果安装包是telescope_windows_amd64.zip,解压zip安装包后双击执行“install.bat”脚本,安装启动Agent。
- 若安装包为exe格式
如果安装包是“install_amd64.exe”,则执行以下步骤:
- 打开Windows PowerShell。
- 执行以下命令,进入安装包存放路径(存放路径以"C:\Users\Administrator\Downloads"为例,执行命令时请修改为您机器上安装包存放的路径)。
cd C:\Users\Administrator\Downloads
- 执行以下命令,安装插件(执行时需将${version}替换成Agent版本特性中的版本,请根据版本特性按需选择安装版本。
.\install_amd64.exe -u 0.2.1 -t ${version}
例如选择安装2.7.5版本,对应的安装命令为:".\install_amd64.exe -u 0.2.1 -t 2.7.5"。说明:
Agent插件配置完成后,因监控数据暂未上报,插件状态仍显示“未安装”,等待3-5分钟,刷新即可。
- 若安装包为zip格式
批量安装Agent
Linux操作系统支持对多台主机批量安装Agent。
- 批量安装不支持跨区域执行。
- 批量安装的主机需同属一个VPC。
- Windows版本暂不支持批量安装Agent。
前提条件
- 已配置DNS和安全组,配置方法参考如何配置DNS和安全组?。
- 已配置委托,配置方法参考如何配置委托?。
- 确保操作步骤中的安装目录都有读写权限,并且安装成功后的Telescope进程不会被其他软件关闭。
- 登录方式为账号密码:已收集需要安装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
- 确保已下载Agent安装包,获取包的方式如下:
操作步骤
- 使用ssh以root用户登录到已安装Agent的主机中。
- 批量安装Agent,分别对应下面两种安装命令。
当获取到的Agent安装脚本为batch_agent_install.sh时,执行以下命令:
cd /usr/local && curl -k -O ${download_url} && bash batch_agent_install.sh -u 0.2.1 -t ${version}
当获取到的Agent安装脚本为agentBatchPackage.sh时,执行以下命令:
cd /usr/local && curl -k -O ${download_url} && bash agentBatchPackage.sh
将安装命令中的${download_url}替换成表4中的下载路径,将${version}替换成Agent版本特性中的版本。
例如,在北京一的安装命令为:
cd /usr/local && curl -k -O https://obs.cn-north-1.myhuaweicloud.com/uniagent-cn-north-1/script/batch_agent_install.sh && bash batch_agent_install.sh -u 0.2.1 -t 2.7.5
- 安装完成后,登录云监控服务管理控制台,单击左侧导航栏的“主机监控”。