# 升级Agent
云监控插件可用于采集目标主机操作系统层面上的监控指标数据，对主机监控有重要价值。云监控插件会一直迭代新版本，从而增加新特性、修复稳定性问题和优化性能。如果当前版本Agent不满足您的使用需求，可以对Agent进行升级。关于云监控插件的版本信息，请参见[Agent版本特性](https://support.huaweicloud.com/usermanual-ces/zh-cn_topic_0093329909.html)。
云监控插件将不断升级版本，以便给您带来更好的监控体验。本章节主要介绍如何升级Agent。
#### 约束限制
不支持局点：华南-广州-友好用户环境、拉美-墨西哥城一。
#### 适用场景
表1适用场景 
| 安装方式                                              | 适用场景                                                                                                                                                                                          | 约束与限制                                                      | 操作入口                                                                                                                       |
|:---|:---|:---|:---|
| [全量自动化升级插件]  | 云监控服务支持控制台**自动化升级** 云监控插件功能。若您想将主机监控列表中**所有**主机资源升级到同一个云监控插件版本，推荐您先通过云监控服务控制台全量自动化升级功能，自动为所有支持一键安装的主机资源升级云监控插件。 安装完成后，再通过**手动升级**插件的方式为不支持一键安装和自动升级失败的主机资源升级插件。 | 主机监控列表中，所有已安装了Agent插件并且插件状态为**运行中**的主机，均可通过自动化升级的功能升级插件。 | 登录[云监控服务主机监控列表](https://console.huaweicloud.com/ces/?#/hostMonitor/list?namespace=SYS.ECS)，单击列表上方"安装\&升级插件 \> 全量安装\&升级插件"。 |
| [自定义自动化升级插件]  | 云监控服务支持控制台**自动化升级** 云监控插件功能。若您只需要为**部分** 主机资源安装云监控插件，或需要为不同的主机资源升级到不同的版本，并且主机资源已支持一键安装，推荐您通过云监控服务控制台相关功能，自动为**指定**主机资源升级云监控插件。                                                                | 主机监控列表中，所有已安装了Agent插件并且插件状态为**运行中**的主机，均可通过自动化升级的功能升级插件。 | 登录[云监控服务主机监控列表](https://console.huaweicloud.com/ces/?#/hostMonitor/list?namespace=SYS.ECS)，单击列表上方"安装\&升级插件 \> 批量安装\&升级插件"。  |
| [手动升级Agent] | 当主机资源不支持通过一键安装功能进行自动化升级或自动升级插件失败时，可以通过**手动方式**升级Agent。 支持Agent一键安装的系统请参考[Agent支持的系统有哪些？](https://support.huaweicloud.com/ces_faq/ces_faq_0024.html)              | 无。                                                           | 登录主机。                                                                                                                       |
   
 #### 全量自动化升级插件
1. 登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。
2. 单击"主机监控 \> 弹性云服务器"，进入主机监控页面。
3. 单击"安装\&升级插件 \> 全量安装\&升级插件"，在右侧弹出安装\&升级插件指引。
4. 在安装\&升级插件指引中，选择"只对安装过的主机进行升级"。
5. 选择插件版本，当前仅支持选择"最新版本"。
   ![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/note_3.0-zh-cn.png)
   在部分区域，Agent的基础版与增强版已合并，目前仅支持选择"最新版本"，其他区域仍在逐步上线中。合并前，Agent分为基础版和增强版。
   - **基础版**：提供基础操作系统监控指标，包括CPU、内存、文件系统、磁盘、网卡、网络等多类监控指标。
   
   - **增强版**：除提供基础版能力外，还将提供：GPU监控能力、BMS硬件故障监控能力。
     
6. 单击"确定"，启动Agent升级。
7. 查看升级结果。
   1. 单击页面左侧的"任务中心"。
   
   2. 在任务中心页面，单击"Agent维护"页签，可以查看Agent升级任务状态。
      - 若"任务状态"为"成功"，表示Agent升级成功，进入主机监控列表查看目标主机资源的插件版本已更新为最新版本。
      
      - 若"任务状态"为"超时"，可通过操作列的"重试"重新执行该任务。
       
    
 
 #### 自定义自动化升级插件
1. 登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。
2. 单击"主机监控 \> 弹性云服务器"，进入主机监控页面。
3. 在主机列表中选择待升级的主机资源。
4. 单击"安装\&升级插件 \> 批量安装\&升级插件"，在右侧弹出安装\&升级插件指引。
5. 在批量修改页面可以查看操作对象。 当系统检测出有不可执行对象时，请参见[批量安装\&升级插件时，为什么提示无法执行](https://support.huaweicloud.com/ces_faq/ces_faq_0089.html)，查看解决方案。
   
6. 单击下一步。
7. 在安装\&升级插件指引中，选择"只对安装过的主机进行升级"。
8. 选择插件版本，当前仅支持选择"最新版本"。
   ![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/note_3.0-zh-cn.png)
   在部分区域，Agent的基础版与增强版已合并，目前仅支持选择"最新版本"，其他区域仍在逐步上线中。合并前，Agent分为基础版和增强版。
   - **基础版**：提供基础操作系统监控指标，包括CPU、内存、文件系统、磁盘、网卡、网络等多类监控指标。
   
   - **增强版**：除提供基础版能力外，还将提供：GPU监控能力、BMS硬件故障监控能力。
     
9. 单击"确定"，启动Agent升级。
10. 查看升级结果。
    1. 单击页面左侧的"任务中心"。
    
    2. 在任务中心页面，单击"Agent维护"页签，可以查看Agent升级任务状态。
       - 若"任务状态"为"成功"，表示Agent升级成功，进入主机监控列表查看目标主机资源的插件版本已更新为最新版本。
       
       - 若"任务状态"为"超时"，可通过操作列的"重试"重新执行该任务。
        
     
 
 #### 手动升级Agent
当主机资源不支持通过一键安装或自动升级插件失败时，必须手动通过脚本进行升级。需要先卸载低版本云监控插件，再执行高版本云监控插件安装操作。
- [手动升级Agent（Linux）]
  1. 使用root账号，登录ECS。
  
  2. 执行如下命令，确认当前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。
      
  
  3. 卸载当前版本的Agent。
     - 如果[2]中返回old agent，代表当前Agent为老版本，卸载命令参见[卸载Agent（老版本）](https://support.huaweicloud.com/usermanual-ces/ces_01_0035.html#ces_01_0035__section19490113619483)。
     
     - 如果[2]中返回版本号，代表当前Agent为新版本，卸载命令参见[卸载Agent（新版本）](https://support.huaweicloud.com/usermanual-ces/ces_01_0035.html#ces_01_0035__section15952724814)。
      
  
  4. 安装最新版本的Agent，安装命令参见[单台主机下手动安装Agent](https://support.huaweicloud.com/usermanual-ces/ces_01_0029.html#ces_01_0029__section323910183811)。
   
- [手动升级Agent（Windows）]
  1. 使用具有"管理员"权限的账号（例如，administrator）登录Windows弹性云服务器。
  
  2. 根据Agent安装路径判断当前Agent版本。
     - 新版本Agent默认安装路径为"C:\\Program Files\\uniagent\\extension\\install\\telescope"
     
     - 老版本Agent默认安装路径为"C:\\Program Files\\telescope"
      
  
  3. 卸载当前版本的Agent，卸载命令参见[卸载Agent](https://support.huaweicloud.com/usermanual-ces/ces_01_0035.html#ces_01_0035__section1111625111812)。
  
  4. 安装最新版本的Agent，安装命令参见[单台主机下手动安装Agent](https://support.huaweicloud.com/usermanual-ces/ces_01_0029.html#ces_01_0029__section323910183811)。