简介
当日志收集端不工作或工作异常时，用户可通过logtail检测工具查看客户端是否存在异常情况，根据工具提示快速定位并解决问题。
使用方法
下载检测工具脚本
wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/checkingtool.sh
wget http://logtail-corp.oss-cn-hangzhou-zmf.aliyuncs.com/linux64/checkingtool.sh
检测工具常用参数
-
--help查看帮助文档 -
--logFile [LogFileFullPath]检测logtail是否收
集路径为LogFileFullPath的日志，同时检查基本的logtail运行环境(安装文件完整性、运行状态、阿里云userID、网络连通性等) -
--logFileOnly [LogFileFullPath]只检测logtail是否收集路径为LogFileFullPath的日志 -
--envOnly只检测logtail运行环境
检测示例
- 直接运行脚本
./checkingtool.sh --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工具
