别人的Issue很快就能关闭，而我的问题却迟迟没有被解决

Posted 2022-03-18 TDengine

​​​​

因为TDengine开源的关系，很多小伙伴已经养成了「有事找警察、有理想找Jeff Tao、有问题找GitHub」，截至目前，我们在GitHub上已经有了1800多个Issue，这些Issue的种类也是五花八门。有的是使用过程中遇到的Bug，有的是咨询一些不太理解的问题，有的是对新功能的建议……众人拾柴火焰高，TDengine到现在已经发布了27个开源版本，这些版本的更新、优化离不开每一个热爱开源、不断体验TDengine的小伙伴，你们都是TDengine“功劳簿”上的一份子！

但最近，我们总遇到这样的问题：我递交到GitHub上的问题，为什么还没有被解决？

一方面，确实是，对于递交Issue的小伙伴来说，你面临的是一个问题，但对于我们的技术支持团队来说，他们面临的是众多小伙伴的一个接着一个的问题，会有一个优先级的问题；另一方面，有时候并不是一两段描述，一个截图就能完整呈现你遇到的问题，这背后，需要我们团队的同学对问题进行复现，再去深挖出现问题的原因，解决起来却是需要一定的时间。

那么问题来了，技术支持团队一样，遇到的问题难度也差不多，为什么别人的问题很容易被解决呢？

我浏览了这1800多个Issue，得出个结论，这些很快得到响应并完美解决的问题，都是因为做到了这一点：他们附上了日志，并且尽量详细地描述了遇到的问题。

换句话说，你的Issue离优秀可能只差一个调试日志。

下面我们就来介绍这关键的一步，如何附上TDengine的调试日志。

TDengine分为客户端和服务器端，一般故障调试过程如下：

​1. 关闭服务端程序、清空日志​

// 在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不能正常连接，则需要再增加一行：

enableCoreFile 1

注：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！

---