# 管理Agent
Agent安装成功后，您可以根据需要对Agent进行查看、启动、停止、重启和卸载。本章节指导如何在Linux平台、Windows平台管理Agent。
![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/caution_3.0-zh-cn.png)
云监控服务仅支持通过管理员账号权限（Linux操作系统使用root用户，Windows操作系统使用Administrator用户）操作云监控插件。使用管理员账号具有一定风险，如果操作不当可能导致系统稳定性问题或数据安全问题，请谨慎操作。
#### 前提条件
- 已成功[安装Agent插件](https://support.huaweicloud.com/usermanual-ces/ces_01_0029.html)。
- 已确认Agent版本，Agent分为新版本和老版本两种，不同版本操作方式不同。
  Linux平台：
  1. 使用root账号，登录主机。
  
  2. 执行如下命令，确认使用Agent的版本。
     ```
     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，请参考老版本操作指令。
     
     - 返回版本号，表示使用新版本Agent，请参考新版本操作指令。
     
     - 返回"0"，表示未安装Agent。
      
   
  Windows平台：请根据安装路径确定Agent版本。
  - 新版本Agent默认安装路径为"C:\\Program Files\\uniagent\\extension\\install\\telescope"
  
  - 老版本Agent默认安装路径为"C:\\Program Files\\telescope"
    
 
#### 查看Agent状态
Agent安装成功后，您还可以登录主机查看Agent的运行状态。
- [新版本]
  **Linux平台：**
  1. 以root用户登录主机。
  
  2. 执行以下命令，查看Agent状态。
     ```
     service ces-uniagent status
     ```
     ![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/note_3.0-zh-cn.png)
     - 当系统返回内容包含"active (running)"，则表示uniagent为正常运行状态，可以正常管理telescope的生命周期。
     
     - 当系统返回内容包含"inactive (dead)"，则表示uniagent为未运行状态，无法管理telescope的生命周期。
      
     ```
     /usr/local/uniagent/extension/install/telescope/telescoped status
     ```
     ![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/note_3.0-zh-cn.png)
     - 当系统返回以下内容，则表示telescope为正常运行状态，可以正常采集和上报指标。
       ```
       Telescope process is running well.
       ```
       
     
     - 当系统返回以下内容，则表示telescope为未运行状态，无法采集和上报指标。
       ```
       Telescope process is not running.
       ```
       
       
  
  
  **Windows平台：**
  在任务管理器中查看名为telescope和uniagent的进程状态。
- [老版本]
  **Linux平台：**
  1. 以root用户登录主机。
  
  2. 执行以下命令，查看Agent状态。
     ```
     service telescoped status
     ```
     
  
  3. 当系统返回以下内容，则表示Agent为正常运行状态。
     ```
     "Active（running）"或"Telescope process is running well."
     ```
     
  
  
  **Windows平台：**
  在任务管理器中查看名为telescope的进程状态。
#### 停止Agent
当监控策略调整或系统临时维护时，您可以停用Agent插件。
- [新版本]
  **Linux平台：**
  1. 以root用户登录主机。
  
  2. 执行以下命令，停止Agent。
     ```
     /usr/local/uniagent/bin/uniagent stop
     /usr/local/uniagent/extension/install/telescope/telescoped stop
     ```
     
   
  **Windows平台：**
  1. 进入Agent安装包存放目录（"C:\\Program Files\\uniagent\\extension\\install\\telescope"）。
  
  2. 双击执行shutdown.bat脚本，停止Agent。
   
- [老版本]
  **Linux平台：**
  1. 以root用户登录主机。
  
  2. 执行以下命令，停止Agent。
     ```
     service telescoped stop
     ```
     
   
  **Windows平台：**
  1. 进入Agent安装包存放目录（"C:\\Program Files\\telescope"）。
  
  2. 双击执行shutdown.bat脚本，停止Agent。
   
#### 启动Agent
当Agent的状态为"已停止"，需要重新启动时，请参考以下操作步骤启动Agent。
- [新版本]
  **Linux平台：**
  1. 以root用户登录主机。
  
  2. 执行以下命令，启动Agent。
     ```
     /usr/local/uniagent/bin/uniagent start
     /usr/local/uniagent/extension/install/telescope/telescoped start
     ```
     
   
  **Windows平台：**
  1. 进入Agent安装包存放目录（"C:\\Program Files\\uniagent\\extension\\install\\telescope"）
  
  2. 双击执行start.bat脚本，启动Agent。
   
- [老版本]
  **Linux平台：**
  1. 以root用户登录主机。
  
  2. 执行以下命令，启动Agent。
     ```
     /usr/local/telescope/telescoped start
     ```
     
   
  **Windows平台：**
  1. 进入Agent安装包存放目录（"C:\\Program Files\\telescope"）
  
  2. 双击执行start.bat脚本，启动Agent。
   
#### 重启Agent
当Agent进程故障，可以先尝试重启Agent。如果重启后状态还是故障，可能Agent相关文件被破坏，请尝试重新安装Agent，安装方法参考[Agent安装配置方式说明](https://support.huaweicloud.com/usermanual-ces/ces_01_0027.html)。
- [新版本]
  **Linux平台：**
  1. 以root用户登录主机。
  
  2. 执行以下命令，重启Agent。
     ```
     /usr/local/uniagent/bin/uniagent stop
     /usr/local/uniagent/bin/uniagent start
     /usr/local/uniagent/extension/install/telescope/telescoped restart
     ```
     
   
  **Windows平台：**
  暂不支持重启Agent。
  
- [老版本]
  **Linux平台：**
  1. 以root用户登录主机。
  
  2. 执行以下命令，重启Agent。
     ```
     /usr/local/telescope/telescoped restart
     ```
     
   
  **Windows平台：**
  暂不支持重启Agent。
 #### 卸载Agent
当需要通过登录主机升级Agent时，需要先卸载低版本的Agent。
- [新版本]
  
  **Linux平台：**
  1. 以root用户登录主机。
  
  2. 执行以下命令，即可卸载Agent。
     ```
     bash /usr/local/uniagent/script/uninstall.sh
     ```
     
   
  **Windows平台：**
  1. 进入Agent安装包存放目录（"C:\\Program Files\\uniagent\\script"）。
  
  2. 双击执行uninstall.bat脚本，卸载Agent。
     ![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/caution_3.0-zh-cn.png)
     Windows卸载插件命令执行完成后，请进入"C:\\Program Files\\uniagent"查看是否有残留文件，如果有，请手动删除"C:\\Program Files\\uniagent"目录。
     
   
- [老版本]
  
  **Linux平台：**
  1. 以root用户登录主机。
  
  2. 执行以下命令，即可卸载Agent。
     ```
     /usr/local/telescope/uninstall.sh
     ```
     
   
  **Windows平台：**
  1. 进入Agent安装包存放目录（"C:\\Program Files\\telescope"）。
  
  2. 双击执行uninstall.bat脚本，卸载Agent。
     ![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/caution_3.0-zh-cn.png)
     Windows卸载插件命令执行完成后，请进入"C:\\Program Files\\telescope"查看是否有残留文件，如果有，请手动删除"C:\\Program Files\\telescope"目录。
     
   
#### 查看Agent日志
如果需要查看Agent的运行记录，您还可以登录主机查看Agent的日志。
- [新版本]
  **Linux平台：**
  1. 以root用户登录主机。
  
  2. 执行以下命令，查看Agent日志。
     ```
     less /usr/local/uniagent/extension/install/telescope/log/ces.log
     ```
     
  
  
  **Windows平台：**
  1. 进入Agent日志存放目录（"C:\\Program Files\\uniagent\\extension\\install\\telescope\\log"）。
  
  2. 双击ces.log文件，即可查看Agent日志。
   
- [老版本]
  **Linux平台：**
  1. 以root用户登录主机。
  
  2. 执行以下命令，查看Agent日志。
     ```
     less /usr/local/telescope/log/ces.log
     ```
     
  
  
  **Windows平台：**
  1. 进入Agent日志存放目录（"C:\\Program Files\\telescope\\log"）。
  
  2. 双击ces.log文件，即可查看Agent日志。
   
#### 相关文档
[Agent各种状态说明及异常状态处理方法](https://support.huaweicloud.com/ces_faq/ces_faq_0085.html)
[Agent状态切换或监控面板有断点该如何处理？](https://support.huaweicloud.com/trouble-ces/ces_faq_0041.html)