LogListener 安装指南（Linux 版）

最后更新时间：2025-11-19 20:33:53

LogListener 安装指南（Linux 版）

最后更新时间： 2025-11-19 20:33:53

LogListener 是腾讯云日志服务（Cloud Log Service，CLS）所提供的专用日志采集器，将它安装部署到服务器上，可快速采集日志到日志服务。
安装环境
LogListener 仅支持64位 Linux 操作系统环境（暂不支持 Windows），并适配主流 Linux 操作系统版本，其他版本环境若安装异常，请 提交工单 联系我们。
LogListener 版本
处理器架构
操作系统类别
确定可安装环境
v2.x.x
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 版本支持重要功能如下，详细版本功能信息请参考 LogListener 版本变更。
安装启动
1. 下载安装 LogListener
LogListener 最新版本下载地址：公网下载 LogListener、内网下载 LogListener
以安装路径/usr/local/为例： 下载 LogListener 安装包并解压，解压路径为/usr/local/ ，解压完成后进入 LogListener 目录/usr/local/loglistener/tools，执行安装命令 。
说明：
从2.8.3 版本开始，LogListener 安装包不再添加版本号后缀，使用 loglistener-linux-x64 默认安装最新版本。如果需要安装特定版本可以在后面指定版本号，如将 loglistener-linux-x64 替换为 loglistener-linux-x64-2.8.0，将会指定安装2.8.0版本。
公网环境下，操作命令如下：
wget http://mirrors.tencent.com/install/cls/loglistener-linux-x64.tar.gz && tar zxvf loglistener-linux-x64.tar.gz  -C /usr/local/ && cd /usr/local/loglistener/tools && ./loglistener.sh install
内网环境下，操作命令如下：
wget http://mirrors.tencentyun.com/install/cls/loglistener-linux-x64.tar.gz && tar zxvf loglistener-linux-x64.tar.gz  -C /usr/local/ && cd /usr/local/loglistener/tools && ./loglistener.sh install
2. 初始化 LogListener
以安装路径/usr/local/为例，在/usr/local/loglistener/tools路径下，以 root 权限执行 LogListener 初始化命令（默认使用内网方式访问服务），初始化命令如下：
./loglistener.sh init -secretid AKID******************************** -secretkey ******************************** -region ap-xxxxxx
说明：
初始化命令中 -secretid、-secretkey、-region、-network 为需要自主填写的参数，详细介绍请参见如下 参数说明。
若主账号已授权协作者日志服务的读写权限，建议使用协作者密钥。
-region 为您所使用的日志服务区域，而非您的业务机器所处的区域。当您所使用的日志服务区域与您的业务机器所处的区域不一致时，请额外配置参数-network 为 internet，即代表外网访问。
云服务器与日志集同地域的情况下，建议使用内网方式访问服务域名；云服务器与日志集在不同地域的情况下，建议使用外网方式访问服务域名。
关于日志采集权限详情，请参见 LogListener 日志采集权限。
参数说明
参数名
是否必填
类型描述
secretid
是
﻿云 API 密钥 的一部分，SecretId 用于标识 API 调用者身份。请确保云 API 密钥关联的账号具有相应的 LogListener 日志采集权限。
secretkey
是
﻿云 API 密钥 的一部分，SecretKey 是用于加密签名字符串和服务器端验证签名字符串的密钥。请确保云 API 密钥关联的账号具有相应的 LogListener 日志采集权限。
encryption
否
是否对云API密钥进行加密存储。 若要对密钥进行加密，则入参 true；若不需要对密钥进行加密，则入参 false。详情请参见 密钥加密存储。
network
否
表示 LogListener 通过哪种方式访问服务域名，取值：intra 内网访问（默认），internet 外网访问。
内网访问：适用于腾讯云服务器，且服务器所在地域与机器组一致。
外网访问：适用于非腾讯云服务器，或服务器所在地域与机器组不一致。
region
若配置了 domain，该参数无需配置，否则必填
region 表示日志服务所在的 地域，此处填写域名简称，例如 ap-beijing、ap-guangzhou 等。
注意：
当您所使用的日志服务区域与您的业务机器所处的区域不一致时，请配置参数 network 为 internet，即代表外网访问。
domain
若配置了 region，该参数无需配置，否则必填
表示日志服务所在地域的 域名。例如 ap-beijing.cls.tencentyun.com、ap-guangzhou.cls.tencentyun.com 等。
注意：
当您所使用的日志服务区域与您的业务机器所处的区域不一致时，请配置外网域名。例如 ap-beijing.cls.tencentcs.com。
ip
否
机器的 IP 地址，机器组可通过所配 IP 地址与该机器关联，详情请参见 机器组。若不填写，LogListener 会自动获取本机的 IP 地址。 
label
否
机器标识，填写后该机器将与同样带有所填机器标识的机器组关联，详情请参见 机器组。多个标识按逗号分隔。
注意：
若配置了机器标识， 该机器将只能通过机器标识与机器组关联， 无法通过 IP 进行关联；若不配置， 机器组只能通过 IP 关联该机器。
默认使用内网域名：
﻿
如果需要通过外网方式访问服务域名，需要显式设置网络参数internet，执行如下命令：
./loglistener.sh init -secretid AKID******************************** -secretkey ******************************** -region ap-xxxxxx -network internet
﻿
说明：
若主账号已授权协作者日志服务的读写权限，建议使用协作者密钥。
region 为您所使用的日志服务区域，而非您的业务机器所处的区域。
云服务器与日志集同地域的情况下，建议使用内网方式访问服务域名。云服务器与日志集在不同地域的情况下，建议使用外网方式访问服务域名。
关于日志采集权限详情，可参考 授权子账号对 CLS 某个日志主题具有日志采集权限 文档。
3. 启动 LogListener
LogListener 2.8.3以上并且操作系统具有systemd。
systemctl start loglistenerd
LogListener 2.8.3以下或者 LogListener 2.8.3以上但是操作系统没有 systemd。
/etc/init.d/loglistenerd start
﻿
﻿
﻿
LogListener 常用操作
说明：
本文档示例的操作命令说明仅适用于 LogListener-2.2.4 及以上版本，低版本操作命令请参见 低版本 LogListener 安装指南。
查看 LogListener 版本
/etc/init.d/loglistenerd -v
查看 LogListener 帮助文档
/etc/init.d/loglistenerd -h
LogListener 进程管理
LogListener 2.8.3以上并且操作系统具有 systemd。
systemctl (start|restart|stop)  loglistenerd # 启动、重启、停止
LogListener 2.8.3以下或者 LogListener 2.8.3以上但是操作系统没有 systemd。
/etc/init.d/loglistenerd (start|restart|stop) # 启动、重启、停止
查看 LogListener 进程状态
/etc/init.d/loglistenerd status
LogListener 正常情况会运行两个进程：
﻿
﻿
检查 LogListener 心跳及配置
/etc/init.d/loglistenerd check
﻿
﻿
﻿
卸载 LogListener
以安装路径/usr/local/为例，在/usr/local/loglistener/tools路径下，以管理员权限执行卸载命令：
./loglistener.sh uninstall
手动更新 LogListener
复用断点文件（不会重复采集日志）：
1. 使用停止命令停止运行旧版本的 LogListener。
2. 备份旧版本中的断点文件目录（loglistener/data）。例如：将旧版的断点文件备份至/tmp/loglistener-backup目录下。
cp -r loglistener-2.2.3/data /tmp/loglistener-backup/
﻿
3. 使用卸载命令卸载旧版本的 LogListener。
4. 下载最新版本的 LogListener，并使用相关命令安装和初始化新版本 LogListener。
5. 复制所备份的断点文件目录（步骤2）到新版本 LogListener 目录下。
cp -r /tmp/loglistener-backup/data loglistener-<version>/
 请根据实际情况替换 <version>，例如：
cp -r /tmp/loglistener-backup/data loglistener-2.8.2/
6. 使用启动命令启动运行新版本 LogListener。
不复用断点文件（可能会重复采集日志）：
1. 使用停止命令停止运行旧版本的 LogListener。
2. 使用卸载命令卸载旧版本的 LogListener。
3. 下载最新版本的 LogListener，并使用相关命令安装和初始化新版本 LogListener。
4. 使用启动命令启动运行新版本 LogListener。

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

是

否

文档反馈

LogListener 版本	处理器架构	操作系统类别	确定可安装环境
v2.x.x	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位

参数名	是否必填	类型描述
secretid	是	云 API 密钥的一部分，SecretId 用于标识 API 调用者身份。请确保云 API 密钥关联的账号具有相应的 LogListener 日志采集权限。
secretkey	是	云 API 密钥的一部分，SecretKey 是用于加密签名字符串和服务器端验证签名字符串的密钥。请确保云 API 密钥关联的账号具有相应的 LogListener 日志采集权限。
encryption	否	是否对云API密钥进行加密存储。若要对密钥进行加密，则入参 true；若不需要对密钥进行加密，则入参 false。详情请参见密钥加密存储。
network	否	表示 LogListener 通过哪种方式访问服务域名，取值：intra 内网访问（默认），internet 外网访问。内网访问：适用于腾讯云服务器，且服务器所在地域与机器组一致。外网访问：适用于非腾讯云服务器，或服务器所在地域与机器组不一致。
region	若配置了 domain，该参数无需配置，否则必填	region 表示日志服务所在的地域，此处填写域名简称，例如 ap-beijing、ap-guangzhou 等。注意：当您所使用的日志服务区域与您的业务机器所处的区域不一致时，请配置参数 network 为 internet，即代表外网访问。
domain	若配置了 region，该参数无需配置，否则必填	表示日志服务所在地域的域名。例如 ap-beijing.cls.tencentyun.com、ap-guangzhou.cls.tencentyun.com 等。注意：当您所使用的日志服务区域与您的业务机器所处的区域不一致时，请配置外网域名。例如 ap-beijing.cls.tencentcs.com。
ip	否	机器的 IP 地址，机器组可通过所配 IP 地址与该机器关联，详情请参见机器组。若不填写，LogListener 会自动获取本机的 IP 地址。
label	否	机器标识，填写后该机器将与同样带有所填机器标识的机器组关联，详情请参见机器组。多个标识按逗号分隔。注意：若配置了机器标识，该机器将只能通过机器标识与机器组关联，无法通过 IP 进行关联；若不配置，机器组只能通过 IP 关联该机器。

tencent cloud

安装环境

支持功能

安装启动

1. 下载安装 LogListener

2. 初始化 LogListener

参数说明

3. 启动 LogListener

LogListener 常用操作

查看 LogListener 版本

查看 LogListener 帮助文档

LogListener 进程管理

查看 LogListener 进程状态

检查 LogListener 心跳及配置

卸载 LogListener

手动更新 LogListener

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

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