LogListener 配置指南

最近更新时间：2023-11-08 19:59:31

我的收藏

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
同一时刻，最大的日志上传请求并行数量。
20
大于0的整数
max_mem
最大内存占用（Bytes）。
2097152000
大于0的整数
max_dir
最大监听目录数。
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
当采集的日志中出现时出现特殊字符， 是否以空格替换。
false
true、false
memory_tight_mode
是否开启内存节省模式。
false
true、false
multi_process
是否开启多线程模式。该配置仅在 LogListener v3.0.0及以上版本支持。LogListener v3.0.0及以上版本为白名单供应，需 提交申请 使用。
false
true、false
polling_mode
是否开启 Polling 模式。该配置仅在 LogListener v3.0.0及以上版本支持。LogListener v3.0.0及以上版本为白名单供应，需 提交申请 使用。
true
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 start loglistenerd
适用于 LogListener 2.8.3以下或者 LogListener 2.8.3以上但是操作系统没有 systemd。
/etc/init.d/loglistenerd stop
﻿
以安装路径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
﻿

上一篇: LogListener 升级指南下一篇: LogListener 服务日志

参数名	参数描述	默认值	取值范围
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	同一时刻，最大的日志上传请求并行数量。	20	大于0的整数
max_mem	最大内存占用（Bytes）。	2097152000	大于0的整数
max_dir	最大监听目录数。	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	当采集的日志中出现时出现特殊字符，是否以空格替换。	false	true、false
memory_tight_mode	是否开启内存节省模式。	false	true、false
multi_process	是否开启多线程模式。该配置仅在 LogListener v3.0.0及以上版本支持。LogListener v3.0.0及以上版本为白名单供应，需提交申请使用。	false	true、false
polling_mode	是否开启 Polling 模式。该配置仅在 LogListener v3.0.0及以上版本支持。LogListener v3.0.0及以上版本为白名单供应，需提交申请使用。	true	true、false
max_send_retrys	日志上传请求失败时，最大重试次数。0代表不断尝试。	0	大于0的整数
max_send_retry_time	日志上传请求失败并重试时，最大超时时间（s）。	10800	大于0的整数
send_retry_period	日志上传请求失败时，最大重试时间间隔（s）。	3	大于0的整数