日志服务 LogListener 安装指南（Linux 版）

一、安装环境

这篇会介绍 Linux 操作系统环境下 LogListener 的安装，Windows 操作系统请参见 LogListener 安装指南（Windows 版）。

注意：说明：

LogListener 详细版本功能变更信息请参见 LogListener 版本变更。

二、网络与端口说明

LogListener 以客户端方式主动连接 CLS 服务端域名上报日志，默认使用 TCP 80（HTTP）；如启用 HTTPS 加密传输，则使用 TCP 443。本地源端口由操作系统从临时端口范围（ephemeral port）中自动分配，无需你手动固定或放通。请确保服务器安全组/防火墙的出站规则允许访问 CLS 服务域名的80/443端口，否则日志将无法上报。

三、准备工作

需先下载 loglistener_operator 脚本。

·内网下载地址：

wget https://mirrors.tencentyun.com/install/cls/script/loglistener/loglistener_operator && chmod u+x loglistener_operator

·外网下载地址：

wget https://mirrors.tencent.com/install/cls/script/loglistener/loglistener_operator && chmod u+x loglistener_operator

四、步骤1：安装 LogListener

使用 root 用户执行脚本，命令如下。

五、使用 SecretId、SecretKey 安装（强鉴权）

安装最新版本安装指定版本使用本地 package 安装指定 URL 安装

# 内网访问./loglistener_operator install -s ${secret_id} -k ${secret_key} -r ${region}# 外网访问./loglistener_operator install -s ${secret_id} -k ${secret_key} -r ${region} -n internet

# 内网访问./loglistener_operator install -s ${secret_id} -k ${secret_key} -r ${region} –version ${version}# 外网访问./loglistener_operator install -s ${secret_id} -k ${secret_key} -r ${region} –version ${version} -n internet注意：该脚本只支持安装3.4.0以上版本的包。

# 内网访问./loglistener_operator install -s ${secret_id} -k ${secret_key} -r ${region} –package_path ${package_path}# 外网访问./loglistener_operator install -s ${secret_id} -k ${secret_key} -r ${region} –package_path ${package_path} -n internet

注意：说明：

# 内网访问./loglistener_operator install -s ${secret_id} -k ${secret_key} -r ${region} –url https://xxx.tar.gz# 外网访问./loglistener_operator install -s ${secret_id} -k ${secret_key} -r ${region} –url https://xxx.tar.gz -n internet

注意：说明：

六、使用 UIN 安装（弱鉴权）

为避免在服务器内配置长期有效的云 API 密钥，LogListener 支持基于账号 UIN 实现弱鉴权接入。你可根据业务安全要求选择弱鉴权安装与 SecretId、SecretKey 密钥安装其中一种方式。弱鉴权不校验请求方的真实身份，存在请求被伪造或重放的风险。请仅在能够接受该风险的场景中使用。对安全性要求较高的业务，建议继续使用 SecretId、SecretKey 或云服务器角色鉴权。

安装步骤

1. 请前往 腾讯云控制台 获取当前腾讯云账号的 UIN（所属主账号 ID），并确认日志服务所在地域。

2. 在目标日志主题的基本信息页面，在高级设置中开启匿名上传，并在匿名操作中选择 API/SDK 上传日志。

3. 选择对应的安装方式并执行命令。

安装最新版本安装指定版本使用本地 package 安装指定 URL 安装

# 内网访问./loglistener_operator install –uin ${uin} -r ${region}# 外网访问./loglistener_operator install –uin ${uin} -r ${region} -n internet

# 内网访问./loglistener_operator install –uin ${uin} -r ${region} –version ${version}# 外网访问./loglistener_operator install –uin ${uin} -r ${region} –version ${version} -n internet注意：该脚本只支持安装3.4.0以上版本的包。

./loglistener_operator install –uin ${uin} -r ${region} –package_path ${package_path}# 外网访问./loglistener_operator install –uin ${uin} -r ${region} –package_path ${package_path} -n internet

注意：说明：

# 内网访问./loglistener_operator install –uin ${uin} -r ${region} –url https://xxx.tar.gz# 外网访问./loglistener_operator install –uin ${uin} -r ${region} –url https://xxx.tar.gz -n internet

注意：说明：

使用限制

·弱鉴权与 SecretId、SecretKey 强鉴权方式互斥，安装时不能同时配置。

·本功能适用于 Linux 服务器，暂不支持 Docker、EKS 或 Kubernetes 等容器采集场景。

·如果 LogListener 使用本地采集配置，开启弱鉴权后，请将 <安装目录>/conf/user_config/ 下本地 JSON 配置中的 outputs[].detail.Uin 更新为当前账号 UIN，并确保与安装命令中的 –uin 参数一致。

注意：说明：

上述两种安装完成后返回结果如下：

七、参数说明

注意：

八、步骤2：启动 LogListener

systemctl start loglistener

执行 systemctl check loglistener 查看是否启动成功：

九、步骤3：加入机器组

完成 LogListener 安装并启动后，需在 日志服务控制台 创建或选择已有 机器组，并将服务器加入机器组中。你可通过以下两种方式将服务器加入机器组：

·通过关联机器 IP 地址创建机器组

·通过机器标识创建机器组

十、步骤4：采集日志

将服务器加入机器组后，即可 配置采集服务器上的文本日志。

十一、LogListener 常用操作

版本≥3.4.0版本<3.4.0

·查看 LogListener 版本：需要在 LogListener 的安装目录下（默认安装目录为/opt/loglistener），执行如下命令即可查看版本。

./loglistener -v

·查看 LogListener 帮助文档：需要在 LogListener 的安装目录下（默认安装目录为/opt/loglistener），执行如下命令即可查看帮助说明。

./loglistener -h

·停止 LogListener：

systemctl stop loglistener

·重启 LogListener：

systemctl restart loglistener

执行 systemctl check loglistener 查看是否重启成功。

·查看 LogListener 进程状态：

systemctl status loglistener

·检查 LogListener 心跳及配置：

systemctl check loglistener

·切换鉴权方式：LogListener 3.6.6 及以上版本支持在 SecretId、SecretKey 强鉴权与 UIN 弱鉴权之间切换。需要在 LogListener 的安装目录下（默认安装目录为/opt/loglistener），执行如下命令即可切换。

# 强鉴权切换为弱鉴权/opt/loglistener/loglistener convert_auth –auth_mode –uin ${uin} # 弱鉴权切换为强鉴权/opt/loglistener/loglistener convert_auth –auth_mode -s ${secret_id} -k ${secret_key}

注意：说明：

注意：仅单账号场景支持鉴权切换，多账号场景暂不支持切换鉴权方式。

·卸载 LogListener：

1.1 使用 停止命令 systemctl stop loglistener 停止运行旧版本的 LogListener。

systemctl stop loglistener

1.2 需要在 LogListener 的安装目录下（默认安装目录为 /opt/loglistener），在/opt/loglistener/tools 路径下，以管理员权限执行卸载命令。

./loglistener_operator uninstall

·查看 LogListener 版本：

/etc/init.d/loglistenerd -v

·查看 LogListener 帮助文档：

/etc/init.d/loglistenerd -h

·停止 LogListener：

·通过 systemd 执行。适用于 LogListener 2.8.3以上并且操作系统具有 systemd。

systemctl stop loglistenerd

·不通过 systemd 执行。适用于 LogListener 2.8.3以下或者 LogListener 2.8.3以上但是操作系统没有 systemd。

/etc/init.d/loglistenerd stop

·重启 LogListener：

·通过 systemd 执行。适用于 LogListener 2.8.3以上并且操作系统具有 systemd。

systemctl restart loglistenerd

执行 /etc/init.d/loglistenerd check 查看是否重启成功：

·不通过 systemd 执行。适用于 LogListener 2.8.3以下或者 LogListener 2.8.3以上但是操作系统没有 systemd。

/etc/init.d/loglistenerd restart

重启成功返回样例：

·查看 LogListener 进程状态：

/etc/init.d/loglistenerd status

LogListener 正常情况会运行两个进程：

·检查 LogListener 心跳及配置：

/etc/init.d/loglistenerd check

·修改 LogListener 配置：请参见 LogListener 配置指南。

·卸载 LogListener：

1.1 使用 停止命令 停止运行旧版本的 LogListener。

1.2 以安装路径/usr/local/为例，在/usr/local/loglistener/tools 路径下，以管理员权限执行卸载命令：

./loglistener.sh uninstall

·手动更新 LogListener：

复用断点文件（不会重复采集日志）：

1.1 使用 停止命令 停止运行旧版本的 LogListener。

1.2 以安装目录/usr/local/loglistener 为例，前往安装目录下，备份旧版本中的断点文件目录./data。例如：将旧版的断点文件备份至/tmp/loglistener-backup 目录下。

cp -r ./data /tmp/loglistener-backup/

1.3 使用 卸载命令 卸载旧版本的 LogListener。

1.4 下载并安装 最新版本的 LogListener。

1.5 以安装目录/usr/local/loglistener 为例，复制所备份的断点文件目录（步骤2）到新版本 LogListener 目录下。

cp -r /tmp/loglistener-backup/data ./

1.6 使用 启动命令 启动运行新版本 LogListener。

不复用断点文件（可能会重复采集日志）：

1.7 使用 停止命令 停止运行旧版本的 LogListener。

1.8 使用 卸载命令 卸载旧版本的 LogListener。

1.9 下载并安装最新版本 的 LogListener。

1.10 使用 启动命令 启动运行新版本 LogListener。

十二、升级指南

参考 LogListener 升级指南 即可。