机器组常见问题
Download
聚焦模式
字号
机器组添加机器不生效
通过 IP 添加机器不生效
1. 检查 IP 对应机器是否已安装 LogListener，安装指引请参见 LogListener 安装和部署。
2. 参考 如何使用采集自检工具，检查 LogListener 是否存在异常。
3. 检查机器组中添加的 IP 是否与 LogListener 识别到的 IP 一致。您可通过执行以下代码查看 LogListener 检测到的 IP。
/etc/init.d/loglistenerd check
在返回数据中，通过查看
group ip，可确认 LogListener 识别到的 IP，如下图：以安装路径
C:\\Program Files (x86)\\Tencent\\LogListener 为例，以管理员身份运行 Windows PowerShell，在安装路径下，执行以下命令检查 LogListener 心跳及配置：.\\loglistener_work.exe check
在返回数据中， 通过查看
group_id，可确认 LogListener 识别到的 IP，如下图：通过机器标识添加机器不生效
1. 检查目标机器是否已安装 LogListener，安装指引请参考 LogListener 安装和部署。
2. 参考 如何使用采集自检工具，检查LogListener是否存在异常。
3. 检查 LogListener 的机器标识是否与机器组中配置的机器标识一致。您可参考以下步骤查看 LogListener 的机器标识。
以安装路径
/usr/local/ 为例， 您可在 /usr/local/loglistener/etc 路径下，运行以下命令查看并配置 LogListener 配置文件。vim loglistener.conf
其中 group_label 则为 LogListener 的机器标识，请确保该标识与机器组中配置的一致。
以安装路径
C:\\Program Files (x86)\\Tencent\\LogListener 为例，在安装目录下找到 LogListener 配置文件 loglistener.yaml，并用任意编辑器打开，如下图：
其中 agent_label 则为 LogListener 的机器标识，请确保该标识与机器组中配置的一致。
机器组机器状态异常问题
完成机器组配置后，在机器组管理页中，点击机器组名称可以查看与该机器组关联的机器心跳。状态正常说明机器心跳正常上报，若不为正常（如下图）， 则说明该机器上的 LogListener 存在异常。
心跳异常
当状态为心跳异常时， 说明 LogListener 与日志服务后端连接中断，会导致 LogListener 无法正常上传日志。您可通过以下方式进一步排查连接中断的原因：
说明
1. 使用 LogListener 快速诊断工具
LogListener 快速诊断工具可以快速诊断 LogListener 是否启动、心跳是否正常、配置拉取是否正常。
在命令行下执行如下指令：
/etc/init.d/loglistenerd check
若 LogListener 运行正常，诊断工具返回的结果如图所示：
LogListener 进程异常
如果出现如下图所示 “[ERROR] loglistener is not running” 字样，表示 LogListener 没有启动。 执行
/etc/init.d/loglistenerd start 启动，更多操作指令参见 LogListener 常用操作指令。
LogListener 心跳异常
如果出现如下图所示 “[ERROR] check loglistener heareat fail” 字样，表示 LogListener 心跳异常。
引起 LogListener 心跳异常的原因有很多，最常见的情况有：
网络异常。执行以下命令检查网络环境是否连通，命令中的 “cls domain name” 为 CLS 服务域名，请参见 可用地域 文档填写。
telnet <cls domain name> 80
密钥信息错误。进入 LogListener 安装目录执行
./bin/check，末尾输出内容如下表示密钥信息错误。
密钥缺少权限。进入 LogListener 安装目录执行
./bin/check，末尾输出内容如下表示密钥缺少权限，需要按照 策略模板 配置上报权限。
2. 检查机器组 IP 配置
检查机器组所添加的 IP 地址是否为 LogListener 安装过程中获取的 IP 地址。进入到 LogListener 安装目录执行如下命令检查 LogListener 配置的 IP 地址。
说明：
若无特殊指定，LogListener 安装目录通常为
/usr/local/loglistener。grep group_ip etc/loglistener.conf
目录超限
当状态为目录超限时，说明 LogListener 监听的采集目录数量已超过规格限制5000，会导致 LogListener 部分超出部分的目录的日志无法被采集。您可通过以下方式进行修复：
1. 执行以下命令查看当前 LogListener 关联的采集配置。
/etc/init.d/loglistenerd check
2. 以上返回结果中，logconfig 数组包含了当前 LogListener 的所有采集配置，您可针对每个采集配置，检查 wildpath 是否可能模糊命中大量无需采集的目录，例如
/root/**/error.log这类根目录的模糊路径。3. 找到目标可优化的采集配置后， 从步骤1的返回数据中查看该采集配置关联的 topicid，并基于该 topicid 前往 CLS 控制台找到目标日志主题，优化或删除该采集配置。
文件超限
当状态为文件超限时，说明 LogListener 监听的采集文件数量已超过规格限制10000，会导致 LogListener 无法采集超出该限制的文件的日志。您可通过以下方式进行修复：
1. 执行以下命令查看当前 LogListener 关联的采集配置。
/etc/init.d/loglistenerd check
2. 以上返回结果中，logconfig 数组包含了当前 LogListener 的所有采集配置，您可针对每个采集配置，检查 wildpath 是否可能模糊命中大量无需采集的文件，例如
/root/**/*.log这类从根目录模糊匹配任意名称的日志文件。3. 找到目标可优化的采集配置后，从步骤1的返回数据中查看该采集配置关联的 topicid，并基于该 topicid 前往 CLS 控制台找到目标日志主题，优化或删除该采集配置。
CPU 超限
当状态为 CPU 超限时，说明 LogListener 所占用 CPU 已超过预先设置的阈值。您可通过以下方式进行排查与修复：
优化目标采集目录
1. 执行以下命令查看当前 LogListener 关联的采集配置。
/etc/init.d/loglistenerd check
2. 以上返回结果中，logconfig 数组包含了当前 LogListener 的所有采集配置，您可针对每个采集配置，检查 wildpath 是否可能模糊命中大量无需采集的文件，例如
/root/**/*.log这类从根目录模糊匹配任意名称的日志文件。3. 找到目标可优化的采集配置后，从步骤1的返回数据中查看该采集配置关联的 topicid，并基于该 topicid 前往 CLS 控制台找到目标日志主题，优化或删除该采集配置。
优化正则表达式
1. 执行以下命令查看当前 LogListener 关联的采集配置。
/etc/init.d/loglistenerd check
2. 以上返回结果中，logconfig 数组包含了当前 LogListener 的所有采集配置，您可针对每个带有 fullregex 或 multi_fullregex 字段的采集配置，检查正则是否过于复杂。
3. 找到目标可优化的采集配置后，从步骤1的返回数据中查看该采集配置关联的 topicid，并基于该 topicid 前往 CLS 控制台找到目标日志主题，优化或删除该采集配置。
提升 LogListener CPU 占用的限制
1. 以 LogListener 安装目录为
/usr/local/loglistener为例，执行以下命令打开 LogListener 配置文件：vim etc/loglistener.conf
2. 在 LogListener 配置文件中， 找到
cpu_usage_thres并按需提升 CPU 利用率限制， 如下图：
3. 完成配置后，保存并 重启 LogListener。
提升 CPU 资源配额
K8s 场景下，请确保
DaemonSet:tke-log-agent 下 Pod: loglistener 的 CPU 配额充足。内存超限
当状态为内存超限时，说明 LogListener 所占用内存已超过预先设置的阈值。您可通过以下方式进行修复。
1. 以 LogListener 安装目录为
/usr/local/loglistener为例，执行以下命令打开 LogListener 配置文件。vim etc/loglistener.conf
2. 在 LogListener 配置文件中，找到
max_mem 并按需提升内存占用限制，如下图：
3. 完成配置后，保存并 重启 LogListener。
鉴权失败
确认密钥有效
当状态为鉴权失败时，说明 LogListener 中配置的密钥错误或已失效。您可通过以下方式进行修复。
1. 以 LogListener 安装目录为
/usr/local/loglistener为例，执行以下命令打开 LogListener 配置文件。vim etc/loglistener.conf
2. 在 LogListener 配置文件中，找到
secret_id 和 secret_key 并判断是否正确有效，若无效则修改为正确的密钥信息，如下图：
3. 完成配置后，保存并 重启 LogListener。
服务器时间正确
请确保服务器时间准确，否则可能导致鉴权失败。
文档反馈