LogListener 升级指南

最近更新时间: 2026-03-13 09:03:00

概述

为了更好地提供日志服务(Cloud Log Service,CLS)的日志采集服务,现支持 LogListener 自动升级、控制台一键升级和脚本半自动升级功能。LogListener 采集端程序版本迭代更新之后,用户无需自主下载新版本安装包进行相关操作的手动升级,只需在控制台预设时间段指定机器组进行 LogListener 自动升级,或对目标机器实行一键手动升级即可。

说明

  • LogListener 自动升级功能仅在 LogListener 2.8.8 及以上版本开始支持,为了更好的使用体验,建议先通过 半自动升级 或者 手动升级LogListener将 LogListener 升级至2.8.8以上。
  • 脚本半自动升级功能需 Python2.7 支持,若采集机器上安装的不是该版本,将无法使用此方式进行升级。建议升级 Python 版本, 或使用 手动升级LogListener

操作步骤

控制台自动升级

  1. 登录日志服务控制台。
  2. 在左侧导航栏中,单击机器组管理,进入机器组管理页面。
  3. 找到需要自动升级的目标机器组,单击即可开启自动升级
  4. 在弹出的窗口中,开启 LogListener 开关,指定升级时间段(默认为当前时间至后两小时,如17:01~19:01)。
  5. 单击确定,目标机器组的**“自动升级”**栏变为,即表示开启自动升级 LogListener 成功。

    说明

    • 自动升级的时间段可选择任意时间段,系统会在用户指定的时间段每天进行检查。若满足升级条件,则进行自动升级;若不满足升级条件,则不进行操作。
    • 如需对多个机器组进行 LogListener 自动升级,可以勾选多个目标机器组,单击自动升级进行批量升级。

控制台一键升级

  1. 登录日志服务控制台。
  2. 在左侧导航栏中,单击机器组管理,进入机器组管理页面。
  3. 找到需要升级的目标机器组,单击操作列对应的更多 > 手动升级 LogListener
  4. 在弹出的窗口中,勾选“升级状态”为“可升级”的目标机器,单击手动升级
    系统默认升级至最新版本,当“升级状态”为“已是最新版本”时,即表示升级成功。

    说明:

    • 当升级状态显示“不支持更新”时,表示不支持在控制台一键更新 LogListener,需要您自主下载新版本安装包进行相关的手动升级操作,详情请参见 LogListener 手动升级
    • 当升级状态显示“心跳异常”时,请 检查机器组状态

半自动升级

LogListener 2.8.8及以上版本

以 LogListener 安装路径/usr/local/为例,进入/usr/local/loglistener/tools/update目录中,并执行以下命令。

./update auto_upgrade --root-dir /usr/local/loglistener --url http://cls-loglistener-1255000003.cos.shjr.cos.financetcloud.cn/loglistener-linux-x64-2.X.X.tar.gz

参数描述如下:

参数 描述
--root-dir 升级的新版本 LogListener 的安装路径。此处默认为/usr/local/loglistener
--url 需指定版本,可在 loglistener-linux-x64后增加“-版本号”。例:2.9.0版本的 LogListener 的安装包地址为:http://cls-loglistener-1255000038.cos.city.csp.abc.com/loglistener-linux-x64-2.9.0.tar.gz
注意:
如果输入的版本不存在,则下载失败;如果输入的版本低于机器上已安装的当前版本,则更新不生效。

loglistener2.4.6版本以及loglistener2.8.2 版本升级方式,请参照loglistener 2.4.6/2.8.2 升级到2.8.8 升级流程