625
日志服务客户端(logtail)异常检测工具
简介
当日志收集端不工作或工作异常时，用户可通过logtail检测工具查看客户端是否存在异常情况，根据工具提示快速定位并解决问题。
使用方法
下载检测工具脚本
wget https://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/checkingtool.sh
检测工具常用参数
-
--help查看帮助文档 -
--logFile [LogFileFullPath]检测logtail是否收集路径为LogFileFullPath的日志 -
无参数默认执行除
logFile和外的所有检查项，具体的检查项包括- 操作系统检查(
--system) - 安装文件完整性检查(
--installFiles) - logtail运行状态检查（
--status） - 阿里云userID检查(
--aliuid) - 动态机器组/自定义标识检查(
--userDefinedId) - 网络连通性检查(
--net)
- 操作系统检查(
检查步骤
- 直接运行脚本
sudo ./checkingtool.sh进行通用项检查
- 根据通用项检查提示解决相应的异常
- 若通用项检查全部通过而logtail还未收集到日志文件，使用
--logFile [LogFileFullPath]参数检查logtail是否收集指定路径的日志
- 若指定日志文件检查通过，建议进入阿里云控制台中查看该日志服务配置项的异常日志，参见收集错误查询
常见异常以及解决方法
| 常见问题 | 解决方法 |
|---|---|
| 安装文件丢失 | 重装logtail |
| logtail未运行 | 使用命令/etc/init.d/ilogtaild start开启 |
| 多个logtail进程 | 使用命令/etc/init.d/ilogtaild stop关闭，再用命令/etc/init.d/ilogtaild start开启 |
| 443端口被禁用 | 防火墙打开443端口 |
| 无法找到配置服务器 | 确认安装正确性，若安装错误，卸载后重新安装 |
| 不存在用户配置 | 确认控制台已经创建好logtail配置、机器组中包含该客户端且已经将配置应用到机器组 |
| 没有匹配指定日志文件 | 确认logtail配置正确性 |
| 指定日志文件匹配多次 | 多个匹配时logtail随机选择一个配置，建议去重 |
注意事项
- 检查工具运行时会输出客户端配置的**阿里云id**和**动态机器组/自定义标识**，不存在时并不会给出告警，如果客户端需要阿里云id或动态机器组/自定义标识的配置，请查看工具的输出和您配置的是否一致，不一致时按照以下方法重新配置：阿里云UserId配置、动态机器组配置
- 检查工具需要使用curl进行网络连通性检查，请确保机器安装curl工具
最后更新：2017-04-13 20:02:31