LogListener 升级指南

最近更新时间：2023-12-25 15:57:21

我的收藏

本页目录：

概述
操作步骤

概述
为了更好地提供日志服务（Cloud Log Service，CLS）的日志采集服务，现支持 LogListener 自动升级、控制台一键升级和脚本半自动升级功能。LogListener 采集端程序版本迭代更新之后，用户无需自主下载新版本安装包进行相关操作的手动升级，只需在控制台预设时间段指定机器组进行 LogListener 自动升级，或对目标机器实行一键手动升级即可。
说明
LogListener 自动升级功能仅在 LogListener 2.5.0 及以上版本开始支持，为了更好的使用体验，建议先通过 半自动升级 将 LogListener 升级至2.5.0以上。
脚本半自动升级功能需 Python2.7 支持，若采集机器上安装的不是该版本，将无法使用此方式进行升级。建议升级 Python 版本， 或使用 手动升级LogListener。
采集端程序 LogListener 控制台升级，可以使用 控制台自动升级 和 控制台一键升级。
Agent 升级异常或者因为版本限制无法使用自动升级时，可以使用 半自动升级 或 手动升级。
操作步骤
控制台自动升级
1. 登录 日志服务控制台。
2. 在左侧导航栏中，单击机器组管理，进入机器组管理页面。
3. 找到需要自动升级的目标机器组，单击
﻿
，即可开启自动升级。
﻿
﻿
﻿
4. 在弹出的窗口中，开启 LogListener 开关，指定升级时间段（默认为当前时间至后两小时，如08:39～10:39）。
﻿
﻿
5. 单击确定，目标机器组的“自动升级”栏变为
﻿
，即表示开启自动升级 LogListener 成功。
说明
自动升级的时间段可选择任意时间段，系统会在用户指定的时间段每天进行检查。若满足升级条件，则进行自动升级；若不满足升级条件，则不进行操作。
如需对多个机器组进行 LogListener 自动升级，可以勾选多个目标机器组，单击自动升级进行批量升级。
控制台一键升级
1. 登录 日志服务控制台。
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
注意：
如果输入的版本不存在，则下载失败；如果输入的版本低于机器上已安装的当前版本，则更新不生效。
﻿
﻿
﻿

上一篇: 自建 K8S 集群安装 LogListener 下一篇: LogListener 配置指南

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