动态与公告

产品动态

公告

新手指引

产品简介

产品概述

产品优势

地域和访问域名

规格与限制

基本概念

购买指南

计费概述

产品定价

按量计费（后付费）

欠费说明

清理日志服务资源

成本优化

常见问题

快速入门

一分钟入门指南

入门指南

使用 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 配置指南

PDF

聚焦模式

字号

最后更新时间： 2026-03-05 16:03:21

Linux
Windows
以安装路径/usr/local/为例， 您可在/usr/local/loglistener/etc路径下，运行以下命令查看并配置 LogListener 配置文件。
vim loglistener.conf
参数说明
参数名
参数描述
默认值
取值范围
proxy_host
目标 CLS 服务访问域名。
若 LogListener 初始化时指定了地域(-region)以及内外网访问方式(-network)，此处默认为指定地域对应的 CLS 内网或外网域名。 
若 LogListener 初始化未指定地域(-region)而指定了域名(-domain)，此处默认为域名。
请参见 可用地域 配置。
secret_id
API 密钥 ID。
LogListener 初始化时指定的密钥 ID。
请前往 API 密钥管理 获取密钥 ID。
secret_key
API 密钥 Key。 
LogListener 初始化时指定的密钥 ID。
请前往 API 密钥管理 获取密钥 Key。
encryption
访问 CLS 服务并鉴权时，是否需要对 secret_id 与 secret_key 进行解密。若要修改密钥的存储方式请参见 密钥加密存储。
LogListener 初始化时若指定encryption（是否加密存储密钥信息）为 true，此处则为 true；反之为 false。
true, false
group_ip
IP 标识，机器组可通过所配 IP 标识与该机器关联，详情可参见 机器组。
默认自动获取网卡IP，若 LogListener 初始化时指定了 IP，则为初始化时指定 IP。
-
group_label
机器标识。 配置后，机器组可通过所配机器标识与该机器关联，详情可参见 机器组。支持配置多个，由逗号分隔。
注意：
配置了机器标识的机器，仅可通过机器标识关联机器组，不可通过 IP 关联。
-
-
max_connection
同一时刻，最大的日志上传请求并行数量。
10
大于0的整数
max_mem
最大内存占用（Bytes）。
2097152000
大于0的整数
max_dir
最大监听目录数。
说明：
该配置仅在 LogListener v2.8.8及以上版本支持。
5000
大于0的整数
max_file
最大监听文件数。
15000
大于0的整数
cpu_usage_thres
单核最大 CPU 占用（%）。0代表无限制。
0
0-100
max_send_rate
最大上传速率（Bytes/s）。0代表无限制。
0
大于0的整数
max_depth
最大采集目录深度。当采集路径中包含这种 wildcard 时， 该配置可控制针对的下探深度。0代表不下探。
10
大于0的整数
request_compression
是否压缩上传日志。
true
true、false
replace_special_characters
当采集的日志中出现时出现特殊字符， 是否以空格替换。
说明：
该配置仅在 LogListener v2.8.8及以上版本支持。
false
true、false
memory_tight_mode
是否开启内存节省模式。
false
true、false
max_send_retrys
日志上传请求失败时，最大重试次数。0代表不断尝试。
0
大于0的整数
max_send_retry_time
日志上传请求失败并重试时，最大超时时间（s）。
10800
大于0的整数
send_retry_period
日志上传请求失败时，最大重试时间间隔（s）。
3
大于0的整数
完成配置修改后， 需执行以下命令重启 LogListener，使配置变更生效：
通过 systemd 执行
不通过 systemd 执行
适用于 Loglistener 2.8.3以上并且操作系统具有 systemd。
systemctl restart loglistenerd
执行 /etc/init.d/loglistenerd check 查看是否重启成功：
﻿
﻿
﻿
适用于 LogListener 2.8.3以下或者 LogListener 2.8.3以上但是操作系统没有 systemd。
/etc/init.d/loglistenerd restart
执行 /etc/init.d/loglistenerd check 查看是否重启成功：
﻿
﻿
﻿
以安装路径C:\\Program Files (x86)\\Tencent\\LogListener为例，在安装目录下找到 loglistener.yaml 并用任意编辑器打开：
﻿
﻿
﻿
参数说明
参数名
参数描述
默认值
取值范围
host
目标 CLS 服务访问域名。
若 LogListener 初始化时指定了地域(--region)以及内外网访问方式(--network)，此处默认为指定地域对应的 CLS 内网或外网域名。
 若 LogListener 初始化未指定地域(--region)，而指定了域名(--endpoint)，此处默认为域名。
请参见 可用地域 配置。
agent_ip
IP 标识，机器组可通过所配 IP 标识与该机器关联，详情可参见 机器组。
默认自动获取网卡 IP，若 LogListener 初始化时指定了 IP，则为初始化时指定 IP。
-
secret_id
API 密钥 ID。
LogListener 初始化时指定的密钥 ID。
请参见 API 密钥管理 获取密钥 ID。
secret_key
API 密钥 Key。 
LogListener 初始化时指定的密钥 ID。
请参见 API 密钥管理 获取密钥 Key。
agent_labels
机器标识。配置后，机器组可通过所配机器标识与该机器关联，详情可参见 机器组。支持配置多个，并用逗号分隔。
注意：
配置了机器标识的机器， 仅可通过机器标识关联机器组，不可通过 IP 关联。
-
-
完成配置修改后，需执行以下命令重启 LogListener，使配置变更生效。以管理员身份运行 Windows PowerShell，在安装路径C:\\Program Files (x86)\\Tencent\\LogListener下，执行以下命令重启 LogListener：
.\\loglistener_daemon.exe -action restart
﻿

帮助和支持

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

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

填写满意度调查问卷，共创更好文档体验。

文档反馈

参数名	参数描述	默认值	取值范围
proxy_host	目标 CLS 服务访问域名。	若 LogListener 初始化时指定了地域(-region)以及内外网访问方式(-network)，此处默认为指定地域对应的 CLS 内网或外网域名。若 LogListener 初始化未指定地域(-region)而指定了域名(-domain)，此处默认为域名。	请参见可用地域配置。
secret_id	API 密钥 ID。	LogListener 初始化时指定的密钥 ID。	请前往 API 密钥管理获取密钥 ID。
secret_key	API 密钥 Key。	LogListener 初始化时指定的密钥 ID。	请前往 API 密钥管理获取密钥 Key。
encryption	访问 CLS 服务并鉴权时，是否需要对 secret_id 与 secret_key 进行解密。若要修改密钥的存储方式请参见密钥加密存储。	LogListener 初始化时若指定encryption（是否加密存储密钥信息）为 true，此处则为 true；反之为 false。	true, false
group_ip	IP 标识，机器组可通过所配 IP 标识与该机器关联，详情可参见机器组。	默认自动获取网卡IP，若 LogListener 初始化时指定了 IP，则为初始化时指定 IP。	-
group_label	机器标识。配置后，机器组可通过所配机器标识与该机器关联，详情可参见机器组。支持配置多个，由逗号分隔。注意：配置了机器标识的机器，仅可通过机器标识关联机器组，不可通过 IP 关联。	-	-
max_connection	同一时刻，最大的日志上传请求并行数量。	10	大于0的整数
max_mem	最大内存占用（Bytes）。	2097152000	大于0的整数
max_dir	最大监听目录数。说明：该配置仅在 LogListener v2.8.8及以上版本支持。	5000	大于0的整数
max_file	最大监听文件数。	15000	大于0的整数
cpu_usage_thres	单核最大 CPU 占用（%）。0代表无限制。	0	0-100
max_send_rate	最大上传速率（Bytes/s）。0代表无限制。	0	大于0的整数
max_depth	最大采集目录深度。当采集路径中包含这种 wildcard 时，该配置可控制针对的下探深度。0代表不下探。	10	大于0的整数
request_compression	是否压缩上传日志。	true	true、false
replace_special_characters	当采集的日志中出现时出现特殊字符，是否以空格替换。说明：该配置仅在 LogListener v2.8.8及以上版本支持。	false	true、false
memory_tight_mode	是否开启内存节省模式。	false	true、false
max_send_retrys	日志上传请求失败时，最大重试次数。0代表不断尝试。	0	大于0的整数
max_send_retry_time	日志上传请求失败并重试时，最大超时时间（s）。	10800	大于0的整数
send_retry_period	日志上传请求失败时，最大重试时间间隔（s）。	3	大于0的整数

tencent cloud

日志服务

LogListener 配置指南

帮助和支持