升级Agent

云监控插件可用于采集目标主机操作系统层面上的监控指标数据，对主机监控有重要价值。云监控插件会一直迭代新版本，从而增加新特性、修复稳定性问题和优化性能。当老架构的Agent不满足使用需求时，可以对Agent进行升级。关于云监控插件的版本信息，请参见Agent版本特性。

云监控插件将不断升级版本，以便给您带来更好的监控体验。本章节主要介绍如何升级Agent。

不支持局点：华南-广州-友好用户环境、拉美-圣保罗一、拉美-墨西哥城一。

表1 适用场景
安装方式	适用场景	约束与限制
全量自动化升级插件	云监控服务支持控制台自动化升级云监控插件功能。若您想将主机监控列表中所有主机资源升级到同一个云监控插件版本，推荐您先通过云监控服务控制台全量自动化升级功能，自动为所有支持一键安装的主机资源升级云监控插件。安装完成后，再通过手动升级插件的方式为不支持一键安装和自动升级失败的主机资源升级插件。	主机监控列表中，所有已安装了Agent插件并且插件状态为运行中的主机，均可通过自动化升级的功能升级插件。
自定义自动化升级插件	云监控服务支持控制台自动化升级云监控插件功能。若您只需要为部分主机资源安装云监控插件，或需要为不同的主机资源升级到不同的版本，并且主机资源已支持一键安装，推荐您通过云监控服务控制台相关功能，自动为指定主机资源升级云监控插件。	主机监控列表中，所有已安装了Agent插件并且插件状态为运行中的主机，均可通过自动化升级的功能升级插件。
手动升级Agent	当主机资源不支持通过一键安装功能进行自动化升级或自动升级插件失败时，可以通过手动方式升级Agent。支持Agent一键安装的系统请参考Agent支持的系统有哪些？	无。

登录云监控服务管理控制台。
单击“主机监控 > 弹性云服务器”，进入主机监控页面。
单击“安装&升级插件 > 全量安装&升级插件”，在右侧弹出安装&升级插件指引。
在安装&升级插件指引中，选择“只对安装过的主机进行升级”。
选择目标插件版本：
- 基础版：提供基础操作系统监控指标，包括CPU、内存、文件系统、磁盘、网卡、网络等多类监控指标。
- 增强版：除提供基础版能力外，还将提供：GPU监控能力、BMS硬件故障监控能力。
单击“确定”，启动Agent升级。
查看升级结果。
1. 单击页面左侧的“任务中心”。
2. 在任务中心页面，单击“Agent维护”页签，可以查看Agent升级任务状态。
  - 若“任务状态”为“成功”，表示Agent升级成功，进入主机监控列表查看目标主机资源的插件版本已更新为最新版本。
  - 若“任务状态”为“超时”，可通过操作列的“重试”重新执行该任务。

登录云监控服务管理控制台。
单击“主机监控 > 弹性云服务器”，进入主机监控页面。
在主机列表中选择待升级的主机资源。
单击“安装&升级插件 > 批量安装&升级插件”，在右侧弹出安装&升级插件指引。
在批量修改页面可以查看操作对象。
当系统检测出有不可执行对象时，请参见批量安装&升级插件时，为什么提示无法执行，查看解决方案。
单击下一步。
在安装&升级插件指引中，选择“只对安装过的主机进行升级”。
选择目标插件版本：
- 基础版：提供基础操作系统监控指标，包括CPU、内存、文件系统、磁盘、网卡、网络等多类监控指标。
- 增强版：除提供基础版能力外，还将提供：GPU监控能力、BMS硬件故障监控能力。
单击“确定”，启动Agent升级。
查看升级结果。
1. 单击页面左侧的“任务中心”。
2. 在任务中心页面，单击“Agent维护”页签，可以查看Agent升级任务状态。
  - 若“任务状态”为“成功”，表示Agent升级成功，进入主机监控列表查看目标主机资源的插件版本已更新为最新版本。
  - 若“任务状态”为“超时”，可通过操作列的“重试”重新执行该任务。

当主机资源不支持通过一键安装或自动升级插件失败时，必须手动通过脚本进行升级。需要先卸载低版本云监控插件，再执行高版本云监控插件安装操作。

使用root账号，登录ECS。
执行如下命令，确认当前Agent的版本是新架构Uniagent还是老架构telescope。
```
if [[ -f /usr/local/uniagent/extension/install/telescope/bin/telescope ]]; then /usr/local/uniagent/extension/install/telescope/bin/telescope -v; elif [[ -f /usr/local/telescope/bin/telescope ]]; then echo "old agent"; else echo 0; fi
```
- 返回“old agent”，表示使用的是老版本Agent（telescope架构）。
- 返回版本号，表示使用新版本Agent（Uniagent架构）。
- 返回“0”，表示未安装Agent。
卸载当前版本的Agent。
- 如果2中返回old agent，代表当前Agent为老版本，卸载命令参见卸载Agent（老版本）。
- 如果2中返回版本号，代表当前Agent为新版本，卸载命令参见卸载Agent（新版本）。
安装最新版本的Agent，安装命令参见单台主机下手动安装Agent。

使用具有“管理员”权限的账号（例如，administrator）登录Windows弹性云服务器。
根据Agent安装路径判断当前Agent版本。
- 新版本Agent默认安装路径为“C:\Program Files\uniagent\extension\install\telescope”
- 老版本Agent默认安装路径为“C:\Program Files\telescope”
卸载当前版本的Agent，卸载命令参见卸载Agent。
安装最新版本的Agent，安装命令参见单台主机下手动安装Agent。