概述
为了更好地提供日志服务（Cloud Log Service，CLS）的日志采集服务，现支持 LogListener 自动升级、控制台一键升级和脚本半自动升级功能。LogListener 采集端程序版本迭代更新之后，用户无需自主下载新版本安装包进行相关操作的手动升级，只需在控制台预设时间段指定机器组进行 LogListener 自动升级，或对目标机器实行一键手动升级即可。
说明：
LogListener 自动升级功能仅在 LogListener 2.5.0及以上版本开始支持，为了更好的使用体验，建议先通过 半自动升级 将 LogListener 升级至2.5.0以上。
LogListener 版本低于2.8.3时，脚本半自动升级功能需 Python2.7支持，若采集机器上安装的不是该版本，将无法使用此方式进行升级，建议升级 Python 版本。
LogListener 自动升级功能不支持从2.8.3以下版本直接升级至3.x 版本。如需升级，请先通过 半自动升级 方式升级至2.8.6版本，再使用自动升级功能。
Agent 升级异常或者因为版本限制无法使用自动升级时，可以使用 半自动升级。
操作步骤
控制台自动升级
1. 登录 日志服务控制台。
2. 在左侧导航栏中，选择机器组管理，进入机器组管理页面。
3. 找到需要自动升级的目标机器组，单击
4. 在弹出的窗口中，开启 LogListener 自动升级开关，指定升级时间段（默认为当前时间至后两小时，如23:25～01:25）。
5. 单击确定，目标机器组的自动升级栏变为
说明：
自动升级的时间段可选择任意时间段，系统会在用户指定的时间段每天进行检查。若满足升级条件，则进行自动升级；若不满足升级条件，则不进行操作。
如需对多个机器组进行 LogListener 自动升级，可以勾选多个目标机器组，然后单击更多操作中的 LogListener 自动升级进行批量升级。
控制台一键升级
1. 登录 日志服务控制台。
2. 在左侧导航栏中，选择机器组管理，进入机器组管理页面。
3. 找到需要升级的目标机器组，单击操作栏的更多，在下拉框中找到并单击手动升级 LogListener。
4. 在弹出的窗口中，勾选升级状态为可升级的目标机器，单击手动升级。
系统默认升级至最新版本，当升级状态为已是最新版本时，即表示升级成功。
说明：
当升级状态显示不支持更新时，表示不支持在控制台一键更新 LogListener，需要您自主下载新版本安装包进行相关的手动升级操作，详情请参见 半自动升级。
当升级状态显示心跳异常时，请 检查机器组状态。
半自动升级
1. 下载 loglistener_operator 脚本。
2. 执行以下命令即可完成升级。
./loglistener_operator upgrade --root_dir=${loglistener安装目录} --url=${升级包url}
参数描述：
参数 | 描述 |
--root-dir | 指定新版本 LogListener 安装目录。此处默认为 /usr/local/loglistener |
--url | 需要升级的 LogListener 的安装包地址。此处默认为最新 LogListener 的安装包地址。若需指定版本，可在 loglistener-linux-x64后增加“-版本号”。例如：3.5.0版本的 LogListener 的安装包地址为： |
注意：
以下流程是升级到2.x 的最新版本，如果需要升级到 LogListener 新架构（版本≥3.5.0），请参考左侧 Tab。
1. 执行如下命令，下载升级脚本。
wget http://mirrors.tencent.com/install/cls/update
2. 执行以下命令，添加权限。
chmod +x update
3. 执行以下命令，执行 LogListener 升级脚本。
./update auto_upgrade --root-dir /usr/local/loglistener --url http://mirrors.tencentyun.com/install/cls/loglistener-linux-x64.tar.gz
参数描述：
参数 | 描述 |
--root-dir | 指定新版本 LogListener 安装目录。此处默认为 /usr/local/loglistener |
--url | 需要升级的 LogListener 的安装包地址。此处默认为最新 LogListener 的安装包地址。若需指定版本，可在 loglistener-linux-x64后增加“-版本号”。例如：2.8.7版本的 LogListener 的安装包地址为 http://mirrors.tencent.com/install/cls/test/loglistener-linux-x64-2.8.7.tar.gz 注意： 如果输入的版本不存在，则下载失败；如果输入的版本低于机器上已安装的当前版本，则更新不生效。 |
非标部署环境自动升级风险说明
注意：
如果您通过自定义镜像打包、自研脚本部署或修改默认安装路径等非标方式部署 LogListener，自动升级功能可能无法正常工作，甚至导致采集环境损坏。请在确认部署方式后，参考本节说明评估风险。
非标部署环境定义
以下任一情况均属于非标部署环境：
场景 | 说明 |
自定义镜像打包 | 将 LogListener 二进制文件或安装目录打包进自定义容器镜像或系统镜像中，未使用官方安装脚本部署 |
自研脚本管理进程 | 使用自研的启动/停止/重启脚本管理 LogListener 进程，未通过官方提供的 tools/loglistener.sh 脚本管理 |
非默认安装路径 | 安装目录非默认路径 /usr/local/loglistener，如迁移至 /opt/loglistener 或其他自定义目录 |
进程名或路径被修改 | 修改了 LogListener 的可执行文件名称或符号链接路径，导致实际进程路径与标准部署不一致 |
自动升级与非标环境的冲突风险
自动升级脚本依赖标准安装路径和进程特征来定位 LogListener 实例。当您的部署方式与标准不一致时，可能出现以下问题：
升级脚本无法定位进程：自动升级通过预设路径查找 LogListener 进程，非标路径会导致进程定位失败，升级脚本可能误判为未安装状态，触发全新安装覆盖现有环境。
文件覆盖冲突：升级脚本按默认路径写入新版本文件，与您自定义路径下的实际运行实例产生冲突，导致配置文件丢失或进程异常。
环境状态不一致：升级完成后，自研管理脚本指向的路径/进程与实际升级后的版本不匹配，造成采集服务无法正常启动或运行。
建议非标环境关闭自动升级
如果您的 LogListener 属于上述非标部署环境，建议关闭自动升级功能，改为手动升级或半自动升级方式管理版本更新。关闭自动升级操作步骤如下：
1. 登录 日志服务控制台。
2. 在左侧导航栏中，选择机器组管理。
3. 找到对应机器组的 LogListener 自动升级，设置为关闭状态。
说明：
