报告缺陷

如果 etcd 项目任何部分存在缺陷或文档错误，请通过 打开问题 告知我们。我们高度重视缺陷和错误，认为任何问题都不算太小。创建缺陷报告前，请确认尚未存在报告相同问题的议题。

为了使错误报告准确且易于理解，请尽量编写如下格式的错误报告：

• 具体。尽可能提供详细信息：包括版本号、运行环境、配置信息等。若该问题与运行 etcd 服务器相关，请附上 etcd 日志（包含 etcd 配置的启动日志尤为重要）。

• 可复现。请提供复现问题的完整步骤。我们理解某些问题可能难以复现，请尽可能提供可能导致问题的步骤。如有可能，请在缺陷报告中附上受影响的 etcd 数据目录和堆栈跟踪信息。

• 独立。请尽量在依赖最少的情况下复现问题。若报告中涉及过多依赖，将显著降低问题修复速度。排查依赖 etcd 的外部系统不在支持范围内，但我们可以提供正确的指导方向，或协助使用 etcd 本身。

• 唯一。请勿重复提交现有错误报告。

• 作用域明确。每个报告仅针对一个缺陷。请勿在单个报告中跟进其他缺陷。

在创建错误报告前，阅读 Elika Etemad 关于撰写优质错误报告的文章 可能会有所帮助。

我们可能需要进一步信息以定位问题。重复的错误报告将被关闭。

常见问题解答

如何获取堆栈跟踪

$ kill -QUIT $PID

如何获取 etcd 版本

$ etcd --version

如何获取以 etcd2.service 运行的 systemd 服务的 etcd 配置和日志

$ sudo systemctl cat etcd2
$ sudo journalctl -u etcd2

由于上游 systemd 的一个缺陷，当 journald 的进程退出时，可能会丢失最后几行日志。如果 journalctl 显示 etcd 停止但未出现致命错误或 panic 消息，请尝试 sudo journalctl -f -t etcd2 以获取完整日志。