日志服务 LogListener 升级指南

一、选择升级方式

二、升级前准备

升级前，请确认当前部署环境和组件版本，并检查日志采集状态。建议在业务低峰期执行升级，并在升级前记录当前版本和配置。升级期间，采集进程或 Pod 可能重启，请关注日志写入的连续性。

三、升级 CVM 与 Lighthouse 中的 LogListener

本节适用于通过机器组管理的 CVM 或 Lighthouse 主机。你可以使用控制台自动升级、控制台一键升级或半自动升级。

注意：说明：

四、控制台自动升级

1. 登录 日志服务控制台。

2. 在左侧导航栏中，选择机器组管理，进入机器组管理页面。

3. 找到需要自动升级的目标机器组，单击。

4. 在弹出的窗口中，开启 LogListener 自动升级开关，指定升级时间段（默认为当前时间至后两小时，如23:25～01:25）。

5. 单击确定，目标机器组的自动升级栏变为，即表示开启自动升级 LogListener 成功。

注意：说明：

五、控制台一键升级

1. 登录 日志服务控制台。

2. 在左侧导航栏中，选择机器组管理，进入机器组管理页面。

3. 找到需要升级的目标机器组，单击操作栏的更多，在下拉框中找到并单击手动升级 LogListener。

4. 在弹出的窗口中，勾选升级状态为可升级的目标机器，单击手动升级。

系统默认升级至最新版本，当升级状态为已是最新版本时，即表示升级成功。

注意：说明：

六、半自动升级

升级到 Loglistener 新架构（3.x 版本号）最新版本升级到 LogListener 老架构（2.x 版本号）最新版本

1. 下载 loglistener_operator 脚本。

2. 执行以下命令即可完成升级。

./loglistener_operator upgrade –root_dir=${loglistener安装目录} –url=${升级包url}

参数描述：

注意：以下流程是升级到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.tencent.com/install/cls/test/loglistener-linux-x64-2.8.7.tar.gz

参数描述：

七、非标部署环境自动升级风险说明

注意：如果你通过自定义镜像打包、自研脚本部署或修改默认安装路径等非标方式部署 LogListener，自动升级功能可能无法正常工作，甚至导致采集环境损坏。请在确认部署方式后，参考本节说明评估风险。

八、非标部署环境定义

以下任一情况均属于非标部署环境：

九、自动升级与非标环境的冲突风险

自动升级脚本依赖标准安装路径和进程特征来定位 LogListener 实例。当你的部署方式与标准不一致时，可能出现以下问题：

·升级脚本无法定位进程：自动升级通过预设路径查找 LogListener 进程，非标路径会导致进程定位失败，升级脚本可能误判为未安装状态，触发全新安装覆盖现有环境。

·文件覆盖冲突：升级脚本按默认路径写入新版这篇件，与你自定义路径下的实际运行实例产生冲突，导致配置文件丢失或进程异常。

·环境状态不一致：升级完成后，自研管理脚本指向的路径/进程与实际升级后的版本不匹配，造成采集服务无法正常启动或运行。

十、建议非标环境关闭自动升级

如果你的 LogListener 属于上述非标部署环境，建议关闭自动升级功能，改为手动升级或半自动升级方式管理版本更新。关闭自动升级操作步骤如下：

1. 登录 日志服务控制台。

2. 在左侧导航栏中，选择机器组管理。

3. 找到对应机器组的 LogListener 自动升级，设置为关闭状态。

注意：说明：

注意：关闭自动升级后，你可通过 控制台一键升级 进行版本更新。

十一、升级自建 K8s 集群日志采集组件

自建 K8s 集群通过 Helm Release tencent-cloud-cls-log 管理日志采集组件。升级操作会更新该 Helm Release 管理的组件，例如 tke-log-agent 和 cls-provisioner。本节适用于通过腾讯云脚本安装日志采集组件的集群。

1. 升级前需重新拉取最新版本的安装脚本，以获取最新的采集器组件：

wget https://mirrors.tencent.com/install/cls/k8s/addon-charts/tencentcloud-cls-k8s.shchmod +x tencentcloud-cls-k8s.sh

2. 执行以下命令升级

./tencentcloud-cls-k8s.sh upgrade –region ap-xxxxxx –<options>

参数说明：

十二、升级 TKE 集群日志采集组件

TKE 集群通过 TKE 控制台升级 tke-log-agent。升级过程中，控制台会同步升级配套的 LogListener、Provisioner 和日志相关 CRD。

1. 登录 容器服务控制台。

2. 在左侧导航栏中，选择运维中心 > 运维功能管理。

3. 选择目标地域和集群类型。

4. 找到状态为组件可升级的目标集群，单击组件可升级。

5. 在组件列表中找到 tke-log-agent，单击右侧的升级，并根据页面提示确认升级。

十三、升级是否会中断日志采集？

升级期间，LogListener 进程或日志采集 Pod 可能重启，日志写入可能出现短暂延迟。建议在业务低峰期升级，并在升级后检查日志写入的连续性。

十四、升级后日志未继续写入怎么办？

请先检查 LogListener 或日志采集 Pod 的运行状态和组件日志，然后确认网络、权限、日志主题及采集配置是否正常。如果问题仍未解决，请 提交工单 联系腾讯云技术支持。