报告缺陷

如果 etcd 项目的任何部分存在错误或文档问题，请通过提交问题告知我们。我们非常认真地对待所有错误和文档问题，并认为没有哪个问题是太小的。在创建错误报告之前，请先检查是否已存在报告相同问题的议题。

为了使错误报告准确且易于理解，请尽量做到以下几点来创建错误报告：

• 具体。包含尽可能多的细节：具体版本、运行环境、配置信息等。如果错误与运行 etcd 服务器有关，请附上 etcd 的日志（尤其是包含 etcd 配置的启动日志尤为重要）。

• 可复现。请提供复现问题的步骤。我们理解某些问题可能难以复现，但仍请提供可能导致该问题的操作步骤。如果可能，请在错误报告中附上受影响的 etcd 数据目录和堆栈跟踪信息。

• 隔离性。请尝试在最少依赖的情况下隔离并复现该错误。如果错误报告涉及过多依赖项，将显著降低修复速度。调试依赖于 etcd 的外部系统不在支持范围内，但我们很乐意提供正确的指导方向或帮助使用 etcd 本身。

• 唯一性。不要重复提交已有的错误报告。

• 范围明确。每个报告只包含一个错误。请勿在一个报告中追加其他错误。

在创建错误报告前，建议阅读Elika Etemad 关于如何提交优质错误报告的文章。

我们可能会要求您提供更多信息以定位错误。重复的错误报告将被关闭。

常见问题解答

如何获取堆栈跟踪

$ kill -QUIT $PID

如何获取 etcd 版本

$ etcd --version

当 etcd 以 systemd 服务 'etcd2.service' 运行时，如何获取其配置和日志

$ sudo systemctl cat etcd2
$ sudo journalctl -u etcd2

由于上游 systemd 存在一个 bug，journald 在其进程退出时可能会丢失最后几行日志。如果 journalctl 显示 etcd 停止但没有致命错误或 panic 消息，请尝试使用 sudo journalctl -f -t etcd2 获取完整日志。