LogListener 配置指南

最近更新时间: 2026-03-13 09:03:00

Linux

以安装路径/usr/local/为例, 您可在/usr/local/loglistener/etc路径下,运行以下命令查看并配置 LogListener 配置文件。

vim loglistener.conf

参数说明

参数名 参数描述 默认值
proxy_host 目标 CLS 服务访问域名。 - 若 LogListener 初始化时指定了地域(-region)以及内外网访问方式(-network),此处默认为指定地域对应的 CLS 内网或外网域名。
- 若 LogListener 初始化未指定地域(-region)而指定了域名(-domain),此处默认为域名。
secret_id API 密钥 ID。
请前往 API 密钥管理获取密钥 ID。
LogListener 初始化时指定的密钥 ID。
secret_key API 密钥 Key。
请前往 API 密钥管理获取密钥 Key。
LogListener 初始化时指定的密钥 Key。
encryption 访问 CLS 服务并鉴权时,是否需要对 secret_id 与 secret_key 进行解密。
取值范围:true、false
LogListener 初始化时若指定encryption(是否加密存储密钥信息)为 true,此处则为 true;反之为 false。
group_ip IP 标识,机器组可通过所配 IP 标识与该机器关联。 默认自动获取网卡IP,若 LogListener 初始化时指定了 IP,则为初始化时指定 IP。
group_label 机器标识。 配置后,机器组可通过所配机器标识与该机器关联。 支持配置多个,由逗号分隔。
注意:
配置了机器标识的机器, 仅可通过机器标识关联机器组,不可通过 IP 关联。

-
max_connection 同一时刻,最大的日志上传请求并行数量。
大于0的整数
20
max_mem 最大内存占用(Bytes)。
大于0的整数
2097152000
max_dir 最大监听目录数。
大于0的整数
5000
max_file 最大监听文件数。
大于0的整数
15000
cpu_usage_thres 单核最大 CPU 占用(%)。0代表无限制。
取值范围:0-100
0
max_send_rate 最大上传速率(Bytes/s)。0代表无限制。
大于0的整数
0
max_depth 最大采集目录深度。当采集路径中包含这种 wildcard 时, 该配置可控制针对的下探深度。0代表不下探。
大于0的整数
10
request_compression 是否压缩上传日志。
取值范围:true、false
true
replace_special_characters 当采集的日志中出现时出现特殊字符, 是否以空格替换。
取值范围:true、false
false
memory_tight_mode 是否开启内存节省模式。
取值范围:true、false
false
multi_process 是否开启多线程模式。该配置仅在 LogListener v3.0.0及以上版本支持。
取值范围:true、false
false
polling_mode 是否开启 Polling 模式。该配置仅在 LogListener v3.0.0及以上版本支持。
取值范围:true、false
true
max_send_retrys 日志上传请求失败时,最大重试次数。0代表不断尝试。
大于0的整数
0
max_send_retry_time 日志上传请求失败并重试时,最大超时时间(s)。
大于0的整数
10800
send_retry_period 日志上传请求失败时,最大重试时间间隔(s)。
大于0的整数
3

完成配置修改后, 需执行以下命令重启 LogListener,使配置变更生效:

  • 通过systemd执行
    适用于 Loglistener 2.8.3以上并且操作系统具有 systemd。
systemctl start loglistenerd
  • 不通过systemd执行
    适用于 LogListener 2.8.3以下或者 LogListener 2.8.3以上但是操作系统没有 systemd。
/etc/init.d/loglistenerd stop