日志服务客户端(logtail)异常检测工具

简介

当日志收集端不工作或工作异常时，用户可通过logtail检测工具查看客户端是否存在异常情况，根据工具提示快速定位并解决问题。

• 目前该文档已上线，更多帮助请参考官方文档FAQ。

使用方法

下载检测工具脚本

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工具