Agent安装说明
安装云监控插件后，可以为用户提供主机的系统级、主动式、细颗粒度的监控服务。本章节主要为您介绍在控制界面安装/升级、单台主机下安装、批量安装Agent的操作方法。
在控制台界面安装/升级Agent
云监控控制台支持为弹性云服务器一键安装/升级Agent插件，为用户提供更加便捷的安装方式，请根据需要选择合适的安装方式。支持Agent一键安装的系统请参考Agent支持的系统有哪些？
通常情况下，推荐您通过云监控控制台上的相关功能，自动为弹性云服务器安装云监控插件。
当系统不支持一键安装Agent或者使用一键安装Agent失败时，可以使用手动安装Agent的方式。云监控服务控制台提供了当前区域手动安装Agent的命令，关于手动安装Agent的更多信息，请参见单台主机下安装Agent和批量安装Agent。
- 登录管理控制台。
- 单击“服务列表 > 云监控服务”。
- 单击“主机监控 > 弹性云服务器”，进入主机监控页面。
- 在“插件状态”为“未安装”的主机上单击图标，在右侧弹出使用指南。
- 单击主机列表上方“手动安装”，在右侧弹出使用指南
- 根据安装插件指引，登录主机安装Agent插件。
图4 安装插件
安装&升级插件、手动安装和远程安装任务提交后，即可在“任务中心”页面的“Agent维护”页签查看。
单台主机下安装Agent
目前只支持Linux操作系统和Windows操作系统。支持的系统请参见Agent支持的系统有哪些？。
云监控仅支持通过管理员账号权限操作云监控插件。使用管理员账号具有一定风险，如果操作不当可能导致系统稳定性问题或数据安全问题，请谨慎操作。
前提条件
- 已配置DNS和安全组，配置方法参考如何配置DNS和安全组？。
- 已配置委托，配置方法参考如何配置委托？。
- 确保操作步骤中的安装目录都有读写权限，并且安装成功后的Telescope进程不会被其他软件关闭。
- 确保已下载Agent安装脚本，获取脚本的方式如下：
操作步骤
- 使用root账号，登录主机。登录方式请参考Linux ECS登录方式概述。
- 执行以下命令，安装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.6 -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插件的实例插件状态为运行中。
Agent插件配置完成后，因监控数据暂未上报，插件状态仍显示“未安装”，等待3-5分钟，刷新即可。
前提条件
- 已配置DNS和安全组，配置方法参考如何配置DNS和安全组？。
- 已配置委托，配置方法参考如何配置委托？。
- 使用具有administrator权限的账户安装，例如administrator用户，并且确保安装成功后的Telescope进程不会被其他软件关闭。
- 已获取Agent安装包，格式为exe/zip，安装包获取方式如下。
操作步骤
- 使用具有“管理员”权限的账号（例如，administrator）登录Windows弹性云服务器。登录方式请参考Windows ECS登录方式概述。
- 在浏览器地址栏输入表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.6版本，对应的安装命令为：".\install_amd64.exe -u 0.2.1 -t 2.7.6"。
- 若安装包为zip格式
- 安装完成后，进入主机监控页面，可以看到已安装Agent插件的实例插件状态为运行中。
Agent插件配置完成后，因监控数据暂未上报，插件状态仍显示“未安装”，等待3-5分钟，刷新即可。
批量安装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的主机中。登录方式请参考Linux ECS登录方式概述。
- 批量安装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.6
- 安装完成后，登录云监控服务管理控制台，单击左侧导航栏的“主机监控”，可以看到已安装Agent插件的实例插件状态为运行中。
Agent插件配置完成后，因监控数据暂未上报，插件状态仍显示“未安装”，等待3-5分钟，刷新即可。
