LogListener 升级指南

最近更新时间:2024-08-15 15:04:21

我的收藏

概述

为了更好地提供日志服务(Cloud Log Service,CLS)的日志采集服务,现支持 LogListener 自动升级、控制台一键升级和脚本半自动升级功能。LogListener 采集端程序版本迭代更新之后,用户无需自主下载新版本安装包进行相关操作的手动升级,只需在控制台预设时间段指定机器组进行 LogListener 自动升级,或对目标机器实行一键手动升级即可。
说明
LogListener 自动升级功能仅在 LogListener 2.5.0 及以上版本开始支持,为了更好的使用体验,建议先通过 半自动升级 将 LogListener 升级至2.5.0以上。
脚本半自动升级功能需 Python2.7 支持,若采集机器上安装的不是该版本,将无法使用此方式进行升级。建议升级 Python 版本, 或使用 手动升级LogListener
采集端程序 LogListener 控制台升级,可以使用 控制台自动升级控制台一键升级
Agent 升级异常或者因为版本限制无法使用自动升级时,可以使用 半自动升级手动升级

操作步骤

控制台自动升级

2. 在左侧导航栏中,单击机器组管理,进入机器组管理页面。
3. 找到需要自动升级的目标机器组,单击

即可开启自动升级



4. 在弹出的窗口中,开启 LogListener 开关,指定升级时间段(默认为当前时间至后两小时,如08:39~10:39)。


5. 单击确定,目标机器组的“自动升级”栏变为

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

控制台一键升级

2. 在左侧导航栏中,单击机器组管理,进入机器组管理页面。
3. 找到需要升级的目标机器组,单击“操作”栏的更多, 在下拉框中找到并单击手动升级 LogListener



4. 在弹出的窗口中,勾选“升级状态”“可升级”的目标机器,单击手动更新


系统默认升级至最新版本,当“升级状态”“已是最新版本”时,即表示升级成功。
说明:
当升级状态显示“不支持更新”时,表示不支持在控制台一键更新 LogListener,需要您自主下载新版本安装包进行相关的手动升级操作,详情请参见 LogListener 手动升级
当升级状态显示“心跳异常”时,请 检查机器组状态

半自动升级

LogListener 2.9.1及以上版本
LogListener 2.9.1以下版本
以 LogListener 安装路径/usr/local/为例,进入/usr/local/loglistener/tools目录中,并执行以下命令:
./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/loglistener-linux-x64-2.8.7.tar.gz
注意: 如果输入的版本不存在,则下载失败;如果输入的版本低于机器上已安装的当前版本,则更新不生效。

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
注意:
如果输入的版本不存在,则下载失败;如果输入的版本低于机器上已安装的当前版本,则更新不生效。