机器组常见问题
下载
聚焦模式
字号
通过 IP 添加机器不生效
1. 检查 IP 对应机器是否已安装 LogListener，安装指引请参见 LogListener 安装和部署。
2. 参考 如何使用采集自检工具，检查 LogListener 是否存在异常。
3. 检查机器组中添加的 IP 是否与 LogListener 识别到的 IP 一致。您可通过执行以下代码查看 LogListener 检测到的 IP。
LogListener 版本≥3.4.0：
//查看心跳及配置systemctl check loglistener
//核对机器 IPcd /opt/loglistener/ && grep -n 'agent_ip' conf/loglistener.yaml
LogListener 版本<3.4.0：
/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 的机器标识。
LogListener 版本≥3.4.0：以安装路径 /opt/loglistener 为例， 您可在 /opt/loglistener/conf 路径下，运行以下命令查看并配置 LogListener 配置文件。
grep -n 'agent_labels' loglistener.yaml
无输出时，表示当前机器未配置机器标识，如下图：
其中 agent_labels 则为 LogListener 的机器标识，请确保该标识与机器组中配置的一致。
LogListener 版本<3.4.0：以安装路径
/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 是否启动、心跳是否正常、配置拉取是否正常。在命令行下执行如下指令：
LogListener 版本≥3.4.0：
systemctl check loglistener
LogListener 版本<3.4.0：
/etc/init.d/loglistenerd check
如果 LogListener 运行正常，诊断工具返回的结果如图所示：
LogListener 进程异常：如果出现如下图所示
[ERROR] loglistener is not running 字样，表示 LogListener 没有启动。执行 systemctl start loglistener 启动，更多操作指令参见 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 地址。
1. 进入到 LogListener 安装目录执行如下命令检查 LogListener 配置的 IP 地址。
说明：
若无特殊指定，LogListener 安装目录通常为
/opt/loglistener。grep agent_ip conf/loglistener.yaml
说明：
若无特殊指定，LogListener 安装目录通常为
/usr/local/loglistener。grep group_ip etc/loglistener.conf
2. 登录 日志服务控制台，单击机器组管理，查看机器组配置的 IP 地址，机器组所配置的 IP 地址必须与 LogListener 获取的 IP 地址完全一致。
目录超限
当状态为目录超限时，会导致 LogListener 超出部分的目录的日志无法被采集。您可通过以下方式进行修复：
1. 执行以下命令查看当前 LogListener 关联的采集配置。
//LogListener 版本≥3.4.0systemctl check loglistener//LogListener 版本<3.4.0/etc/init.d/loglistenerd check
2. 以上返回结果中，logconfig 数组包含了当前 LogListener 的所有采集配置，您可针对每个采集配置，检查 wildpath 是否可能模糊命中大量无需采集的目录，例如
/root/**/error.log 这类根目录的模糊路径。3. 找到目标可优化的采集配置后， 从步骤1的返回数据中查看该采集配置关联的 topicid，并基于该 topicid 前往 CLS 控制台找到目标日志主题，优化或删除该采集配置。
文件超限
当状态为文件超限时，说明 LogListener 监听的采集文件数量已超过规格限制10000，会导致 LogListener 无法采集超出该限制的文件的日志。您可通过以下方式进行修复：
1. 执行以下命令查看当前 LogListener 关联的采集配置。
//LogListener 版本≥3.4.0systemctl check loglistener//LogListener 版本<3.4.0/etc/init.d/loglistenerd check
2. 以上返回结果中，logconfig 数组包含了当前 LogListener 的所有采集配置，您可针对每个采集配置，检查 wildpath 是否可能模糊命中大量无需采集的文件，例如
/root/**/*.log 这类从根目录模糊匹配任意名称的日志文件。3. 找到目标可优化的采集配置后，从步骤1的返回数据中查看该采集配置关联的 topicid，并基于该 topicid 前往 CLS 控制台找到目标日志主题，优化或删除该采集配置。
CPU 超限
当状态为 CPU 超限时，说明 LogListener 所占用 CPU 已超过预先设置的阈值。您可通过以下方式进行排查与修复：
优化目标采集目录
1. 执行以下命令查看当前 LogListener 关联的采集配置。
//LogListener 版本≥3.4.0systemctl check loglistener//LogListener 版本<3.4.0/etc/init.d/loglistenerd check
2. 以上返回结果中，logconfig 数组包含了当前 LogListener 的所有采集配置，您可针对每个采集配置，检查 wildpath 是否可能模糊命中大量无需采集的文件，例如
/root/**/*.log 这类从根目录模糊匹配任意名称的日志文件。3. 找到目标可优化的采集配置后，从步骤1的返回数据中查看该采集配置关联的 topicid，并基于该 topicid 前往 CLS 控制台找到目标日志主题，优化或删除该采集配置。
优化正则表达式
1. 执行以下命令查看当前 LogListener 关联的采集配置。
//LogListener 版本≥3.4.0systemctl check loglistener//LogListener 版本<3.4.0/etc/init.d/loglistenerd check
2. 以上返回结果中，logconfig 数组包含了当前 LogListener 的所有采集配置，您可针对每个带有 fullregex 或 multi_fullregex 字段的采集配置，检查正则是否过于复杂。
3. 找到目标可优化的采集配置后，从步骤1的返回数据中查看该采集配置关联的 topicid，并基于该 topicid 前往 CLS 控制台找到目标日志主题，优化或删除该采集配置。
提升 LogListener CPU 占用的限制
1. 以 LogListener 安装目录为 opt/loglistener 为例，执行以下命令打开 LogListener 配置文件：
vim conf/loglistener.yaml
2. 在 LogListener 配置文件中， 找到 cpu_limit 并按需提升 CPU 利用率限制（建议在保障业务进程资源的前提下按500/1000逐步提升），如下图：
3. 完成配置后，保存并 重启 LogListener。
systemctl restart loglistener
1. 以 LogListener 安装目录为
/usr/local/loglistener 为例，执行以下命令打开 LogListener 配置文件：vim etc/loglistener.conf
2. 在 LogListener 配置文件中， 找到
cpu_usage_thres 并按需提升 CPU 利用率限制（建议在保障业务进程资源的前提下按500/1000逐步提升）， 如下图：
3. 完成配置后，保存并 重启 LogListener。
systemctl restart loglistenerd
提升 CPU 资源配额
K8s 场景下，请确保
DaemonSet:tke-log-agent 下 Pod: loglistener 的 CPU 配额充足。内存超限
当状态为内存超限时，说明 LogListener 所占用内存已超过预先设置的阈值。您可通过以下方式进行修复。
1. LogListener 安装目录为 opt/loglistener 为例，执行以下命令打开 LogListener 配置文件。
vim conf/loglistener.yaml
2. 在 LogListener 配置文件中，找到
max_mem （单位：Bytes）并按需提升内存占用限制，如下图：说明：
建议在保障业务进程内存资源充足、不影响业务稳定性的前提下，再按当前值的1 - 2倍逐步提升。
3. 完成配置后，保存并 重启 LogListener。
systemctl restart loglistener
1. 以 LogListener 安装目录为
/usr/local/loglistener 为例，执行以下命令打开 LogListener 配置文件。vim etc/loglistener.conf
2. 在 LogListener 配置文件中，找到
max_mem （单位：Bytes）并按需提升内存占用限制，如下图：说明：
建议在保障业务进程内存资源充足、不影响业务稳定性的前提下，再按当前值的1 - 2倍逐步提升。
3. 完成配置后，保存并 重启 LogListener。
systemctl restart loglistenerd
鉴权失败
确认密钥有效
当状态为鉴权失败时，说明 LogListener 中配置的密钥错误或已失效。您可通过以下方式进行修复。
1. 以 LogListener 安装目录为
/usr/local/loglistener 为例，执行以下命令打开 LogListener 配置文件。vim etc/loglistener.conf
2. 在 LogListener 配置文件中，找到
secret_id 和 secret_key 并判断是否正确有效，若无效则修改为正确的密钥信息，如下图：
3. 完成配置后，保存并 重启 LogListener。
systemctl restart loglistenerd
服务器时间正确
请确保服务器时间准确，否则可能导致鉴权失败。
1. Linux 服务器可参考以下方式检查：
datetimedatectl status
重点确认以下信息：
Local time：当前本地时间是否正确。
Time zone：时区是否符合服务器所在地域，例如中国大陆地域通常为 Asia/Shanghai。
System clock synchronized：是否为 yes。
NTP service：是否为 active。
2. 如时区不正确，可执行以下命令修改时区（以中国大陆地域为例）：
sudo timedatectl set-timezone Asia/Shanghai
文档反馈