作者:手机用户2502891053 | 来源:互联网 | 2023-08-06 13:35
因为TDengine开源的关系,很多小伙伴已经养成了「有事找警察、有理想找Jeff Tao、有问题找GitHub」,截至目前,我们在GitHub上已经有了1800多个Issue,这些Issue的种类也是五花八门。有的是使用过程中遇到的Bug,有的是咨询一些不太理解的问题,有的是对新功能的建议……众人拾柴火焰高,TDengine到现在已经发布了27个开源版本,这些版本的更新、优化离不开每一个热爱开源、不断体验TDengine的小伙伴,你们都是TDengine“功劳簿”上的一份子!
但最近,我们总遇到这样的问题:我递交到GitHub上的问题,为什么还没有被解决?
一方面,确实是,对于递交Issue的小伙伴来说,你面临的是一个问题,但对于我们的技术支持团队来说,他们面临的是众多小伙伴的一个接着一个的问题,会有一个优先级的问题;另一方面,有时候并不是一两段描述,一个截图就能完整呈现你遇到的问题,这背后,需要我们团队的同学对问题进行复现,再去深挖出现问题的原因,解决起来却是需要一定的时间。
那么问题来了,技术支持团队一样,遇到的问题难度也差不多,为什么别人的问题很容易被解决呢?
我浏览了这1800多个Issue,得出个结论,这些很快得到响应并完美解决的问题,都是因为做到了这一点:他们附上了日志,并且尽量详细地描述了遇到的问题。
换句话说,你的Issue离优秀可能只差一个调试日志。
下面我们就来介绍这关键的一步,如何附上TDengine的调试日志。
TDengine分为客户端和服务器端,一般故障调试过程如下:
// 在Linux shell中停止taosd
sudo systemctl stop taosd
// 删除日志文件
sudo rm –rf /var/log/taos/*
// 在配置文件中添加一行debugFlag 135
sudo vim /etc/taos/taos.cfg
debugFlag 135
如果TDengine,已经crash,也就是通过taos不能正常连接,则需要再增加一行:
注:1)如果使用的是Windows客户端报错,也需要在Windows客户端的配置文件中,增加以上的内容,默认路径:C:\TDengine\cfg;2)crash会生成core文件,默认在Linux的根目录下。
2. 启动服务端程序、复现问题
// 在Linux shell中停止taosd
sudo systemctl start taosd
//启动应用程序复现问题
……
3. 发送日志
注:如果文档日志过大,可以截取其中一部分,参考命令如下:
grep ERROR taosdlog.0 -C 200 >> taosdlog.0.log
当然,尽可能完整地描述问题,附上调试日志,这些只是优秀Issue必备的要素之一,可以让专业的技术支持团队更快地去复现并解决你的问题。
但开源的乐趣,远不止如此,也许你也可以成为一盏照亮他人的指路灯,如果在GitHub上遇到了你能解决的问题,我们非常欢迎你来贡献答案,予人玫瑰,手有余香。
Together,we create!
点击「阅读原文」,体验TDengine!