LogListener 安装指南（Linux 版）
下载
聚焦模式
字号
LogListener 是腾讯云日志服务（Cloud Log Service，CLS）所提供的专用日志采集器，将它安装部署到服务器上，可快速采集日志到日志服务。
安装环境
说明：
处理器架构 | 操作系统类别 | 确定可安装环境 |
x64/ARM | TencentOS Server | TencentOS Server 3.1、TencentOS Server 2.4 |
| CentOS（64位） | CentOS_6.8_64位、CentOS_6.9_64位、CentOS_7.2_64位、CentOS_7.3_64位、CentOS_7.4_64位、CentOS_7.5_64位、CentOS_7.6_64位、CentOS_8.0_64位 |
| Ubuntu（64位） | Ubuntu Server_14.04.1_LTS_64位、Ubuntu Server_16.04.1_LTS_64位、Ubuntu Server_18.04.1_LTS_64位、Ubuntu Server_20.04.1_LTS_64位、Ubuntu Server_22.04.1_LTS_64位 |
| Debian（64位） | Debian_8.2_64位、Debian_9.0_64位、Debian_12.0_64位 |
| openSUSE（64位） | openSUSE_42.3_64位 |
准备工作
需先下载 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 用户执行脚本，命令如下。
# 内网访问./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
说明：
安装命令中 -secret_id、-secret_key、-region 为必填的参数，更多其他参数请见如下 参数说明。
若主账号已授权协作者日志服务的读写权限，建议使用协作者密钥。
-region 为您所使用的日志服务区域，而非您的业务机器所处的区域。当您所使用的日志服务区域与您的业务机器所处的区域不一致时，请额外配置参数 -network 为 internet，即代表外网访问。
云服务器与日志集同地域的情况下，建议使用内网方式访问服务域名；云服务器与日志集在不同地域的情况下，建议使用外网方式访问服务域名。
关于日志采集权限详情，请参见 LogListener 日志采集权限。
安装完成后返回结果如下：
参数说明
参数名 | 是否必填 | 描述 |
-s | 是 | |
-k | 是 | |
-n | 否 | 表示 LogListener 通过哪种方式访问服务域名，取值：internal 内网访问（默认），internet 外网访问。 内网访问：适用于腾讯云服务器，且服务器所在地域与机器组一致。 外网访问：适用于非腾讯云服务器，或服务器所在地域与机器组不一致。 |
-r | 是 | 注意： 当您所使用的日志服务区域与您的业务机器所处的区域不一致时，请配置参数 network 为 internet，即代表外网访问。 |
-d | 否 | 注意： 当您所使用的日志服务区域与您的业务机器所处的区域不一致时，请配置外网域名。例如 ap-beijing.cls.tencentcs.com。 |
-i | 否 | |
-l | 否 | 注意： 若配置了机器标识， 该机器将只能通过机器标识与机器组关联， 无法通过 IP 进行关联；若不配置， 机器组只能通过 IP 关联该机器。 |
-p | 否 | 端口，默认 80。如需使用 HTTPS 加密传输，请指定443。 |
-u | 否 | 默认不上传机器标识到 CLS。 |
--base_dir | 否 | LogListener 安装路径，默认安装在 /opt 目录下。 |
--package_path | 否 | 使用本地包安装时指定本地 package 的路径。 |
--url | 否 | 指定 URL 安装时使用，指定 mirrors 仓库的地址。 |
--version | 否 | 指定版本号安装，默认安装最新版本。 |
--dynamic_ip | 否 | 用于控制是否开启动态 IP 自动检测能力，默认为 false。若入参为 true，当 IP 发生变更时可实时更新（仅机器标识场景支持，通过 IP 地址关联的场景不支持该能力）。 注意： 仅 LogListener 3.5.7及以上版本支持该参数。 |
--switch_endpoint | 否 | 启用备用域名。默认为 false，若入参为 true，当主域名网络失败后会使用备用域名。 入参 true 后，配置文件新增 backup_endpoints 字段（备用域名），系统会主动填充备用域名。 若用户初始化为内网访问，backup_endpoints 主动填充为外网。 若用户初始化为外网访问，backup_endpoints 主动填充为内网。 您也可以在配置文件中手动修改备用域名（支持填充多个）。若主域名无法访问，LogListener 会按照备用域名的顺序依次进行访问直至访问成功。 注意： 仅 LogListener 3.5.7及以上版本支持该参数。 |
注意：
更多细节可使用
./loglistener_operator install --help 查看。
如您初始化之后，需要调整 Loglistener 的配置和密钥，请参见 Loglistener 配置指南。
步骤2：启动 LogListener
systemctl start loglistener
执行
systemctl check loglistener 查看是否启动成功：
步骤3：加入机器组
步骤4：采集日志
LogListener 常用操作
查看 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：
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.5 以安装目录
/usr/local/loglistener 为例，复制所备份的断点文件目录（步骤2）到新版本 LogListener 目录下。cp -r /tmp/loglistener-backup/data ./
1.6 使用 启动命令 启动运行新版本 LogListener。
不复用断点文件（可能会重复采集日志）：
1.1 使用 停止命令 停止运行旧版本的 LogListener。
1.2 使用 卸载命令 卸载旧版本的 LogListener。
1.4 使用 启动命令 启动运行新版本 LogListener。
升级指南
文档反馈