动态与公告

产品动态

公告

新手指引

产品简介

产品概述

产品优势

地域和访问域名

规格与限制

基本概念

购买指南

计费概述

产品定价

按量计费（后付费）

欠费说明

清理日志服务资源

成本优化

常见问题

快速入门

一分钟入门指南

入门指南

使用 Demo 日志快速体验 CLS

操作指南

资源管理

权限管理

日志采集

指标采集

日志存储

指标存储

检索分析（日志主题）

检索分析（指标主题）

仪表盘

数据处理

投递与消费

监控告警

云产品中心

DataSight 独立控制台

历史文档

实践教程

日志采集

检索分析

仪表盘

监控告警

投递和消费

成本优化

开发者指南

通过 iframe 内嵌 CLS（旧方案）

通过 Grafana 使用 CLS

API 文档

History

Introduction

API Category

Making API Requests

Topic Management APIs

Log Set Management APIs

Index APIs

Topic Partition APIs

Machine Group APIs

Collection Configuration APIs

Log APIs

Metric APIs

Alarm Policy APIs

Data Processing APIs

Kafka Protocol Consumption APIs

CKafka Shipping Task APIs

Kafka Data Subscription APIs

COS Shipping Task APIs

SCF Delivery Task APIs

Scheduled SQL Analysis APIs

COS Data Import Task APIs

Data Types

Error Codes

常见问题

健康监测问题解释

采集相关

检索分析相关

其他问题

服务等级协议

CLS 政策

隐私协议

数据处理和安全协议

联系我们

词汇表

LogListener 安装指南（Linux 版）

PDF

聚焦模式

字号

最后更新时间： 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

日志服务

LogListener 安装指南（Linux 版）

安装环境

支持功能

安装启动

1. 下载安装 LogListener

2. 初始化 LogListener

参数说明

3. 启动 LogListener

LogListener 常用操作

查看 LogListener 版本

查看 LogListener 帮助文档

LogListener 进程管理

查看 LogListener 进程状态

检查 LogListener 心跳及配置

卸载 LogListener

手动更新 LogListener

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

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

帮助和支持